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-app 或 npx @react-native-community/cli@latest init 到应用商店,它都是最快的路径。
快速开始
下面的eas命令需要 EAS CLI。有关更多信息,请参阅如何安装 EAS CLI。
要构建你的应用,请运行以下命令:
- eas build --platform all此命令会将你的项目发送到 EAS Build,并生成可安装的 Android 和 iOS 二进制文件。你也可以根据需要传入 --platform android 或 --platform ios,一次只构建一个平台。完整的设置说明请参阅创建你的第一个构建。
主要功能
- 为 Android 和 iOS 提供具有一致环境的云端构建
- 自动配置和管理应用签名凭据,或使用你自己的凭据
- 通过 URL 分享内部分发构建
- 使用 eas.json 中的构建配置文件(命名的构建设置集合)以及与 EAS Workflows 或 CI 流水线 的集成来自动化构建
- 通过
--auto-submit和 EAS Submit 将成功构建自动提交到应用商店 - 对
expo-updates集成提供一流支持,包含按配置文件划分的渠道和 runtime version 指导 - 在团队内复用开发构建。当两个团队成员运行
eas build:dev且项目指纹匹配时,现有构建会从 EAS 下载,而不是创建新的构建 - 通过依赖缓存和自定义缓存路径加快构建速度
- 使用 Expo Orbit 在设备上安装构建和更新
何时使用 EAS Build
| 场景 | 建议 |
|---|---|
| 为应用商店构建可直接发布的二进制文件 | |
| 通过内部分发与测试人员共享构建 | |
| 无需本地环境配置即可在团队成员之间保持一致的构建 | |
| 从 CI 或 EAS Workflows 自动化构建 | |
| 托管应用签名凭据 | |
| 在本地调试原生代码 |
常见问题
我可以在现有的 React Native 项目中使用 EAS Build 吗?
可以。EAS Build 可与使用 npx react-native init 或类似工具创建的现有 React Native 项目配合使用。有关更多信息,请参阅在现有 React Native 应用中使用 Expo 概览。
EAS Build 会处理应用签名凭据吗?
可以。EAS Build 可以生成和管理 Android keystores、iOS provisioning profiles 和 distribution 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 是一个新产品且发展迅速,因此我们建议你先熟悉当前的限制。