This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
EAS Build
编辑页面
EAS Build 是一个托管服务,用于为你的 Expo 和 React Native 项目构建应用二进制文件。
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,一次只构建一个平台。完整的设置说明请参阅创建你的第一个构建。
面向 AI 代理的 Expo Skills
如果你使用 AI 代理,请安装 Expo Skills,教会它如何创建生产版本并将其发布到应用商店:
Deploy Expo apps to the app stores with EAS - build and submit to the iOS App Store, Google Play Store, and TestFlight, configure eas.json build and submit profiles, manage app versions and build numbers, and publish App Store metadata and ASO.
主要功能
- 为 Android 和 iOS 提供具有一致环境的云端构建
- 自动配置和管理应用签名凭据,或使用你自己的凭据
- 通过 URL 分享内部分发构建
- 使用 eas.json 中的构建配置文件(命名的构建设置集合)以及与 EAS Workflows 或 CI 流水线 的集成来自动化构建
- 通过
--auto-submit和 EAS Submit 将成功构建自动提交到应用商店 - 对
expo-updates集成提供一流支持,包含按配置文件划分的渠道和运行时版本指导 - 在团队内复用开发构建。当两个团队成员运行
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 是一个新产品且发展迅速,因此我们建议你先熟悉当前的限制。