开始使用自定义构建
编辑页面
了解如何使用自定义构建扩展 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
了解更多
查看示例仓库以获取更详细的示例:
自定义构建示例仓库
一个自定义 EAS Build 示例,包含自定义构建的示例,例如设置函数、使用环境变量、上传构件等。