创建你的第一个构建

安装最新的 EAS CLI

EAS CLI 是你在终端中与 EAS 服务交互时使用的命令行应用。要安装它，请运行以下命令：

你也可以使用上面的命令来检查是否有新版本的 EAS CLI 可用。我们建议你始终保持在最新版本。

我们建议在全局安装包时使用 npm，而不是 yarn。你也可以改用 npx eas-cli@latest。请记住，在文档中凡是需要使用 eas 的地方，都用它来替代。

登录你的 Expo 账户

如果你已经通过 Expo CLI 登录了 Expo 账户，可以跳过本节所述步骤。否则，请运行以下命令登录：

你可以通过运行 eas whoami 来检查自己是否已登录。

配置项目

要为 EAS Build 配置 Android 或 iOS 项目，请运行以下命令：

要进一步了解幕后发生了什么，请查看 构建配置流程参考。

在开发阶段，我们建议创建一个 开发构建，它是应用的调试构建，并包含 expo-dev-client 库。它能帮助你尽可能快速地迭代，并提供更灵活、更可靠且更完整的开发环境。要安装该库，请运行以下命令：

某些场景下可能还需要额外配置：

• 你的应用代码是否依赖环境变量？将它们添加到你的构建配置中。
• 你的项目是否位于 monorepo 中？请遵循这些说明。
• 你是否使用私有 npm 包？添加你的 npm token。
• 你的应用是否依赖 Node、Yarn、npm、CocoaPods 或 Xcode 等工具的特定版本？在构建配置中指定这些版本。

运行构建

为 Android 模拟器/设备或 iOS 模拟器构建

尝试 EAS Build 最简单的方式，是创建一个可以在 Android 设备/模拟器或 iOS 模拟器上运行的构建。它比上传到商店更快，而且你不需要商店开发者会员账号。如果你想尝试这个方式，请阅读 为 Android 创建可安装的 APK 和 为 iOS 创建模拟器构建。

为应用商店构建

在应用商店的构建流程开始之前，你需要拥有商店开发者账户，并生成或提供应用签名凭据。

无论你是否有生成应用签名凭据的经验，EAS CLI 都会帮你处理大部分工作。你可以选择让 EAS CLI 负责应用签名凭据流程。有关更多信息，请查看下面的 Android 应用签名凭据 或 iOS 应用签名凭据 流程步骤。

在确认你拥有 Google Play Store 或 Apple App Store 账户，并决定是否由 EAS CLI 处理应用签名凭据之后，你可以继续使用以下命令为对应平台的商店构建：

你可以通过向构建命令传递 --message 来为构建附加消息，例如：eas build --platform ios --message "Some message"。该消息会显示在网站上。当你想为团队留下构建目的说明时，它会很有用。

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

如果你之前已经将应用发布到商店，并且有现成的 应用签名凭据 想要使用，请按照这些说明进行配置。

Android 应用签名凭据

• 如果你还没有为应用生成 keystore，可以选择 Generate new keystore 让 EAS CLI 为你处理，然后就完成了。keystore 会安全地存储在 EAS 服务器上。
• 如果你之前使用 expo build:android 构建过应用，可以在这里使用相同的凭据。
• 如果你想手动生成 keystore，请参阅 Android 手动凭据指南 以了解更多信息。

iOS 应用签名凭据

• 如果你还没有生成 provisioning profile 和/或 distribution certificate，可以通过登录你的 Apple Developer Program 账户并按照提示操作，让 EAS CLI 为你处理。
• 如果你已经使用 expo build:ios 构建过应用，可以在这里使用相同的凭据。
• 如果你更希望手动生成凭据，请参阅 iOS 手动凭据指南 以了解更多信息。

等待构建完成

默认情况下，eas build 命令会等待你的构建完成，但如果你不想等待，也可以中断它。构建开始后，按照 EAS CLI 提示的构建详情页面链接即可查看进度并阅读日志。你也可以访问 你的构建仪表板 或运行以下命令来找到该页面：

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

构建失败了吗？ 请再次检查你是否遵循了 配置步骤 中适用的说明，如有需要，请参考 故障排查指南。

部署构建

如果你已经走到这一步，恭喜你！根据你选择的路径，你现在要么已经拥有一个可上传到应用商店的构建，要么已经拥有一个可以直接安装到 Android 设备/iOS 模拟器上的构建。

将你的应用分发到应用商店

只有当你专门为此目的构建时，才可以提交到应用商店。如果你创建的是用于商店的构建，请了解如何使用 EAS Submit 将应用提交到应用商店。

安装并运行应用

只有当你明确为此目的构建时，才能将应用直接安装到你的 Android 设备/iOS 模拟器上。如果你是为应用商店分发而构建，则需要先上传到应用商店，然后从那里安装（例如，通过 Apple 的 TestFlight 应用）。

要了解如何将应用直接安装到你的 Android 设备/iOS 模拟器，请从 你的构建仪表板 进入构建详情页面，并点击 “Install” 按钮。