This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

了解如何使用 EAS Build 从命令行创建适用于提交到应用商店的应用生产构建版本。

无论你是使用 EAS 还是 本地 构建了原生应用二进制文件，应用开发旅程的下一步就是将你的应用提交到各个应用商店。为此，你需要创建一个生产构建。

生产构建会提交到应用商店，用于向广大用户发布，或者作为应用商店支持的测试流程的一部分，例如 TestFlight。本指南将说明如何使用 EAS 和 本地 创建生产构建。对于 Expo 应用，也可以使用任何能够编译 Android 和 iOS 应用的 CI 服务来创建生产构建。

使用 EAS 的生产构建

生产构建必须通过各自对应的应用商店安装。你不能直接将其安装到 Android 模拟器、iOS 模拟器或设备上。唯一的例外是，如果你在构建配置中显式为 Android 设置 "buildType": "apk"。不过，建议在提交到商店时使用 aab，这也是默认配置。

eas.json 配置

当你创建第一个构建时，eas.json 中用于生成生产构建的最小配置就已经创建好了：

{
  "build": {
    %%placeholder-start%%... %%placeholder-end%%
    "production": {}
    %%placeholder-start%%... %%placeholder-end%%
  }
}

创建生产构建

要创建生产构建，请针对某个平台运行以下命令：

你可以通过在构建命令中传入 --message 来为构建附加一条消息，例如，eas build --platform ios --message "Some message"。该消息会显示在 EAS 仪表板上。当你想为团队指定此次构建的目的时，这会很有用。

另外，你可以使用 --platform all 选项同时为 Android 和 iOS 构建：

开发者账号

你需要为你要提交应用的应用商店拥有一个开发者账号。

应用签名凭据

在构建流程可以开始为应用商店构建之前，你需要一个商店开发者账号，并生成或提供应用签名凭据。

无论你是否有生成应用签名凭据的经验，EAS CLI 都可以帮你处理繁重的工作。你可以选择让 EAS CLI 负责应用签名凭据流程。

Android 应用签名凭据

• 如果你还没有为你的应用生成 keystore，请使用 EAS CLI，选择 Generate new keystore，然后就完成了。keystore 会安全地存储在 EAS 服务器上。
• 如果你想手动生成 keystore，请参阅手动 Android 凭据指南了解更多信息。

iOS 应用签名凭据

• 如果你还没有生成 provisioning profile 和/或 distribution certificate，请使用 EAS CLI，登录你的 Apple Developer Program 账号并按照提示操作。
• 如果你想手动生成凭据，请参阅手动 iOS 凭据指南了解更多信息。

等待构建完成

默认情况下，eas build 命令会等待你的构建完成，但如果你不想等待，可以中断它。作为替代，你可以使用 EAS CLI 提示的构建详情页面链接来监控构建进度并查看构建日志。你也可以通过访问你的构建仪表板或运行以下命令找到此页面：

如果你是某个组织的成员，并且你的构建是代表该组织进行的，你会在该账号的构建仪表板上找到构建详情。

自动创建构建

你可以使用 EAS Workflows 在提交到特定分支时自动创建构建。首先，你需要配置你的项目，在项目根目录下添加一个名为 .eas/workflows/create-builds.yml 的文件，然后添加以下 workflow 配置：

name: 创建构建

on:
  push:
    branches: ['main']

jobs:
  build_android:
    name: 构建 Android 应用
    type: build
    params:
      platform: android
      profile: production
  build_ios:
    name: 构建 iOS 应用
    type: build
    params:
      platform: ios
      profile: production

上面的 workflow 会在每次提交到你项目的 main 分支时创建 Android 和 iOS 构建。你也可以使用以下 EAS CLI 命令手动运行此 workflow：

了解更多关于常见模式的信息，请参阅workflow 示例指南。

在本地发布构建

要在本地创建发布版（也称为生产版）构建，请查看以下 React Native 指南，了解 Android 和 iOS 所需步骤的更多信息。

这些指南假设你的项目包含对应原生项目的 android 和/或 ios 目录。如果你使用持续原生生成，那么在遵循这些指南之前，你需要运行 prebuild 来生成这些目录。

注意：按照下面的指南，在第四步中，当你为 Android 构建发布版 .aab 时，请从 android 目录运行 ./gradlew app:bundleRelease，而不是 npx react-native build-android --mode=release。

下一步