为应用商店构建你的项目

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

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

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

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

使用 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。

下一步