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-appnpx @react-native-community/cli@latest init 到应用商店,它都是最快的路径。

快速开始

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

Terminal
eas build --platform all

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

面向 AI 代理的 Expo Skills

如果你使用 AI 代理,请安装 Expo Skills,教会它如何创建生产版本并将其发布到应用商店:

eas-app-stores

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.

主要功能

何时使用 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 是一个新产品且发展迅速,因此我们建议你先熟悉当前的限制。