开始使用 EAS Workflows

编辑页面

了解如何使用 EAS Workflows 自动化你的 React Native CI/CD 开发和发布流程。

本页面将引导你完成创建第一个 EAS Workflows 的过程，用于构建并提交你的应用到应用商店。

开始使用

Prerequisites

4 requirements

你需要先注册一个 Expo 账号。

创建项目

你需要使用以下命令创建一个项目：

Terminal

- npx create-expo-app@latest --template default@sdk-55

将项目与 EAS 同步

你需要使用以下命令将项目与 EAS 同步。这将创建一个 EAS 项目并将其关联到你的本地项目：

Terminal

- npx eas-cli@latest init

添加 eas.json

如果你的项目根目录中还没有 eas.json 文件，你需要添加一个：

Terminal

- touch eas.json && echo "{}" > eas.json

在项目根目录下创建一个名为 .eas/workflows 的目录，并在其中放入一个 YAML 文件。比如：.eas/workflows/create-production-builds.yml。

my-app

.eas

workflows

create-production-builds.yml

eas.json

将以下 YAML 添加到 create-production-builds.yml 文件中：

.eas/workflows/create-production-builds.yml

name: 创建生产构建

jobs:
  build_android:
    type: build # 此作业类型会为 Android 创建一个生产构建
    params:
      platform: android
  build_ios:
    type: build # 此作业类型会为 iOS 创建一个生产构建
    params:
      platform: ios

上面的工作流会并行创建 Android 和 iOS 的生产构建。要成功运行此工作流，你需要先使用 EAS CLI 设置并构建你的项目。

最后，使用以下命令运行该工作流：

Terminal

- npx eas-cli@latest workflow:run create-production-builds.yml

完成后，你可以在项目的工作流页面看到工作流正在运行。

使用 GitHub 事件自动化工作流

你可以通过向 GitHub 仓库推送提交来触发工作流。你可以按以下步骤将 GitHub 仓库连接到你的 EAS 项目：

进入项目的GitHub 设置。
按照界面提示安装 GitHub 应用。
选择与 Expo 项目匹配的 GitHub 仓库并将其连接。

然后，将on 触发器添加到你的工作流文件中。例如，如果你想在提交推送到 main 分支时触发工作流，可以添加以下内容：

.eas/workflows/create-production-builds.yml

name: 创建生产构建

on:
  push:
    branches: ['main']

jobs:
  build_android:
    type: build
    params:
      platform: android
  build_ios:
    type: build
    params:
      platform: ios

从 App Store Connect 事件触发工作流

你也可以使用on.app_store_connect从 App Store Connect 事件触发工作流。

在使用 App Store Connect 触发器之前，请先在 EAS 仪表板中配置你的 App Store Connect 连接：

打开 EAS 仪表板并选择你的项目。
进入**项目设置 > 常规 > 连接**。
连接你的 App Store Connect 应用。

示例工作流：

.eas/workflows/app-store-connect-events.yml

name: 响应 App Store Connect 事件

on:
  app_store_connect:
    app_version:
      states:
        - ready_for_review
        - waiting_for_review

jobs:
  send_slack_notification:
    type: slack
    params:
      webhook_url: ${{ env.SLACK_WEBHOOK_URL }}
      message: '应用版本已准备好审核或正在等待审核。'

VS Code 扩展

下载 Expo Tools VS Code 扩展，即可为你的工作流文件获取说明和自动补全。

有反馈或功能需求？请发送邮件至 workflows@expo.dev。

开始使用 EAS Workflows

开始使用

更多

使用 GitHub 事件自动化工作流

从 App Store Connect 事件触发工作流

VS Code 扩展