构建配置流程

编辑页面

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


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

在本指南中,你将了解当 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": {} } }

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

这就是你的 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 项目

裸项目没有额外步骤。

4

后续步骤

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