This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
开始使用 EAS Workflows
编辑页面
了解如何使用 EAS Workflows 自动化你的 React Native CI/CD 开发和发布流程。
本页面将引导你创建第一个 EAS 工作流:为 Android 模拟器、iOS 模拟器、实体设备以及应用商店构建你应用的开发构建版本和生产构建版本。
开始使用
3 requirements
3 requirements
1.
你需要先注册一个 Expo 账号。
2.
你需要使用以下命令创建一个项目:
- npx create-expo-app@latest --template default@sdk-573.
你需要安装 EAS CLI 来创建和运行工作流:
- npm install -g eas-cli1
运行以下命令来创建一个工作流,用于为 Android 和 iOS 创建开发构建:
- eas workflow:create --template build然后按提示操作,并在出现 [Action requested] 步骤时继续执行。该命令会在 .eas/workflows/build.yml 处生成一个工作流文件,并为你在 EAS 上构建项目进行设置。
2
3
当构建完成后,你可以通过网站界面将它们安装到你的实体设备上。你也可以运行以下命令,将最新构建安装到你的 Android 模拟器和 iOS 模拟器上:
- eas build:run -p android --latest- eas build:run -p ios -e development-ios-simulator --latest然后,启动一个开发服务器,这样开发构建就可以加载你的应用:
- npx expo start创建生产构建
当你准备为应用商店构建时,使用 deploy 模板生成一个发布工作流:
- eas workflow:create --template deploy这会为自动化部署配置你的项目:它会配置 EAS Build 和 EAS Update,并设置你的应用标识符,然后将一个完整的发布工作流写入 .eas/workflows/deploy.yml。
运行它时,工作流会为你的项目生成指纹,然后在存在原生更改时构建并提交一个新的生产构建,以便它们可供提交;或者在已存在匹配构建时发布一个空中更新,这将会立即发送给你的用户。
有关生成的工作流的演练,请参阅 部署到生产示例。
如果你只需要创建生产构建,请为每个平台使用一个包含 build 作业的工作流:
name: 创建生产构建 jobs: build_android: type: build # 此作业类型会为 Android 创建一个生产构建 params: platform: android profile: production build_ios: type: build # 此作业类型会为 iOS 创建一个生产构建 params: platform: ios profile: production
此工作流使用你 eas.json 中的 production 配置。生产构建需要应用签名凭据。请使用以下命令为每个平台进行设置:
- eas credentials:configure-build -p android -e production- eas credentials:configure-build -p ios -e production然后,运行该工作流:
- eas workflow:run .eas/workflows/create-production-builds.yml更多
使用 GitHub 事件自动化工作流
你可以通过向 GitHub 仓库推送提交来触发工作流。你可以按以下步骤将 GitHub 仓库连接到你的 EAS 项目:
- 进入项目的GitHub 设置。
- 按照界面提示安装 GitHub 应用。
- 选择与 Expo 项目匹配的 GitHub 仓库并将其连接。
然后,将on 触发器添加到你的工作流文件中。例如,如果你想在提交推送到 main 分支时触发工作流,可以添加以下内容:
name: 创建生产构建 on: push: branches: ['main'] jobs: build_android: type: build params: platform: android profile: production build_ios: type: build params: platform: ios profile: production
从 App Store Connect 事件触发工作流
你也可以使用on.app_store_connect从 App Store Connect 事件触发工作流。
在使用 App Store Connect 触发器之前,请先在 EAS 仪表板中配置你的 App Store Connect 连接:
- 打开 EAS 仪表板并选择你的项目。
- 进入**项目设置 > 常规 > 连接**。
- 连接你的 App Store Connect 应用。
示例工作流:
name: 响应 App Store Connect 事件 on: app_store_connect: app_version: states: - ready_for_review - waiting_for_review jobs: send_slack_notification: type: slack environment: production params: webhook_url: ${{ env.SLACK_WEBHOOK_URL }} message: '应用版本已准备好审核或正在等待审核。'
示例会从 SLACK_WEBHOOK_URL 环境变量中读取 webhook URL。运行工作流之前,请先在 production 环境中创建它。
VS Code 扩展
下载 Expo Tools VS Code 扩展,即可为你的工作流文件获取说明和自动补全。
有反馈或功能需求?请发送邮件至 workflows@expo.dev。