华为云用户手册

图形化构建 在配置构建步骤中，添加“Ionic Android App构建”构建步骤，参考表1配置参数。 表1 Ionic Android App构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 Gradle 根据用户实际开发环境的需要，选择对应的Gradle版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 JDK 根据用户实际开发环境的需要，选择对应的JDK版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 NDK 根据用户实际开发环境的需要，选择对应的NDK版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置命令框中的打包脚本。更多命令使用方法可参考Ionic官网。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 version: 2.0 # 必须是2.0 steps: BUILD: - ionic_android_app: inputs: gradle: '4.8' jdk: '33' ndk: '17' command: ./instrumented.apk 表2 代码示例参数说明 参数 类型 说明 gradle string 根据用户实际开发环境的需要，选择对应的Gradle版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 jdk string 根据用户实际开发环境的需要，选择对应的JDK版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 ndk string 根据用户实际开发环境的需要，选择对应的NDK版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 command string 配置命令框中的打包脚本。更多命令使用方法可参考Ionic官网。

图形化构建 在配置构建步骤中，添加“Bazel构建”构建步骤，参考表1配置参数。 表1 Bazel构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Bazel命令，一般使用系统默认生成的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考官网。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 version: 2.0 # 必须是2.0 steps: BUILD: - bazel: inputs: command: | cd java-maven bazel build //:java-maven_deploy.jar mkdir build_out cp -r bazel-bin/* build_out/ 表2 代码示例参数说明 参数 类型 说明 command string 配置Bazel执行命令。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 version: 2.0 # 必须是2.0 steps: BUILD: - gulp: inputs: command: |- export PATH=$PATH:~/.npm-global/bin npm config set registry http://mirrors.tools.huawei.com/npm/ npm config set prefix '~/.npm-global' #如需安装node-sass #npm config set sass_binary_site https://repo.huaweicloud.com/node-sass/ #npm install node-sass #加载依赖 npm install -verbose gulp 表2 代码示例参数说明 参数 类型 说明 command string 配置gulp命令。更多命令使用方法可参考gulp官网。

图形化构建 在配置构建步骤中，添加“gulp构建”构建步骤，可参考表1配置参数。 表1 gulp构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置gulp命令，一般使用系统默认生成的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考gulp官网。

图形化构建 在配置构建步骤中，添加“Maven构建”构建步骤，参考表1配置参数。 表1 Maven构建步骤参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Maven命令，一般使用系统默认生成的命令即可。如果需要配置更多命令，可参考Maven官网。 setting配置 自动生成setting文件并配置依赖仓库：可根据用户的IP不同，自动识别最优站点访问CodeArts提供的“setting.xml”文件。 国内用户使用“国内站点”，国际用户使用“国际站点”。建议使用默认配置。 “setting.xml”文件中定义了默认的依赖拉取顺序和镜像源代理等配置信息，如果需要使用自定义的“setting.xml”文件，可添加自定义setting.xml文件，然后在默认的打包命令末尾添加--settings settings.xml，即可使用已添加的“settings.xml”文件执行Maven构建。 公有依赖仓库：默认已添加华为开源镜像站，同时配置了HuaweiSDK仓库。此配置仅在需要添加非CodeArts提供的公有依赖仓库时使用，添加方法如下： 单击“添加”。 填写公有依赖仓库地址，根据需要勾选“release仓库”和“snapshot仓库”。release仓库和snapshot仓库至少勾选一个，也可以同时勾选。 release仓库：勾选后，构建过程将尝试从仓库中下载release版本依赖。 snapshot仓库：勾选后，构建过程将尝试从仓库中下载snapshot版本依赖。 私有依赖库：默认已配置CodeArts提供的私有依赖仓库。此配置仅在需要添加其它私有依赖仓库时使用，添加方法如下： 新建nexus repository服务扩展点。 单击“添加”，选择上一步创建的服务扩展点，并根据需要勾选“release仓库”和“snapshot仓库”。 说明： “release仓库”和“snapshot仓库”两种仓库对应的使用场景区分如下，使用时要务必注意区分，避免出现如“将依赖上传到软件发布库但是构建时无法下载”此类场景。 “snapshot仓库”：对于以调试为目的发布的私有依赖包，一般会给依赖版本号增加-SNAPSHOT后缀（如：1.0.0-SNAPSHOT），执行发布操作时，此类依赖会自动发布到snapshot仓库，发布时无需更新版本号，构建命令中增加-U参数即可拉取最新版本。 对于正式发布的私有依赖包，版本号中不可带-SNAPSHOT后缀（如：1.0.0），执行发布操作时，此类依赖会自动发布到release仓库，发布时必须更新版本号，否则会导致构建过程无法拉取最新依赖包。 发布依赖包到CodeArts私有依赖库 编译构建服务默认使用私有依赖库作为私有依赖下载源，如果需要将构建产物上传至私有依赖库供其他项目依赖使用，则需要添加此配置。配置前，需已创建私有依赖库。配置方法如下： 不配置pom：表示无需发布私有依赖包到CodeArts私有依赖库。 配置所有pom：表示在项目下所有“pom.xml”文件增加deploy配置，使用mvn deploy命令将构建出的依赖包上传到私有依赖仓库。 配置后，需在命令窗口，使用“#”注释命令mvn package -Dmaven.test.skip=true -U -e -X -B，如下图： 删除#mvn deploy -Dmaven.test.skip=true -U -e -X -B命令前的“#”，如下图： 上传的私有依赖包，在其他项目添加pom.xml文件中的groupId、artifactId、version坐标即可引用。 单元测试 如果用户需要对单元测试结果进行处理，可配置此项。详见配置单元测试。 缓存配置 选择是否使用缓存以提高构建速度，选择“使用缓存”后，每次构建时会把下载依赖包缓存起来，后续构建无需重复拉取，可有效提高构建速度。 说明： maven构建的依赖包存入缓存之后，只有当租户下面构建的项目有引进新的依赖包时，才会更新缓存目录，并不支持对已有的依赖包缓存文件进行更新。

