InstallAppleProvisioningProfile@1 - 安装 Apple 预配配置文件 v1 任务

使用此任务安装 Apple 预配配置文件,这是在 macOS 代理上构建所必需的。

语法

# Install Apple provisioning profile v1
# Install an Apple provisioning profile required to build on a macOS agent machine.
- task: InstallAppleProvisioningProfile@1
  inputs:
    provisioningProfileLocation: 'secureFiles' # 'secureFiles' | 'sourceRepository'. Required. Provisioning profile location. Default: secureFiles.
    provProfileSecureFile: # string. Required when provisioningProfileLocation == secureFiles. Provisioning profile. 
    #provProfileSourceRepository: # string. Required when provisioningProfileLocation == sourceRepository. Provisioning profile. 
    #removeProfile: true # boolean. Remove profile after build. Default: true.

输入

provisioningProfileLocation - 预配配置文件位置
string。 必填。 允许的值:secureFiles(安全文件)、sourceRepository(源存储库)。 默认值:secureFiles

指定要安装的预配配置文件的位置。 可以将预配配置文件上传到 Secure Files,或存储在源存储库或代理上的本地路径中。


provProfileSecureFile - 预配配置文件
stringprovisioningProfileLocation == secureFiles时是必需的。

指定上传到 Secure Files 以在 macOS 代理上安装的预配配置文件。


provProfileSourceRepository - 预配配置文件
stringprovisioningProfileLocation == sourceRepository时是必需的。

指定源存储库中的预配配置文件或 macOS 代理上预配配置文件的本地路径。


removeProfile - 生成 后删除配置文件
boolean。 默认值:true

指定在生成或发布完成后,应从代理中删除预配配置文件。


任务控制选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性

输出变量

此任务定义以下 输出变量,可以在下游步骤、作业和阶段中使用。

provisioningProfileUuid
所选预配配置文件的 UUID 属性。

provisioningProfileName
所选预配配置文件的 Name 属性。

注解

可以使用此任务来安装生成 iOS 应用、Apple WatchKit 应用和应用扩展所需的预配配置文件。

可以安装 Apple 预配配置文件,该配置文件为:

  • 存储在服务器上的 安全文件
  • 提交到源存储库或复制到 macOS 代理上的本地路径。 如果要将其提交到源存储库,则应加密预配配置文件。 解密文件 任务可用于在生成或发布期间解密配置文件。

要求

要求 说明
管道类型 YAML,经典版本,经典版本
运行时间 代理,DeploymentGroup
需求 自承载代理必须具有与以下 要求 运行使用此任务的作业 功能:
功能 此任务不满足作业中后续任务的任何要求。
命令限制 此任务使用以下 命令限制运行: 受限
Settable 变量 此任务有权 设置以下变量:provisioningProfileUuid、provisioningProfileName、APPLE_PROV_PROFILE_UUID
代理版本 2.182.1 或更高版本
任务类别 效用
要求 说明
管道类型 YAML,经典版本,经典版本
运行时间 代理,DeploymentGroup
需求 自承载代理必须具有与以下 要求 运行使用此任务的作业 功能:
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 2.116.0 或更高版本
任务类别 效用