自动化 EAS CLI 命令

编辑页面

了解如何使用 EAS Workflows 自动执行一系列 EAS CLI 命令。


For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

如果你正在使用 EAS CLI 来构建、提交和更新你的应用,你可以借助 EAS Workflows 自动化执行一系列命令。EAS Workflows 可以构建、提交和更新你的应用,同时还可以运行其他任务,例如 Maestro 测试、单元测试、自定义脚本等。

下面你将看到如何设置项目以使用 EAS Workflows,随后是常见的 EAS CLI 命令示例,以及如何使用 EAS Workflows 来运行它们。

配置你的项目

EAS Workflows 可选择支持一个与你的 EAS 项目关联的 GitHub 仓库来运行。本指南假设已经关联了一个 GitHub 仓库,并展示了如何在向 GitHub 上的特定分支推送时触发工作流。你可以通过以下步骤将 GitHub 仓库关联到你的 EAS 项目:

  • 前往你项目的 GitHub 设置
  • 按照界面提示安装 GitHub 应用。
  • 选择与 Expo 项目匹配的 GitHub 仓库并连接它。

创建构建

你可以使用 EAS CLI 的 eas build 命令来构建你的项目。要使用 production 构建配置文件创建一个 iOS 构建,你可以运行以下 EAS CLI 命令:

Terminal
eas build --platform ios --profile production

要将此命令写成工作流,请在项目根目录下创建一个名为 .eas/workflows/build-ios-production.yml 的工作流文件。

build-ios-production.yml 中,你可以使用以下工作流来启动一个创建使用 production 构建配置文件的 iOS 构建的任务。

.eas/workflows/build-ios-production.yml
name: iOS production build on: push: branches: ['main'] jobs: build_ios: name: Build iOS type: build params: platform: ios profile: production

一旦你有了这个工作流文件,你可以通过向 main 分支推送提交来启动它,或者运行以下 EAS CLI 命令:

Terminal
eas workflow:run build-ios-production.yml

你可以提供参数来创建 Android 构建,或者使用其他构建配置文件。有关构建任务参数的更多信息,请参阅 构建任务文档

提交构建

你可以使用 EAS CLI 的 eas submit 命令将你的应用提交到应用商店。要提交一个 iOS 应用,你可以运行以下 EAS CLI 命令:

Terminal
eas submit --platform ios

要将此命令写成工作流,请在项目根目录下创建一个名为 .eas/workflows/submit-ios.yml 的工作流文件。

submit-ios.yml 中,你可以使用以下工作流来启动一个提交 iOS 应用的任务。

.eas/workflows/submit-ios.yml
name: Submit iOS app on: push: branches: ['main'] jobs: submit_ios: name: Submit iOS type: submit params: platform: ios

一旦你有了这个工作流文件,你可以通过向 main 分支推送提交来启动它,或者运行以下 EAS CLI 命令:

Terminal
eas workflow:run submit-ios.yml

你可以提供参数来提交其他平台,或者使用其他提交配置文件。有关提交任务参数的更多信息,请参阅 提交任务文档

发布更新

你可以使用 EAS CLI 的 eas update 命令来更新你的应用。要更新你的应用,你可以运行以下 EAS CLI 命令:

Terminal
eas update --auto

要将此命令写成工作流,请在项目根目录下创建一个名为 .eas/workflows/publish-update.yml 的工作流文件。

publish-update.yml 中,你可以使用以下工作流来启动一个发送空中更新的任务。

.eas/workflows/publish-update.yml
name: Publish update on: push: branches: ['*'] jobs: update: name: Update type: update params: branch: ${{ github.ref_name || 'test'}}

一旦你有了这个工作流文件,你可以通过向任意分支推送提交来启动它,或者运行以下 EAS CLI 命令:

Terminal
eas workflow:run publish-update.yml

你可以提供参数来更新特定分支或频道,并配置更新消息。有关更新任务参数的更多信息,请参阅 更新任务文档

下一步

工作流是自动化开发和发布流程的强大方式。通过工作流示例指南了解如何创建开发构建、发布预览更新以及创建生产构建:

工作流示例

了解如何使用工作流创建开发构建、发布预览更新以及创建生产构建。