添加自定义“setting.xml”文件 图形化构建 在“Maven构建”的命令窗口执行cat /home/build/.m2/settings.xml命令，任务执行完成后，会在构建日志中展示“settings.xml”文件的内容。 参考构建日志中的“settings.xml”的信息自定义新的“settings.xml”文件。 在“Maven构建”步骤前增加“下载文件管理的文件”构建步骤。 自定义步骤显示名称，工具版本当前仅支持“shell4.2.46-git1.8.3-zip6.00”。 单击“上传”，在弹出的窗口中选择2中自定义的文件，添加描述，勾选相关协议，然后单击“保存”。 在“下载文件”中选择上传的“setting.xml”文件。 代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 version: 2.0 # 必须是2.0 steps: BUILD: - download_file: inputs: name: settings.xml 表3 下载文件管理的文件代码示例参数说明 参数 类型 说明 name string setting文件名称。 文件大小限制为100k。 文件类型限制为：.xml、.key、.keystore、.jks、.crt、.pem。 最多支持上传20个文件。 已上传的文件可通过两种访问路径进行文件管理。 在编译构建服务首页，单击“更多”，选择“文件管理”。 或在“下载文件管理的文件”构建步骤中单击“管理文件”。 在文件管理页面，可以编辑文件、下载文件、删除文件、为用户配置文件操作权限。 在搜索框输入关键字，可搜索文件。 单击操作列，可修改文件名称，并设置是否允许租户内所有成员在编译构建中使用该文件。 单击操作列，可以下载文件。 单击操作列，在下拉框中选择“删除”，可根据弹框提示确认是否删除。 单击操作列，在下拉框中选择“编辑权限”，可在弹出的界面配置用户操作文件的权限。 图1 配置用户操作文件权限 表4 文件管理角色权限说明 权限类型 拥有该权限的角色 添加用户 项目下所有用户。 查看 文件创建者、相同租户的用户。 使用 文件创建者、文件创建者配置了使用权限的用户。 更新 文件创建者、文件创建者配置了更新权限的用户。 删除 文件创建者、文件创建者配置了删除权限的用户。 编辑权限 文件创建者。 创建者默认有所有权限并且不可被删除和修改。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 version: 2.0 # 必须是2.0 steps: BUILD: - maven: image: cloudbuild@maven3.5.3-jdk8-open inputs: settings: public_repos: - https://mirrors.example.com/maven cache: true # 是否开启缓存 unit_test: coverage: true ignore_errors: false report_path: "**/TEST*.xml" enable: true coverage_report_path: "**/site/jacoco" command: mvn package -Dmaven.test.failure.ignore=true -U -e -X -B 表2 代码示例参数说明 参数 类型 说明 image string 填写镜像地址，有以下两种格式。 cloudbuild@maven3.5.3-jdk8-open：以cloudbuild开始，@作为分隔符，后面是编译构建提供的默认镜像。 完整的swr镜像地址，例如:swr.example.example.com/codeci_test/demo:141d26c455abd6d7xxxxxxxxxxxxxxxxxxxx settings map 可选参数。不配置，则默认使用CodeArts提供的setting.xml文件，如果需要使用自定义的“settings.xml”文件，可先添加自定义setting.xml文件，然后在默认的打包命令mvn package -Dmaven.test.failure.ignore=true -U -e -X -B末尾添加--settings settings.xml。 cache bool 可选参数。 配置是否开启缓存。 true：开启。 false：不开启。 默认值：false。 command string 配置执行的Maven命令。如果需要配置更多命令，可参考Maven官网。 unit_test map 可选参数。 配置单元测试。详细操作指导参考配置单元测试。

