开始使用自定义构建

编辑页面

了解如何使用自定义构建扩展 EAS Build。


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

自定义构建允许你通过在构建流程之前、期间或之后运行命令来定制项目的构建过程。自定义构建可以从 EAS CLI 运行,或者在 React Native CI/CD 流水线中运行构建时使用,例如使用 EAS Workflows

1

创建自定义构建配置

要开始,请在与 eas.json 同级的位置创建目录和一个名为 .eas/build/hello-world.yml 的文件。两个目录的位置和名称对于 EAS Build 识别项目是否包含自定义构建配置非常重要。

hello-world.yml 中,你将编写自定义构建配置。文件名并不重要;你可以随意命名。唯一的要求是文件扩展名必须使用 .yml

在文件中添加以下自定义构建配置步骤:

.eas/build/hello-world.yml
build: name: Hello World! steps: - run: echo "Hello, world!" # 内置函数(可选)

在真实场景中,你会调用一个内置函数来触发构建。

2

在 eas.json 中添加 config 属性

要使用自定义构建配置,请在某个构建配置下的 eas.json 中添加 config 属性。

让我们在 build 下创建一个名为 test 的新构建配置,以便从 test.yml 文件中运行自定义配置:

eas.json
{ "build": { %%placeholder-start%%... %%placeholder-end%% "test": { "config": "test.yml", }, }

如果你希望为每个平台使用单独的配置,可以为 Android 和 iOS 分别创建独立的 YAML 配置文件。例如:

eas.json
{ "build": { %%placeholder-start%%... %%placeholder-end%% "test": { "ios": { "config": "hello-ios.yml", }, "android": { "config": "hello-android.yml", } }, }

3

运行构建以测试自定义构建配置

要测试自定义构建配置,请运行以下命令:

Terminal
eas build -p android -e test

构建完成后,你可以通过查看构建详情页面上的日志,确认 echo "Hello World!" 脚本已执行。

了解更多

查看示例仓库以获取更详细的示例:

自定义构建示例仓库

一个自定义 EAS Build 示例,包含自定义构建的示例,例如设置函数、使用环境变量、上传构件等。