App Center のビルド構成を Azure Pipelines にエクスポートする

  • [アーティクル]

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

サポートタイムラインと代替方法の詳細をご確認ください。

概要

App Center では、ビルド エクスポート機能を使用して、すべての App Center Build 構成を Azure Pipelines にエクスポートできます。 JSON または YAML ファイルをダウンロードし、Azure Pipelines にインポートできます。

App Center Build 構成を Azure Pipelines に直接移行するのが最も簡単なオプションですが、特定のアプリケーションに対して適切に最適化されていない可能性があります。 より最適化されたエクスペリエンス (Android、 Xcode、 Xamarin) のために、Azure Pipelines をゼロから構築することを検討してください。

前提条件

ビルド構成をインポートする Azure DevOps プロジェクトが必要です。 新しいプロジェクトを作成することも、既存のプロジェクトを使用することもできます。

(省略可能)App Center タスクのサービス接続の追加

App Center Test または App Center Distribute がビルド構成に統合されている場合は、サービス接続を作成する必要があります

  1. Azure DevOps プロジェクト設定 -> Pipelines -> Service 接続に移動します
  2. [新しいサービス接続] を選択する
  3. 'Visual Studio App Center' を検索する -> 次へ
  4. API トークンを作成接続に名前を付けて保存します

JSON ファイルを使用したエクスポート

App Center の [ビルド] ページから JSON ファイルをエクスポートします。

  1. App Center ポータルに移動します
  2. アプリケーションを選択する
  3. [ビルド] セクションに移動し、ブランチを選択し、[エクスポート] を選択します [エクスポート] をクリックする
  4. [ダウンロード] を選択し、[JSON のダウンロード] を選択します

JSON ファイルのプロジェクト ID を変更する

Azure DevOps プロジェクトの ID を取得する

  1. 以下の URL に移動し、プロジェクトの ID をコピーします
https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

プロジェクト ID 2. JSON ファイルの project パラメーターにプロジェクト ID を貼り付ける

JSON の編集

Azure Pipeline を作成する

  1. Azure DevOps -> Pipelines -> パイプラインのインポートに移動し、ダウンロードした JSON ファイルを選択します パイプラインのインポート
  2. Pipelineセクションで、Agent Pool パラメーターの下にある Hosted (Azure Pipelines) を選択します
  3. Agent Specification パラメーターで、最新の macOS Microsoft でホストされるエージェントを選択します
  4. Get Sourcesセクションで、アプリケーションのリポジトリにconnectionを追加します

(省略可能)署名ファイルのアップロードとパスワードの更新

App Center Build 構成でコード署名を使用する場合は、 Secure ファイル 機能を使用して、それぞれのファイルを Azure Pipelines にアップロードする必要があります。 さらに、パイプラインに格納されているパスワード 可変 を更新する必要があります

Android

  1. キーストア ファイルを Azure DevOps プロジェクトにアップロードする
  2. keystorePassword、keyAlias、keyPassword、およびkeystoreFilename変数を更新する

iOS/macOS

  1. プロビジョニング プロファイルと証明書を Azure DevOps プロジェクトにアップロードする
  2. P12Password、P12Filename、およびMobileProvisionFilename変数を更新する

Windows (UWP)

  1. Azure DevOps プロジェクトに証明書をアップロードする
  2. packageCertificatePassword、packageCertificateFileName、更新packageCertificateBase64String

App Center Distribute または App Center Test が統合されている場合は、それぞれのタスクを変更する必要があります

  1. Azure DevOps -> Pipelines に移動します
  2. インポートしたパイプラインを選択し、[編集] を選択します
  3. App Center タスクを検索し、[App Center サービス接続] パラメーターで以前に作成したサービス接続を選択する サービス接続

YAML ファイルを使用したエクスポート

App Center の [ビルド] ページから YAML ファイルをエクスポートします。

  1. App Center ポータルに移動します
  2. アプリケーションを選択する
  3. [ビルド] セクションに移動し、ブランチを選択し、[エクスポート] を選択します [エクスポート] をクリックする
  4. [ダウンロード] を選択し、[YAML のダウンロード] を選択します

Azure Pipelines と連携するようにリポジトリを構成する

  1. ダウンロードした azure-pipelines.yml ファイルをアプリケーションのリポジトリにコミットする
  2. Azure DevOps -> Pipelines -> パイプラインの作成に移動します
  3. コードの場所を選択する
  4. パイプラインを確認し、 Run

YAML パイプライン作成プロセスの詳細については、 こちらを参照してください。

(省略可能)署名ファイルのアップロードとパスワードの更新

App Center Build 構成でコード署名を使用する場合は、 Secure ファイル 機能を使用して、それぞれのファイルを Azure Pipelines にアップロードする必要があります。 さらに、パイプラインに格納されているパスワード 可変 を更新する必要があります

Android

  1. キーストア ファイルを Azure DevOps プロジェクトにアップロードする
  2. Azure Pipelines でkeystorePassword、keyAlias、keyPassword、およびkeystoreFilename secret 変数を作成
  3. 作成されたシークレット変数を使用して YAML ファイルを更新する
...
  keystorePassword: $(keystorePassword)
  keyAlias: $(keyAlias)
  keyPassword: $(keyPassword)
  keystoreFilename: $(keystoreFilename)
...

iOS/macOS

  1. プロビジョニング プロファイルと証明書を Azure DevOps プロジェクトにアップロードする
  2. Azure Pipelines でP12Password、P12Filename、およびMobileProvisionFilename secret 変数を作成
  3. 作成されたシークレット変数を使用して YAML ファイルを更新する
...
  P12Password: $(P12Password)
  P12Filename: $(P12Filename)
  MobileProvisionFilename: $(MobileProvisionFilename)
...

Windows (UWP)

  1. Azure DevOps プロジェクトに証明書をアップロードする
  2. Azure Pipelines でpackageCertificatePassword、packageCertificateFileName、およびpackageCertificateBase64String secret 変数を作成
  3. 作成されたシークレット変数を使用して YAML ファイルを更新する
...
  packageCertificatePassword: $(packageCertificatePassword)
  packageCertificateBase64String: $(packageCertificateFileName)
  packageCertificateFileName: $(packageCertificateBase64String)
...

(省略可能)App Center サービス接続を使用するように新しく作成されたパイプラインを承認する

App Center の配布またはテストが統合されている場合は、サービス接続を使用するためにパイプラインを承認する必要があります。

  1. 現在実行中のジョブを開くと、アクセス許可に関するメッセージが表示されます
  2. 実行中のジョブを選択し、サービス接続へのアクセスを Permit します アクセス許可