外部でホストされているビルドを使用したリリースの配布

2025-05-05

重要

Visual Studio App Center は、2026 年 6 月 30 日まで引き続きサポートされる分析機能と診断機能を除き、2025 年 3 月 31 日に廃止されました。詳細を参照してください。

ビルドファイルやバイナリファイルをアップロードせずに、App Center でアプリのリリースを作成できます。代わりに、ファイルをホストしている場所へのリンクを指定します。 App Center はファイルをダウンロードしません。一部の機能は見つかりませんが、ほとんどの場合、すべてが同じように動作します。

このページでは、外部でホストされるビルドを使用してリリースを作成する方法と、要件と制限事項について説明します。

外部でホストされているビルドを使用してリリースを作成する

任意のリリースと同じ方法で、テスターまたはテスト担当者のグループへのリリースの作成を開始します。次に、ビルドバイナリが外部でホストされているリリースを作成するためのオプションを見つけます。

App Center Web サイトでアプリを開き、[ 配布>リリース ] に移動し、[ 新しいリリース] を選択します。
バイナリを App Center にアップロードせずにリリースを作成するためのウィザードに移動するには、[ ビルド URL の指定] を選択 します。
必要な情報を入力します
1. ホストしているバイナリを指す HTTPS URL。
2. あなたのリリースのビルド番号。
3. 一部のオペレーティングシステムの場合: リリースのバージョン。
[ 次へ ] を選択して、残りのリリース情報を入力します。ここから、フローは通常のリリースと同じです。
[ ノート ] タブで、必要に応じてテスターのリリースノートを入力します。 [次へ] を選択します。
[ 宛先 ] タブで、リリースを配布するテスター/グループを選択します。 [次へ] を選択します。
[ 確認 ] タブで、リリースの詳細を確認します。必要に応じて、リリースをユーザーに通知しないを選択します。
最後に、[ 配布 ] を選択してリリースを配布します。アクセス権を付与したテスト担当者に表示され、設定に応じて通知されます。

API を使用して外部でホストされるビルドを使用してリリースを作成する

アプリケーションプログラミングインターフェイス (API) を使用して、App Center の外部でホストされているバイナリを使用してリリースを作成できます。最初の手順では、正しい URL とバージョン番号と共にリリースを作成します。その後、必要に応じて、より詳細なリリースを更新し、テスト担当者に配布することができます。

App Center API または API 全般に慣れていない場合は、まず、App Center API の概要を参照してください。ここでは、API に対して認証する方法と、所有者名とアプリ名を検索する方法について説明します。以下の値が必要です。

外部リリースの作成

リリースを作成するには、/v0.1/apps/{owner_name}/{app_name}/releases エンドポイントにPOST要求を送信します。このエンドポイントは、次のパラメーターを持つ本文を受け取ります。

external_download_url (必須): ホストしているバイナリを指す HTTPS URL。
build_version (必須): リリースのバージョン。
build_number: リリースのビルド番号。

URL の {owner_name} パラメーターは、アプリを所有する組織またはユーザーアカウントの名前であり、 {app_name} はアプリの名前です。アプリのこれらの値を検索する方法については、 App Center API の概要を参照してください。

たとえば、MyCorp組織が App Center で所有Calculatorアプリの新しいリリースを作成してみましょう。ビルドファイルは、 https://mycorp.example.com/calculator/builds/42でホストされます。バージョンが 1.12 され、ビルド番号が 87324。

次の JSON bodyを使用してhttps://api.appcenter.ms/v0.1/apps/MyCorp/Calculator/releasesにPOST要求を送信します。

{
    "build_version": "1.12",
    "build_number": "87324",
    "external_download_url": "https://mycorp.example.com/calculator/builds/42"
}

X-API-Token ヘッダーに API トークンを設定し、Content-Type ヘッダーを application/json に設定します。応答の例は次のようになります (一部の値は省略されています)。

{
    "app_name": "Calculator",
    "is_external_build": true,
    "id": 4,
    "version": "87324",
    "short_version": "1.12",
    "download_url": "https://mycorp.example.com/calculator/builds/42",
    "install_url": "https://mycorp.example.com/calculator/builds/42",
    "destinations": []
}

指定した URL はダウンロード URL であり、 is_external_build はこれが適切なリリースの種類であることを示しています。インストール URL は、アプリのオペレーティングシステムによって異なる場合があります。 destinationsリストが空です。つまり、テスト担当者はまだリリースにアクセスすることはできません。次にリリースを配布しましょう。

リリースの配布

リリースを作成した後、グループ POST エンドポイントを呼び出して配布します/v0.1/apps/{owner_name}/{app_name}/releases/{release_id}/groups。または、同様のエンドポイントを使用してテスターに配布することもできます。外部でホストされているビルドを含むリリースをストアに配布できないことに注意してください。要件と制限事項を参照してください。

URL の {release_id} パラメーターのリリースを作成したときに返されるid値を使用します。配布グループの GET エンドポイントを呼び出して、配布するグループのidを見つけます。ここでは、リリースをグループ 86aa9283-4e04-4872-a003-208c267d9388 に配布し、リリースをテスト担当者に通知します。

{
  "id": "86aa9283-4e04-4872-a003-208c267d9388",
  "notify_testers": true
}

要件と制限

外部でホストされるリリースには、次の要件と制限があります。

セキュリティで保護された HTTPS URL の背後でバイナリをホストする必要があります。 App Center では、 http://以降の URL は受け入れられませんが、 https://以降の URL のみを受け入れます。
外部でホストされているビルドを含むリリースのみをテスト担当者とグループに配布できます。 Google Play や App Store などのストアでは、バイナリを送信する必要があります。
アプリ内の更新は機能しません。
App Center では、バイナリの MD5 ハッシュ、ファイルサイズ、またはプロビジョニングプロファイルを表示できません。
App Center では、バイナリに再署名したり、iOS アプリケーションのデバイスを自動的に管理したりすることはできません。

外部でホストされているビルドを使用したリリースの識別

外部でホストされているビルドを含むリリースは、アイコンにチェーン記号が表示された App Center に表示されます。 API に対してリリースの詳細を照会すると、trueとしてis_external_buildが示されているのは、App Center の外部でホストされているビルドを含むリリースです。

外部でホストされているビルドを含むリリースのアイコン

この図では、リリース 4 は外部リリースであり、他の 3 つは App Center によってホストされています。