このタスクを使用して、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.
入力
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 |
| の需要 | セルフホステッド エージェントには、このタスクを使用するジョブを実行するために 次の の要求に一致する 機能 が必要です。 |
| 機能の | このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。 |
| コマンドの制限 | このタスクは、次の コマンド制限: restricted を使用して実行されます。 |
| 設定可能な変数 | このタスクには、provisioningProfileUuid、provisioningProfileName、の変数を設定するアクセス許可APPLE_PROV_PROFILE_UUID |
| エージェントのバージョン | 2.182.1 以上 |
| タスク カテゴリ | 効用 |