为应用商店构建您的项目

编辑

了解如何使用 EAS Build 从命令行创建一个准备提交到应用商店的生产构建。


无论您是使用EAS还是本地构建了本机应用程序二进制文件,您应用开发旅程中的下一步是将应用提交至商店。为此,您需要创建一个生产构建

生产构建是提交给应用商店供公众发布或作为商店协助的测试过程(如 TestFlight)的一部分。本指南说明了如何使用EAS本地创建生产构建。您还可以使用任何能够编译 Android 和 iOS 应用的 CI 服务为 Expo 应用创建生产构建。

使用 EAS 创建生产构建

生产构建必须通过各自的应用商店进行安装。您不能直接在 Android 模拟器、iOS 模拟器或设备上安装它们。唯一的例外是,如果您在构建配置文件中明确设置了"buildType": "apk"用于 Android。不过,提交到商店时建议使用aab,这是默认配置。

eas.json 配置

eas.json中的生产构建的最小配置在您创建第一次构建时已生成:

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

创建生产构建

要创建生产构建,请为平台运行以下命令:

Terminal
eas build --platform android
Terminal
eas build --platform ios

您可以通过将--message附加到构建命令中来添加消息,例如,eas build --platform ios --message "Some message"。消息将出现在 EAS 仪表板上。当您想为团队指定构建的目的时,它会很有用。

或者,您可以使用--platform all选项同时为 Android 和 iOS 构建:

Terminal
eas build --platform all

开发者账户

您需要拥有一个开发者账户,以便将应用提交到您想要的应用商店。

需要拥有 Google Play 开发者会员才能分发到 Google Play 商店。

您可以使用 EAS Build 构建和签名您的应用,但除非您拥有会员资格(一次性 25 美元),否则无法将其上传到 Google Play 商店。

需要拥有 Apple 开发者计划会员才能为 Apple App Store 构建应用。

如果您打算使用 EAS Build 为 Apple App Store 创建生产构建,您需要访问具有 99 美元 Apple 开发者计划 会员资格的账户。

应用签名凭据

在开始为应用商店构建之前,您需要一个商店开发者账户并生成或提供应用签名凭据。

无论您是否有生成应用签名凭据的经验,EAS CLI 都可以完成繁重的工作。您可以选择让 EAS CLI 处理应用签名凭据的过程。

Android 应用签名凭据

  • 如果您尚未为应用生成密钥库,请通过选择生成新的密钥库来使用 EAS CLI,然后即可完成。密钥库会安全地存储在 EAS 服务器上。
  • 如果您想手动生成密钥库,请参见手动 Android 凭据指南以获取更多信息。

iOS 应用签名凭据

  • 如果您尚未生成配置文件和/或分发证书,请通过登录到您的 Apple 开发者计划账户并按照提示使用 EAS CLI。
  • 如果您想手动生成凭据,请参见手动 iOS 凭据指南以获取更多信息。

等待构建完成

默认情况下,eas build命令会等待您的构建完成,但如果您不想等待,可以中断它。相反,请使用 EAS CLI 提示的构建详情页面链接来监控构建进度并阅读构建日志。您也可以通过访问您的构建仪表板或运行以下命令找到此页面:

Terminal
eas build:list

如果您是某个组织的成员且您的构建是以该组织的名义进行的,您将找到该账户的构建仪表板上的构建详情。

自动创建构建

您可以通过EAS Workflows在特定分支的提交上自动创建构建。首先,您需要配置您的项目,在项目根目录中添加一个名为**.eas/workflows/create-builds.yml**的文件,然后添加以下工作流配置:

.eas/workflows/create-builds.yml
name: Create builds on: push: branches: ['main'] jobs: build_android: name: Build Android app type: build params: platform: android profile: production build_ios: name: Build iOS app type: build params: platform: ios profile: production

上述工作流将在每次提交到项目的main分支时创建 Android 和 iOS 构建。您还可以通过以下 EAS CLI 命令手动运行此工作流:

Terminal
eas workflow:run create-builds.yml

了解更多关于常见模式的信息,请参见工作流示例指南

本地发布构建

要在本地创建发布(也称为生产)构建,请参阅以下 React Native 指南,以获取有关 Android 和 iOS 所需步骤的更多信息。

这些指南假设您的项目包含android和/或ios目录,其中包含相应的本机项目。如果您使用持续本机生成,则需要运行预构建以在遵循指南之前生成目录。

注意:遵循下面的指南,在第四步中,当您为 Android 构建发布的**.aab时,请在android**目录中运行./gradlew app:bundleRelease,而不是npx react-native build-android --mode=release

发布到 Google Play 商店

了解如何手动遵循必要步骤将应用发布到 Google Play 商店。

发布到 Apple App Store

了解如何手动遵循必要步骤将应用发布到 Apple App Store。

下一步

应用商店最佳实践

了解有关将您的应用提交到应用商店的最佳实践。