图形化构建 在配置构建步骤中，添加“PyInstaller构建”构建步骤，参考表1配置参数。 表1 PyInstaller构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置构建打包命令，默认命令是将项目打包成一个可执行文件。更多命令使用方法可参考PyInstaller官网。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 version: 2.0 # 必须是2.0 steps: BUILD: - python: name: PyInstaller构建 image: cloudbuild@python3.6 inputs: command: | pip config set global.index-url https://pypi.org/simple pip config set global.trusted-host repo.xxcloud.com # -F创建单一的可执行文件，文件位置在dist目录下 # 详细命令参见： https://pyinstaller.readthedocs.io/en/stable/usage.html pyinstaller -F *.py 表2 代码示例参数说明 参数 类型 说明 name string 可选参数。 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 image string 可选参数。 填写镜像版本，“cloudbuild@”为固定部分，后面为支持的Python版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 默认值：cloudbuild@python3.6。 command string 配置构建打包命令，默认命令是将项目打包成一个可执行文件。更多命令使用方法可参考PyInstaller官网。

图形化构建 在配置构建步骤中，添加“Kotlin构建”构建步骤，参考表1配置参数。 表1 Kotlin构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Kotlin构建命令，一般使用系统默认给出的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考Kotlin官网。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 version: 2.0 # 必须是2.0 steps: BUILD: - kotlin: inputs: command: gradle build 表2 代码示例参数说明 参数 类型 说明 command string 配置Kotlin构建命令。更多命令使用方法可参考Kotlin官网。

图形化构建 在配置构建步骤中，添加“Ant构建”构建步骤，参考表1配置参数。 表1 Ant构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Ant构建命令，一般使用系统默认给出的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考Ant官网。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 version: 2.0 # 必须是2.0 steps: BUILD: - ant: inputs: command: ant -f build.xml 表2 代码示例参数说明 参数名称 参数类型 参数说明 command string 配置Ant构建命令。更多命令使用方法可参考Ant官网。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 version: 2.0 # 必须是2.0 steps: BUILD: - download_artifact: inputs: url: xxxxxxxxxxxxx 表2 代码示例参数说明 参数 类型 说明 url string 粘贴从2复制的软件包下载地址。

代码化构建（单仓下载） 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的PRE_BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 version: 2.0 # 必须是2.0 steps: PRE_BUILD: - checkout: name: checkout inputs: scm: codehub # 代码来源:仅支持Repo url: xxxxxxxxx # 拉取代码的ssh地址。 branch: ${codeBranch} # 任何时候都必填，支持参数化 commit: ${commitId} lfs: true submodule: true depth: 100 tag: ${tag} path: test 表2 单仓下载代码示例参数说明 参数 类型 说明 scm string 填写代码源：当前只支持Repo，如果yaml文件中没配置，则使用构建任务配置的代码仓信息。 默认值：codehub。 url string 填写拉取代码的代码仓ssh地址。 branch string 拉取的代码分支。 支持参数化，可使用${codeBranch}调用。 commit string 可选参数。指定commitId构建时，填写拉取的commitId。 支持参数化，可使用${commitId}调用。 tag string 可选参数。指定tag构建时，填写拉取的tag。 支持参数化，可使用${tag}调用。如果同时指定commitId和tag，优先执行commitId构建。 depth int 可选参数。浅克隆深度：当选择commitId构建时，depth必须大于等于commitId所在深度。 默认值：1。 submodule bool 可选参数。配置是否拉取子模块。 true：拉取。 false：不拉取。 默认值：false。 lfs bool 可选参数。配置是否开启git lfs。 true：开启。 false：不开启。 构建默认不拉取音视频、图像等大型文件，开启git lfs后，构建将会全量拉取文件。默认值：false。 path string 可选参数。clone的子路径：代码将会下载到子目录下。

