预打包作业

了解如何设置和使用预打包的作业。

预打包作业是随时可用的工作流作业，可帮助你自动执行常见任务，例如构建、提交和测试应用。它们提供了一种标准化的方法来处理这些操作，而无需从头编写自定义作业配置。本指南介绍了可用的预打包作业以及如何在你的工作流中使用它们。

¥Pre-packaged jobs are ready-to-use workflow jobs that help you automate common tasks like building, submitting, and testing your app. They provide a standardized way to handle these operations without having to write custom job configurations from scratch. This guide covers the available pre-packaged jobs and how to use them in your workflows.

构建

¥Build

将你的项目构建成 Android 或 iOS 应用。

¥Build your project into an Android or iOS app.

可以自定义构建作业，以便你可以在构建过程中执行自定义命令。请参阅 定制构建 了解更多信息。

¥Build jobs can be customized so that you can execute custom commands during the build process. See Custom builds for more information.

先决条件

¥Prerequisites

要成功使用构建作业，你需要使用与预打包作业相同的平台和配置文件，通过 EAS CLI 完成构建。了解如何使用 创建你的第一个构建 开始使用。

¥To successfully use the build job, you'll need to complete a build with EAS CLI using the same platform and profile as the pre-packaged job. Learn how to create your first build to get started.

语法

¥Syntax

jobs:
  build_app:
    type: build
    params:
      platform: android | ios # required
      profile: string # optional, default: production

参数

¥Parameters

你可以将以下参数传递到 params 列表中：

¥You can pass the following parameters into the params list:

输出

¥Outputs

你可以在后续作业中引用以下输出：

¥You can reference the following outputs in subsequent jobs:

示例

¥Examples

以下是一些使用构建作业的实际示例：

¥Here are some practical examples of using the build job:

Deploy

Deploy your application using EAS Hosting.

Prerequisites

To deploy your application using EAS Hosting, you'll need to set up your project. See Get Started with EAS Hosting for more information.

Syntax

!!!IG5!!!

Parameters

You can pass the following parameters into the params list:

Examples

Here are some practical examples of using the deploy job:

Fingerprint

Calculates a fingerprint of your project.

Note: This job type only supports CNG (managed) workflows. If you commit your android or ios directories, the fingerprint job won't work.

Syntax

!!!IG9!!!

Parameters

You can pass the following parameters into the params list:

Outputs

You can reference the following outputs in subsequent jobs:

Examples

Here are some practical examples of using the fingerprint job:

Get Build

Retrieve an existing build from EAS that matches the provided parameters.

Syntax

!!!IG12!!!

Parameters

You can pass the following parameters into the params list:

Outputs

You can reference the following outputs in subsequent jobs:

Examples

Here are some practical examples of using the get-build job:

Submit

Submit an Android or iOS build to the app store using EAS Submit.

Prerequisites

Submission jobs require additional configuration to run within a CI/CD process. See our Apple App Store CI/CD submission guide and Google Play Store CI/CD submission guide for more information.

Syntax

!!!IG16!!!

Parameters

You can pass the following parameters into the params list:

Outputs

You can reference the following outputs in subsequent jobs:

Examples

Here are some practical examples of using the submit job:

Update

Publish an update using EAS Update.

Prerequisites

To publish update previews and to send over-the-air updates, you'll need to run npx eas-cli@latest update:configure, then create new builds. Learn more about configuring EAS Update.

Syntax

!!!IG19!!!

Parameters

You can pass the following parameters into the params list:

Outputs

You can reference the following outputs in subsequent jobs:

Examples

Here are some practical examples of using the update job:

Maestro

Run Maestro tests on a Android emulator or iOS Simulator build.

Maestro tests are experimental and may experience flakiness.

Syntax

!!!IG23!!!

Parameters

You can pass the following parameters into the params list:

Examples

Here are some practical examples of using the Maestro job:

Maestro Cloud

Run Maestro tests on Maestro Cloud.

This requires a Maestro Cloud account and Cloud Plan subscription. Go to Maestro docs to learn more.

Syntax

!!!IG28!!!

Parameters

You can pass the following parameters into the params list:

You need to either set maestro_api_key parameter or MAESTRO_CLOUD_API_KEY environment variable in the job environment. Go to "Settings" on Maestro Cloud to generate an API key and then to Environment variables to add it to your project.

Examples

Here are some practical examples of using the Maestro job:

Slack

Send a message to a Slack channel using a Slack webhook URL.

Syntax

!!!IG31!!!

Parameters

You can pass the following parameters into the params list:

Examples

Here are some practical examples of using the Slack job:

Require Approval

Require approval from a user before continuing with the workflow. A user can approve or reject which translates to success or failure of the job.

Syntax

!!!IG34!!!

Parameters

This job doesn't take any parameters.

Examples

Here are some practical examples of using the Require Approval job:

Doc

Displays a Markdown section in the workflow logs.

Syntax

!!!IG37!!!

Parameters

You can pass the following parameters into the params list:

Examples

Here are some practical examples of using the Doc job:

Repack

Repackages an app from an existing build. This job repackages the app's metadata and JavaScript bundle without performing a full native rebuild, which is useful for creating a faster build compatible with a specific fingerprint.

Syntax

!!!IG39!!!

Parameters

You can pass the following parameters into the params list:

Examples

Here are some practical examples of using the Fingerprint with Repack jobs: