了解如何使用自定义构建扩展 EAS Build。
自定义构建允许通过在构建过程之前、期间或之后运行命令来自定义项目的构建过程。自定义构建可以从 EAS CLI 运行,也可以在 React Native CI/CD 管道中运行构建,例如使用 EAS 工作流程。
¥Custom builds allow customizing the build process for your project by running commands before, during, or after the build process. Customized builds can run from EAS CLI or when running builds in a React Native CI/CD pipeline, like with EAS Workflows.
1
¥Create a custom build config
要开始,请在与 eas.json 相同的级别创建目录和名为 .eas/build/hello-world.yml 的文件。两个目录的位置和名称对于 EAS Build 识别项目是否包含自定义构建配置非常重要。
¥To get started, create directories and a file named .eas/build/hello-world.yml at the same level as eas.json. The location and name of both directories are important for EAS Build to identify that a project contains a custom build config.
在 hello-world.yml 中,你将编写自定义构建配置。文件名并不重要;你可以随意命名它。唯一的要求是文件扩展名使用 .yml。
¥Inside the hello-world.yml, you'll write your custom build config. The filename is unimportant; you can name it whatever you want. The only requirement is that the file extension uses .yml.
在文件中添加以下自定义构建配置步骤:
¥Add the following custom build config steps in the file:
build:
name: Hello World!
steps:
- run: echo "Hello, world!"
2
config
属性¥Add config
property in eas.json
要使用自定义构建配置,请在构建配置文件下的 eas.json 中添加 config
属性。
¥To use the custom build config, add the config
property in eas.json under a build profile.
让我们在 build
下创建一个名为 test
的新 建立档案,以运行 test.yml 文件中的自定义配置:
¥Let's create a new build profile called test
under build
to run the custom config from the test.yml file:
{
"build": {
%%placeholder-start%%... %%placeholder-end%%
"test": {
"config": "test.yml",
},
}
如果你希望为每个平台使用单独的配置,你可以为 Android 和 iOS 创建单独的 YAML 配置文件。例如:
¥If you wish to use separate configs for each platform, you can create separate YAML config files for Android and iOS. For example:
{
"build": {
%%placeholder-start%%... %%placeholder-end%%
"test": {
"ios": {
"config": "hello-ios.yml",
},
"android": {
"config": "hello-android.yml",
}
},
}
3
¥Run a build to test the custom build config
要测试自定义构建配置,请运行以下命令:
¥To test the custom build config, run the following command:
-
eas build -p android -e test
构建完成后,你可以通过检查构建详细信息页面上的日志来验证 echo "Hello World!"
脚本是否已执行。
¥After the build is complete, you can verify that the echo "Hello World!"
script was executed by checking the logs on the build's detail page.
¥Learn more
查看示例存储库以获取更详细的示例:
¥Check out the example repository for more detailed examples:
自定义 EAS 构建示例,其中包括自定义构建的示例,例如设置函数、使用环境变量、上传工件等。