图形化构建 可选择使用指定代码仓库Tag或CommitID构建，同时可选择开启子模块（submodules）自动更新与Git LFS。 预置“代码下载配置”步骤，参考表1配置参数。 表1 代码下载配置参数说明 参数 说明 使用指定代码仓库Tag或CommitID构建 配置执行构建任务时是否指定Tag构建或CommitID构建。 不指定：拉取全部代码进行构建。 指定Tag构建：仅拉取指定Tag的代码进行构建。执行构建任务时需在弹框中输入Tag。 Tag是指代码仓库中的标签。如果代码源选择的是Repo，关于如何创建Tag可参见标签管理。如果代码源使用的是第三方代码仓，需在第三方代码仓中创建标签。 指定CommitID构建：仅拉取指定CommitID的代码进行构建。执行构建任务时需在弹框中输入CommitID。 CommitID是指提交代码时生成的编号。以Repo代码仓为例，CommitID在代码仓库中显示如图1。 图1 CommitID 克隆深度 可选参数。 克隆深度是指距离最近一次提交的提交次数，该值越大，检出代码的深度越深。深度为正整数，推荐最大深度为25。 例如：克隆深度5就表示只克隆最新5次提交记录以及提交之后的最新内容，不克隆历史提交。 子模块（submodules）自动更新 子模块（submodule）是Git为管理仓库共用而衍生出的一个工具，通过子模块用户可以将公共仓库作为子目录包含到用户的仓库中，并能够双向同步该公共仓库的代码，借助子模块用户能将公共仓库隔离、复用，能随时拉取最新代码以及对它提交修复，能大大提高团队效率。更多详情请参考子模块管理（Git Submodule操作）。 开启：当代码仓库存在子模块时，系统在构建时会自动拉取子模块仓库的代码。 不开启：系统不会自动拉取子模块仓库的代码。 开启Git LFS 根据需要选择是否开启“Git LFS”，构建默认不拉取音视频、图像等大型文件，开启“Git LFS”后，构建将会全量拉取文件。

代码化构建（manifest多仓下载） 在安卓、鸿蒙等场景下，一次构建需要同时集成数百甚至上千个代码仓，多个代码仓的集成下载效率至关重要。 编译构建集成Repo下载工具，用户只需进行简单配置即可实现多个代码仓的联动集成。当前支持仅Repo代码仓。 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的PRE_BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 version: 2.0 # 必须是2.0 steps: PRE_BUILD: - manifest_checkout: name: "manifest" inputs: manifest_url: "https://example.example.example.example.example.com/xx/manifest.git" manifest_branch: "master" manifest_file: "default.xml" path: "dir/dir02" repo_url: "https://example.example.example.example.example.com/xx/git-repo.git" repo_branch: "master" username: "someone" password: "${PASSWD}" 表3 manifest多仓下载代码示例参数说明 参数 类型 说明 name string 可选参数。填写步骤名称。默认值为manifest_checkout。 manifest_url string 填写manifest仓地址，包含xml文件的仓库。 manifest_branch string 可选参数。填写manifest分支或revision。默认值为“HEAD”。 manifest_file string 可选参数。manifest文件路径。默认值为“default.xml”。 path string 可选参数。自定义manifest所有子仓下载路径，为工作目录的相对路径 路径不能以“/”开头，不能包含“.”。默认为工作目录。 repo_url string 可选参数。填写repo仓库地址。默认值为“https://gerrit.googlesource.com/git-repo”。 repo_branch string 可选参数。填写repo仓库分支。默认值为“stable”。 username string 可选参数。填写下载仓库时使用的用户名，当下载非公开仓库时需填写。 password string 可选参数。填写下载仓库时使用的https密码，下载非公开仓库时需填写。 manifest_file中定义的多个仓库，必须为同一种代码源。 manifest_url与manifest_file必须为同一种代码源；如果为非公开仓库，username&password应该有下载权限。 repo_url对应的repo仓库，需要有下载权限（仓库开源，或者仓库私有但配置了账号密码）。 以上非必填的参数，如果配置的值为空，则使用默认值。 建议在使用非公开仓库时，用户名密码通过构建的私密参数进行配置，详情参考配置构建任务参数。 该功能目前仅支持北京四区域使用，其余区域后续上线。

