InstallAppleProvisioningProfile@1 - Apple プロビジョニング プロファイル v1 タスクをインストールする

  • [アーティクル]

このタスクを使用して、macOS エージェントでビルドするために必要な Apple プロビジョニング プロファイルをインストールします。

構文

# 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.

# Install Apple Provisioning Profile v1
# Install an Apple provisioning profile required to build on a macOS agent.
- 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 の場合に必要です。

macOS エージェントにインストールするためにアップロードされた Secure Files プロビジョニング プロファイルを指定します。


provProfileSourceRepository - プロビジョニング プロファイル
string. provisioningProfileLocation == sourceRepository の場合に必要です。

ソース リポジトリからのプロビジョニング プロファイル、または macOS エージェント上のプロビジョニング プロファイルへのローカル パスを指定します。


removeProfile - ビルド後にプロファイルを削除する
boolean. 既定値: true。

ビルドまたはリリースの完了後に、プロビジョニング プロファイルをエージェントから削除する必要があることを指定します。


タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

このタスクでは、ダウンストリームのステップ、ジョブ、およびステージで使用できる次の 出力変数を定義します。

provisioningProfileUuid
選択したプロビジョニング プロファイルの UUID プロパティ。

provisioningProfileName
選択したプロビジョニング プロファイルの Name プロパティ。

注釈

このタスクを使用すると、iOS アプリ、Apple WatchKit アプリ、アプリ拡張機能をビルドするために必要なプロビジョニング プロファイルをインストールできます。

次の Apple プロビジョニング プロファイルをインストールできます。

  • セキュリティで 保護されたファイル としてサーバーに格納されます。
  • ソース リポジトリにコミットするか、macOS エージェントのローカル パスにコピーします。 ソース リポジトリにコミットする場合は、プロビジョニング プロファイルを暗号化する必要があります。 ファイルの暗号化解除タスクは、ビルドまたはリリース中にプロファイルの暗号化を解除するために使用できます。

要件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
上で実行 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するために、次の要求に一致する機能が必要です。
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 このタスクは、次の コマンド制限を使用して実行されます。
設定可能な変数 このタスクには、provisioningProfileUuid、provisioningProfileName、APPLE_PROV_PROFILE_UUIDの 変数を設定するアクセス許可があります。
エージェントのバージョン 2.182.1 以降
タスクのカテゴリ ユーティリティ
要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
上で実行 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するために、次の要求に一致する機能が必要です。
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 2.116.0 以上
タスクのカテゴリ ユーティリティ