构建配置流程

编辑页面

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


For the complete documentation index, see llms.txt. Use this 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 提交信息,或者使用默认信息。