全部产品
  • 首页 > 
  • 配置构建流水线

配置构建流水线

前提条件

操作步骤

1:在指定产品/应用的控制台页面,打开构建页签,查看已创建的构建流水线。

构建

2:在构建流水线列表中,单击操作列的查看详情链接,打开指定构建流水线的详情页面。

详情

3:在指定构建流水线的详情页面:

  • 单击编辑基本信息按钮,打开编辑基本信息右侧栏,修改构建流水线的名称和说明。配置说明参见:新建构建流水线

  • 单击编辑按钮,激活流水线概览页签 > 构建应用阶段的编辑按钮,切换至编辑状态,编辑按钮同时变为退出编辑按钮。

编辑

4:单击构建应用阶段的编辑按钮,打开阶段配置右侧栏,进行相关配置。配置说明参见:阶段配置说明

5:单击确定按钮,保存配置。

阶段配置说明

克隆代码

克隆代码阶段,用于从指定代码仓库的指定分支获取构建应用所需代码。

注意

如未启用克隆代码阶段,虽可设置后续阶段,但无法运行成功。因此,克隆代码阶段必须启用,才能最终实现应用构建。

克隆代码

配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为克隆代码

是否启用

用于设置是否启用本阶段,默认开启。当是否启用设置为,则后续选项生效。

代码地址

默认设置为代码仓库的地址。代码仓库为预先设置,具体操作参见:设置代码仓库

代码分支

用于指定代码分支。

代码访问权限

默认设置代码仓库的访问权限。代码仓库的访问权限为预先设置,具体操作参见:设置代码仓库

切换Xcode版本

切换Xcode版本1709

配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为切换Xcode版本

是否启用

用于设置是否启用本阶段,默认开启。当是否启用设置为,则后续选项生效。

Xcode版本

用于设置Xcode的版本。可选Xcode版本包括:10.3/11.3.1/11.7/12.1/12.2。默认为11.7

说明

如需其他Xcode版本,联系技术支持

切换CocoaPods版本

切换CocoaPods版本1710 配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为切换CocoaPods版本

是否启用

用于设置是否启用本阶段,默认开启。当是否启用设置为,则后续选项生效。

CocoaPods版本

用于设置CocoaPods的版本。可选Xcode版本包括:1.6.2/1.7.5/1.8.4/1.9.3/1.10.0。默认为1.8.4

说明

如需其他CocoaPods版本,联系技术支持

安装缓存

安装缓存阶段,用于设置在初次构建后,是否缓存构建相关资源,以便更快完成后续构建。

安装缓存

配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为安装缓存

是否启用

用于设置是否启用本阶段。默认开启。当是否启用设置为,则后续选项生效。

精确匹配

用于设置是否进行精确匹配。

【取值说明】

  • 开启:不使用低版本Podfile对应的缓存。

  • 关闭:允许使用低版本Podfile对应的缓存。

【是否必选】否

【默认取值】关闭

替换应用版本号

替换应用版本号阶段,用于设置应用构建发布时使用的版本号。如未启用替换应用版本号阶段,则在构建应用时,默认使用代码版本号,作为应用版本号。

替换应用版本号

配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为替换应用版本号

是否启用

用于设置是否启用本阶段。默认关闭。当是否启用设置为,则后续选项生效。

App版本

用于设置App的发布版本号。

build版本

用于标识发布或未发布的内部版本号。

【默认值】单调递增的字符串:${{ env.EMAS_PIPELINE_TIMESTAMP }}

自定义bundleId

用于设置自定义bundleId,以替换工程的Bundle Identifier。

Scheme

用于设置项目的Scheme。

xcodeporj目录

用于设置工程根目录到xcodeporj目录的相对路径。

编译配置

用于设置工程的编译配置。

安装MobileProvision文件

安装mp文件

配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为安装MobileProvision文件

是否启用

用于设置是否启用本阶段。默认开启。当是否启用设置为,则后续选项生效。

mobileprovision文件

用于选择mobileprovision文件。mobileprovision文件须预先设置,具体操作参见:管理iOS证书

安装P12证书

安装P12证书

选项

说明

名称

用于设置本阶段的名称。默认为安装P12证书

是否启用

用于设置是否启用本阶段。默认开启。当是否启用设置为,则后续选项生效。

组织ID

默认设置为苹果颁发的组织ID。

证书名

默认设置为苹果颁发的证书名。

xcodeporj目录

用于设置工程根目录到xcodeporj目录的相对路径。

编译配置

用于设置工程的编译配置。

p12证书

用于选择p12证书。

p12证书须预先设置,具体操作参见:管理iOS证书

Pod Install

Pod Install阶段具有3次重试机制,超时时间为60分钟。

podinstall

配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为Pod Install

是否启用

用于设置是否启用本阶段。默认开启。当是否启用设置为,则后续选项生效。

xcodeproj目录

用于设置工程根目录到xcodeporj目录的相对路径。

deintegrate

用于设置是否分解pods。

repoUpdate

用于设置是否更新索引库。

install

用于设置是否按照用户指定版本,或按照自动选择的最优版本,安装Pods。

  • 如存在Podfile.lock,则按用户指定版本安装Pods;

  • 如不存在Podfile.lock,则根据用户对版本的描述信息,从当前索引库中,自动选择最优版本安装Pods。

update

用于设置是否更新索引库,并按照索引库更新依赖安装Pods。

打印详细信息

用于在Pod安装或更新时,显示调试级别的日志,便于排查问题。

执行构建命令

执行构建命令

配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为执行构建命令

是否启用

用于设置是否启用本阶段。默认开启。当是否启用设置为,则后续选项生效。

Scheme

用于设置项目的Scheme。

xcodeporj目录

用于设置工程根目录到xcodeporj目录的相对路径。

xcworkspace

用于设置工程根目录到xcworkspace目录的相对路径。

configuration

用于设置工程的编译配置。

export-method

用于设置出包的类型。

【取值范围】

  • app-store

  • ad-hoc

  • package

  • enterprise

  • development

【默认取值】ad-hoc

证书名

用于设置Apple颁发的证书名。如构建发包时,使用与工程项目不同的证书,可重新指定。

【是否必选】否,即使用与工程项目相同的证书

额外编译参数

用于指定额外的编译参数。多个参数使用分号、逗号或者换行进行分隔 。

clean

用于设置编译前是否清洗。

上传构建产物

上传构建产物

配置说明如下:

选项

说明

名称

用于设置本阶段的名称。默认为上传构建产物

是否启用

用于设置是否启用本阶段。默认开启。当是否启用设置为,则后续选项生效。

路径

用于设置从根目录到构建产物存储目录的相对路径。

说明

该选项须按照实际情况进行设置。

是否遍历子目录

用于设置在上传构建产物时,是否遍历指定目录的所有子目录。

文件后缀

用于设置文件后缀,上传指定文件类型的构建产品。如设置多个后缀,用“,”分隔。

是否公开

用于设置构建产物上传完成后,是否所有人可访问读取。

说明

如构建Debug包,建议关闭开关键。

后续操作

运行构建流水线