图形化构建 在配置构建步骤中，添加“Npm构建”构建步骤，可参考表1配置参数。 表1 Npm构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Npm命令，一般使用系统默认生成的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考Node.js官网。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 version: 2.0 # 必须是2.0 steps: BUILD: - npm: image: cloudbuild@nodejs8.11.2 inputs: command: | export PATH=$PATH:~/.npm-global/bin npm config set registry https://repo.example.com/repository/npm/ npm config set disturl https://repo.example.com/nodejs npm config set sass_binary_site https://repo.example.com/node-sass/ npm config set phantomjs_cdnurl https://repo.example.com/phantomjs npm config set chromedriver_cdnurl https://repo.example.com/chromedriver npm config set operadriver_cdnurl https://repo.example.com/operadriver npm config set electron_mirror https://repo.example.com/electron/ npm config set python_mirror https://repo.example.com/python npm config set prefix '~/.npm-global' npm install --verbose npm run build 表2 代码示例参数说明 参数 类型 说明 image string 填写镜像地址，有以下两种格式。 cloudbuild@nodejs8.11.2：以cloudbuild开始，@作为分隔符，后面是CodeArts Build提供的默认镜像版本。 完整的swr镜像地址，例如:swr.example.example.com/codeci_test/demo:141d26c455abd6d7xxxxxxxxxxxxxxxxxxxx command string 配置Npm命令。更多命令使用方法可参考Node.js官网。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 version: 2.0 # 必须是2.0 steps: BUILD: - harmonyos: name: "HarmonyOS Build" inputs: command: | npm config set strict-ssl false npm config set registry=https://repo.huaweicloud.com/repository/npm/ npm config set @ohos:registry=https://repo.harmonyos.com/npm/ chmod +x hvigorw ./hvigorw clean assembleApp --no-daemon 表2 代码示例参数说明 参数 类型 说明 command string 配置HarmonyOS的执行命令。

图形化构建 在配置构建步骤中，添加“HarmonyOS构建”构建步骤，参考表1配置参数。 表1 HarmonyOS构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 默认版本为“HarmonyOS-API9”，当前仅支持该版本。 命令 配置命令，一般使用系统默认给出的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 version: 2.0 # 必须是2.0 steps: BUILD: - go: inputs: command: | export GO15VENDOREXPERIMENT=1 export GOPROXY=https://goproxy.cn mkdir -p $GOPATH/src/example.com/demo/ cp -rf . $GOPATH/src/example.com/demo/ go install example.com/demo cp -rf $GOPATH/bin/ ./bin 表2 代码示例参数说明 参数 类型 说明 command string 配置Go项目构建命令。更多命令使用方法可参考Go官网。

图形化构建 在配置构建步骤中，添加“Go语言构建”构建步骤，参考表1配置参数。 表1 Go语言构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Go项目构建命令，一般使用系统默认给出的命令即可，如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考Go官网。

