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 - 预配配置文件
string. 当 provisioningProfileLocation == secureFiles 时，需要此选项。

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

provProfileSourceRepository - 预配配置文件
string. 当 provisioningProfileLocation == sourceRepository 时，需要此选项。

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

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

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

任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

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

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

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

注解

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

你可以安装 Apple 预配配置文件，它：

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

要求

要求	说明
管道类型	YAML、经典版本、经典版本
运行平台	Agent、DeploymentGroup
需求	自承载代理必须具有满足以下要求的功能才能运行使用此任务的作业： xcode
功能	此任务不满足作业中后续任务的任何要求。
命令限制	此任务使用以下命令 限制运行：受限
可设置变量	此任务有权 设置以下变量：provisioningProfileUuid、provisioningProfileName APPLE_PROV_PROFILE_UUID
代理版本	2.182.1 或更高版本
任务类别	实用工具