共用方式為


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、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 自我裝載代理程式必須具備 功能, 符合下列 需求, 執行使用此工作的作業: xcode
功能 此工作不符合作業中後續工作的任何需求。
命令限制 此工作會使用下列 命令限制執行: 受限制
Settable 變數 此工作有權 設定下列變數:provisioningProfileUuid、provisioningProfileName、APPLE_PROV_PROFILE_UUID
代理程式版本 2.182.1 或更新
工作類別 效用
要求 說明
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 自我裝載代理程式必須具備 功能, 符合下列 需求, 執行使用此工作的作業: xcode
功能 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 2.116.0 或更新
工作類別 效用