编译构建支持的Docker命令 docker login：登录docker仓库。 用法：docker login [options] [server] options填写方法如下表，server为docker仓库地址。 参数 对应短名称 说明 --password -p 登录仓库的用户密码。 --username -u 登录仓库的用户名。 --password -stdin 从标准输入获取用户密码。 示例：docker login -u jack -p 12345 mydocker-registry.com 该示例表示使用jack用户远程登录地址为“mydocker-registry.com”的仓库，密码为“12345”。 高级用法 从文件里获取密码：cat ~/my_password.txt | docker login --username jack --password-stdin docker build：通过Dockerfile或者上下文制作镜像。上下文可以是构建执行所在的本地路径“Path”，也可以是远程URL，如Git库、tarball或文本文件等，还可以是“-”。 用法：docker build [options] Path | URL | - options填写方法如下表。Path/URL/-为上下文来源。 参数 对应短名称 说明 --file -f Dockerfile文件路径，默认为“./Dockerfile”。 --tag -t “镜像名:标签”格式。 示例：docker build -t mydocker-registry.com/org/alpine:1.0 -f ./Dockerfile . 该示例表示使用当前目录且标签为“mydocker-registry.com/org/alpine:1.0”的Dockerfile制作镜像。 docker push：推送镜像到指定的地址。 用法：docker push [options] name[:tag] 示例：docker push mydocker-registry.com/org/alpine:1.0 该示例表示将“mydocker-registry.com/org/alpine”镜像的1.0版本推送到远程仓库。 docker pull：从镜像仓库下载镜像到本地。 用法：docker pull [options] name[:tag|@digest] options填写方法如下表。 参数 对应短名称 说明 --all-tags -a 下载镜像仓库所有标识tag的镜像。 示例：docker pull mydocker-registry.com/org/alpine:1.0 该示例表示从远程仓库拉取版本号为1.0的mydocker-registry.com/org/alpine镜像。 docker tag：修改镜像的标签。 用法：docker tag source_image[:tag] target_image[:tag] 其中source_image[:tag]表示需要修改标签的镜像，target_image[:tag]表示目标镜像。 示例：docker tag mydocker-registry.com/org/alpine:1.0 mydocker-registry/neworg/alpine:2.0 该示例表示，将“mydocker-registry.com/org/alpine”镜像的标签从“1.0”改为“2.0”。 docker save：保存一个或者多个镜像到tar类型的文件，默认是标准输出流。 用法：docker save [options] image [image ...] options填写方法如下表。 参数 对应短名称 说明 --output -o 写文件，非使用标准输出。 示例：docker save -o alpine.tar mydocker-registry.com/org/alpine:1.0 mydocker-registry.com/org/alpine:2.0 该示例表示将mydocker-registry.com/org/alpine:1.0镜像和mydocker-registry.com/org/alpine:2.0镜像打包到alpine.tar。 docker logout：从镜像仓库登出。 用法：docker logout [server] 示例：docker logout mydocker-registry.com 该示例表示登出地址为mydocker-registry.com的镜像仓。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 version: 2.0 # 必须是2.0 steps: BUILD: - docker: inputs: command: | docker pull swr.xx-xxxxx-x.myxxcloud.com/codeci/dockerindocker:dockerindocker18.09-1.3.2 表2 代码示例参数说明 参数 类型 说明 command string 执行命令，每个命令一行。支持的docker命令可参考编译构建支持的Docker命令。

图形化构建 在配置构建步骤中，添加“执行Docker命令”构建步骤，参考表1配置参数。 表1 执行Docker命令参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 单击“添加”，新增一条命令行，请根据需要选择并配置命令。CodeArts Build支持的Docker命令可参考编译构建支持的Docker命令。 可通过拖动命令调整命令执行顺序。

系统预定义参数 系统预定义参数的参数值由系统自动生成，无需定义，如表1所示，可在代码中使用${参数名}引用。 表1 系统预定义参数 参数 说明 BUILDNUMBER 构建编号。格式为“日期.今日该构建任务执行次数”，例如：20200312.3。 TIMESTAMP 构建任务执行时间戳。例如：20190219191621。 INCREASENUM 该构建任务执行总次数，从1开始自增长，每执行1次加1。 PROJECT_ID 该构建任务所在的项目编号。 WORKSPACE 该构建任务拉取的源代码根目录，即工作空间。 GIT_TAG 代码tag名，在配置代码下载时指定tag构建才有值。 COMMIT_ID_SHORTER 代码提交号的前8位。在配置代码下载时指定CommitID构建才有值。 COMMIT_ID 代码提交号。例如：b6192120acc67074990127864d3fecaf259b20f5。

使用参数的操作指导 以图1为例为您介绍如何使用自定义的参数。 图1 自定义参数 在编译构建任务配置页面切换到“构建步骤”页签，在“上传软件包至软件发布库”构建步骤的“发布版本号”中输入“${myparam}”，保存并执行构建任务。 在弹框中，将“myparam”修改为“1.0.1.2”，单击“确定”，等待构建任务执行完成。 图2 填写运行参数值 进入软件发布库，找到刚构建的构建包，即可看到版本号就是修改后的的“myparam”值。 图3 查看构建包