This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
开始使用自定义构建
编辑页面
了解如何使用自定义构建扩展 EAS Build。
自定义构建允许你通过在构建流程之前、期间或之后运行命令来定制项目的构建过程。自定义构建可以从 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 示例,包含自定义构建的示例,例如设置函数、使用环境变量、上传构件等。