EAS Build

编辑页面

EAS Build 是一个托管服务,用于为你的 Expo 和 React Native 项目构建应用二进制文件。


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

EAS Build 是 Expo Application Services(EAS)的托管服务,它会为你的 Expo 和 React Native 项目构建应用二进制文件(也称为独立应用)。

EAS Build 通过提供开箱即用、非常适合 Expo 和 React Native 项目的默认配置,并且在你愿意时为你处理应用签名凭据,让构建用于分发的应用变得简单且易于自动化。它还通过内部分发(使用 ad hoc 和/或企业“通用”配置)让你比以往更轻松地与团队共享构建成果,与 EAS Submit 深度集成以便提交到应用商店,并且对 expo-updates 库提供一流支持。

EAS Build 也旨在适用于任何原生项目,无论你是否使用 Expo 和 React Native。从 npx create-expo-appnpx @react-native-community/cli@latest init 到应用商店,它都是最快的路径。

快速开始

下面的 eas 命令需要 EAS CLI。有关更多信息,请参阅如何安装 EAS CLI

要构建你的应用,请运行以下命令:

Terminal
eas build --platform all

此命令会将你的项目发送到 EAS Build,并生成可安装的 Android 和 iOS 二进制文件。你也可以根据需要传入 --platform android--platform ios,一次只构建一个平台。完整的设置说明请参阅创建你的第一个构建

主要功能

何时使用 EAS Build

场景建议
为应用商店构建可直接发布的二进制文件
通过内部分发与测试人员共享构建
无需本地环境配置即可在团队成员之间保持一致的构建
从 CI 或 EAS Workflows 自动化构建
托管应用签名凭据
在本地调试原生代码

常见问题

如何在提交到应用商店之前与团队共享构建?

使用内部分发通过 URL 共享构建。在 eas.json 中的构建配置文件里设置 "distribution": "internal",即可为 Android 生成可安装的 Android Package(APK)文件,或为 iOS 生成 ad hoc 构建

我可以在现有的 React Native 项目中使用 EAS Build 吗?

可以。EAS Build 可与使用 npx react-native init 或类似工具创建的现有 React Native 项目配合使用。有关更多信息,请参阅在现有 React Native 应用中使用 Expo 概览

EAS Build 会处理应用签名凭据吗?

可以。EAS Build 可以生成和管理 Android keystores、iOS provisioning profilesdistribution certificates,或者使用你提供的凭据。有关更多信息,请参阅应用签名凭据

我可以在本地而不是云端运行构建吗?

可以。使用 本地构建eas build --local 在你的机器上运行构建。这对于调试或需要本地构建的安全策略很有用。

我可以将 EAS Build 与 EAS Workflows 或 CI 流水线一起使用吗?

可以。EAS Build 通过 build 作业类型与 EAS Workflows 集成。向你的工作流配置中添加一个构建作业,例如:

jobs: build_ios: type: build params: platform: ios

该构建作业支持同时构建两个平台,或者根据分支进行条件构建:

jobs: build: type: build params: platform: all profile: ${{ github.ref_name == 'main' && 'production' || 'preview' }}

有关更多信息和其他使用示例,请参阅 EAS Workflows 构建作业

EAS Build 支持通过任何提供商进行从 GitHub 构建在 CI 上构建

EAS Build 使用什么构建服务器基础设施?

Android 构建运行在 Google Cloud Platform 托管的 Linux runner 上,iOS 构建运行在 Expo 的 macOS 云中托管的 macOS runner 上。请参阅构建服务器基础设施

开始使用

创建你的第一个构建

总共只需几分钟即可完成 iOS 和/或 Android 的启动与运行。

与内部测试人员共享你的应用

EAS Build 可以通过一个单独的 URL 帮助共享应用的预览构建。

自动化提交

了解 EAS Build 如何接管你成功的构建,并自动将其上传到应用商店。

应用版本管理

自动化版本递增,让你以后再也不用为此操心。

在本地或你自己的基础设施上运行构建

EAS Build 是一项托管服务,它也可以在你自己的机器上运行,例如用于调试或符合公司的安全策略。

限制

EAS Build 是一个新产品且发展迅速,因此我们建议你先熟悉当前的限制。