This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

构建配置流程

编辑页面

了解 EAS CLI 如何为 EAS Build 配置项目。


在本指南中,你将了解当 EAS CLI 使用 eas build:configure(或 eas build,如果项目尚未配置,它会运行相同的流程)配置你的项目时会发生什么。

EAS CLI 在配置你的项目时会执行以下步骤:

1

询问你要配置的平台

当你第一次运行该命令时,它会初始化你的 EAS 项目,并要求你选择要配置的平台。如果你只想将 EAS Build 用于单个平台,那也没问题。如果你改变主意,之后还可以回来配置另一个平台。

2

创建 eas.json

该命令会在根目录下创建一个带有默认配置的 eas.json 文件。它大致如下所示:

eas.json
{ "build": { "development": { "developmentClient": true, "distribution": "internal" }, "preview": { "distribution": "internal" }, "production": {} } }

如果你有一个现有的 React Native 项目,它的内容会略有不同。

这就是你的 EAS Build 配置。它为每个平台定义了三个名为 "development""preview""production" 的构建配置文件(你可以拥有多个构建配置文件,例如 "production""debug""testing" 等等)。如果你想了解更多关于 eas.json 的内容,请参阅 使用 eas.json 进行配置 页面。

3

配置项目

这一步会根据你拥有的项目类型而有所不同。

3.1

初始化完成

这完成了你的项目初始化,使其可以与 EAS Build 兼容。

3.2

Expo 项目

如果你还没有在 app.json 中配置 android.package 和/或 ios.bundleIdentifier,EAS CLI 会在你创建第一个构建时提示你指定它们。

  • android.package 将用作 Android 应用 ID,用于在 Google Play 商店中标识你的应用
  • ios.bundleIdentifier 将用于在 Apple App Store 中标识你的应用

在上面的示例中,eas build --platform android 命令会提示设置 Android 应用 ID。如果你使用 --platform ios 运行该命令,它会提示你设置 iOS bundle identifier。

3.3

现有的 React Native 项目

现有的 React Native 项目不需要额外步骤。

4

后续步骤

这就是将项目配置为与 EAS Build 兼容的全部内容了。还有一个步骤:如果你在 eas.json 中将 cli.requireCommit 设置为 true,系统会提示你提交我们为你所做的所有更改。你可以选择在提交前查看这些更改,也可以指定 git 提交信息,或者使用默认信息。