InstallAppleProvisioningProfile@1 - 安裝 Apple 布建設定檔 v1 工作

使用此工作來安裝 Apple 布建設定檔，這是在 macOS 代理程式上建置所需的設定檔。

Syntax

# 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
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	此工作會使用下列 命令限制執行：受限制
可設定變數	此工作具有 設定下列變數的許可權：provisioningProfileUuid、provisioningProfileName、APPLE_PROV_PROFILE_UUID
代理程式版本	2.182.1 或更新版本
工作類別	公用程式