App Center の配布 - Unity のアプリ内更新プログラム

2025-05-05

重要

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

App Center Distribution を使用すると、App Center を介して配布すると、ユーザー/テスト担当者はアプリの新しいバージョンをインストールできます。有効にすると、SDK によって、最新の更新プログラムのインストールをダウンロードまたは延期するための更新ダイアログがユーザーに表示されます。更新を選択すると、SDK によってアプリケーションの更新が開始されます。

重要

Unity 用の配布 SDK では、UWP はサポートされていません。このページの手順では、Android と iOS についてのみ説明します。

警告

Google Play では、実行時に使用されていなくても、アプリ内更新コードは悪意のある動作と見なされます。アプリを Google Play に提出する前に、このセクションの指示に示されているように、このコードを削除します。アプリ内の更新コードを削除しないと、準拠していない状態になり、Google Play からアプリが削除される可能性があります。

注

自動 UI テストを実行している場合、アプリ内更新を有効にすると、App Center バックエンドに対する認証が試行されるため、自動 UI テストがブロックされます。 UI テストでは、アプリ内更新プログラムを無効にすることをお勧めします。

アプリ内の更新プログラムをアプリに追加する

App Center の配布モジュールを追加する

App Center SDK はモジュール方式のアプローチで設計されています。開発者は、関心のあるサービスのモジュールのみを統合する必要があります。

まだアプリケーションで SDK を設定して開始していない場合は、 Unity の概要に関するドキュメントに従ってください。必ず App Center 配布パッケージをインポートしてください。名前は AppCenterDistribute-v{version}.unitypackageの形式にする必要があります。

注

Android 10 以降では、バックグラウンドでの起動アクティビティに制限があります。バックグラウンドからのアクティビティの開始に関する制限に関する記事を参照してください。

注

Android 10 (Go エディション) で実行されているアプリは 、SYSTEM_ALERT_WINDOW アクセス許可を受け取ることができません。 Go デバイスでのSYSTEM_ALERT_WINDOWに関する記事を参照してください。

注

Android 11 以降では、 ACTION_MANAGE_OVERLAY_PERMISSION 意図によって、ユーザーは常に最上位の設定画面に移動します。この画面では、ユーザーはアプリの SYSTEM_ALERT_WINDOW アクセス許可を付与または取り消すことができます。 Android 11 でのアクセス許可の更新に関する記事を参照してください。

Google Play ビルドのアプリ内更新機能を削除する

Google Play では、実行時に使用されていなくても、アプリ内更新コードは悪意のある動作と見なされます。アプリを Google Play に提出する前に、このコードを削除してください。アプリ内の更新コードを削除しないと、準拠していない状態になり、Google Play からアプリが削除される可能性があります。アプリ内更新プログラムのネイティブコードを削除するには、AppCenterBehavior がアタッチされているゲームオブジェクトの [配布] セクションの [配布を使用] チェックボックスをオフにします。

プライベート配布グループを使用する

既定では、配布ではパブリック配布グループが使用されます。プライベート配布グループを使用する場合は、 UpdateTrack を Private に変更する必要があります。これを行うには、AppCenterBehavior がアタッチされているゲームオブジェクトの [配布] セクションの [更新トラック] ドロップダウンで [プライベート] を選択します。

プライベートトラックを使用すると、ブラウザーウィンドウが開き、ユーザーが認証されます。以降のすべての更新チェックでは、プライベートトラックの最新リリースが取得されます。

ユーザーが プライベートトラックにいる場合は、認証が成功した後、メンバーになっているすべてのプライベート配布グループから最新のリリースが取得されることを意味します。ユーザーが パブリックトラックに乗っている場合は、すべてのパブリック配布グループから最新のリリースを取得することを意味します。

更新プログラムの自動チェックを無効にする

既定では、SDK は新しいリリースを自動的にチェックします。

アプリケーションの起動時。
アプリケーションがバックグラウンドに入ると、フォアグラウンドで再び実行されます。
以前に無効にされている場合は、配布モジュールを有効にする場合。

新しいリリースを手動で確認する場合は、更新プログラムの自動チェックを無効にすることができます。

これを行うには、AppCenterBehavior がアタッチされているゲームオブジェクトの [配布] セクションの [更新プログラムの自動チェック] チェックボックスをオフにします。

その後、次のセクションで説明する CheckForUpdate API を使用できます。

更新プログラムを手動で確認する

Distribute.CheckForUpdate();

これにより、新しいリリースが利用可能な場合に備えて、App Center に要求が送信され、更新ダイアログが表示されます。

注

自動更新が有効になっている場合でも、更新呼び出しの手動チェックが機能します。別のチェックが既に行われている場合、更新プログラムの手動チェックは無視されます。ユーザーが更新プログラムを延期した場合(最新バージョンが必須の更新プログラムでない限り)、更新プログラムの手動チェックは処理されません。

アプリ内更新ダイアログをカスタマイズまたはローカライズする

1. テキストをカスタマイズまたはローカライズする

更新ダイアログに表示されるテキストをローカライズする場合は、独自のリソース文字列を指定できます。この iOS リソースファイルの iOS 用の文字列ファイルと、この Android リソースファイル内の Android 用の文字列ファイルを確認します。同じ文字列名/キーを使用し、独自のアプリリソースファイルのダイアログに反映するローカライズされた値を指定します。

2. 更新ダイアログをカスタマイズする

ReleaseAvailable コールバックを実装することで、既定の更新ダイアログの外観をカスタマイズできます。

警告

リリースコールバック呼び出しを見逃さないようにするために、アプリケーションが読み込む最初のシーンでMonoBehaviourのAwakeメソッドにコールバックを登録する必要があります。

// In this example, OnReleaseAvailable is a method name in same class
Distribute.ReleaseAvailable = OnReleaseAvailable;

SDK ダイアログをカスタムロジックに置き換えるコールバック実装を次に示します。

bool OnReleaseAvailable(ReleaseDetails releaseDetails)
{
    // Look at releaseDetails public properties to get version information, release notes text or release notes URL
    string versionName = releaseDetails.ShortVersion;
    string versionCodeOrBuildNumber = releaseDetails.Version;
    string releaseNotes = releaseDetails.ReleaseNotes;
    Uri releaseNotesUrl = releaseDetails.ReleaseNotesUrl;

    // (Do something with the values if you want)

    // On mandatory update, user can't postpone
    if (releaseDetails.MandatoryUpdate)
    {
        // Force user to update (you should probably show some custom UI here)
        Distribute.NotifyUpdateAction(UpdateAction.Update);
    }
    else
    {
        // Allow user to update or postpone (you should probably show some custom UI here)
        // "GetUserUpdateAction()" isn't part of the SDK; it just represents a way of getting user response.
        // This blocks the thread while awaiting the user's response! This example shouldn't be used literally
        UpdateAction updateAction = GetUserUpdateAction();
        Distribute.NotifyUpdateAction(updateAction);
    }
    // Return true if you're using your own UI to get user response, false otherwise
    return true;
}

Android の実装に関する注意事項:

例に示すように、コールバックがtrueを返す場合は、Distribute.NotifyUpdateAction(UpdateAction.UPDATE);またはDistribute.NotifyUpdateAction(UpdateAction.POSTPONE);を呼び出す必要があります。

NotifyUpdateActionを呼び出さない場合は、アクティビティの変更ごとにコールバックが繰り返されます。

ユーザーアクションが SDK に通知される前にアクティビティが変更された場合は、同じリリースでコールバックを再度呼び出すことができます。

この動作は、次のシナリオに対応するために必要です。

アプリケーションがバックグラウンドに送信され ( HOME キーを押すなど)、別のアクティビティで再開されます。
アクティビティは、アプリケーションを終了せずに別のアクティビティでカバーされます (一部の通知をクリックする場合など)。
上記と同様のシナリオ。

その場合、ダイアログをホストしているアクティビティは、ユーザーの操作なしで置き換えられる可能性があります。そのため、SDK はリスナーを再度呼び出して、カスタムダイアログを復元できるようにします。

3. 更新プログラムが見つからない場合はコードを実行する

SDK が更新プログラムをチェックし、現在使用されている更新プログラムよりも新しい更新プログラムが見つからない場合は、 NoReleaseAvailable コールバックが呼び出されます。これにより、このようなシナリオでカスタムコードを実行できます。次の例に示すように、 AppCenter.Start を呼び出す前にコールバックを登録する必要があります。

// In this example OnNoReleaseAvailable is a method name in same class
Distribute.NoReleaseAvailable = OnNoReleaseAvailable;
AppCenter.Start(...);

void OnNoReleaseAvailable()
{
    AppCenterLog.Info(LogTag, "No release available callback invoked.");
}

## Enable or disable App Center Distribute at runtime

You can enable and disable App Center Distribute at runtime. If you disable it, the SDK won't provide any in-app update functionality but you can still use the Distribute service in the App Center portal.

To disable the Distribute service, use the following code:

```csharp
Distribute.SetEnabledAsync(false);

App Center Distribute を再度有効にするには、同じ API を使用しますが、パラメーターとして true を渡します。

Distribute.SetEnabledAsync(true);

この API は非同期です。詳細については、 App Center の非同期 API ガイドを参照してください。

他の API 呼び出し ( IsEnabledAsync など) の整合性を保つには、この呼び出しを待つ必要はありません。

状態は、アプリケーションの起動間でデバイスのストレージに保持されます。

App Center の配布が有効になっているかどうかを確認する

App Center の配布が有効になっているかどうかを確認することもできます。

Distribute.IsEnabledAsync();

この API は非同期です。詳細については、 App Center の非同期 API ガイドを参照してください。

デバッグビルドのアプリ内更新を有効にする

既定では、アプリ内更新プログラムはリリースビルドに対してのみ有効になります。

Android および iOS でデバッグビルドのアプリ内更新を有効にするには、AppCenterBehavior がアタッチされているゲームオブジェクトの [配布] セクションの [デバッグで配布を有効にする] チェックボックスをオンにします。

App Center の動作

Unity では、デバッグ可能なビルドは、開発ビルドオプションがオンになっている ビルド です。

アプリが更新のために閉じる直前にクリーンアップを実行する

注

このコールバックは iOS でのみ機能します。

次の例に示すように、コールバックを登録します。

// In this example, OnWillExitApp is a method name in same class
Distribute.WillExitApp = OnWillExitApp;

void OnWillExitApp()
{
    // Perform clean up here
}

この場合、 OnWillExitApp() は、Distribute が終了しようとしているときに呼び出されます。

アプリ内の更新のしくみ

注

アプリ内の更新を機能させるには、アプリビルドをリンクからダウンロードする必要があります。 IDE からインストールされている場合、または手動でインストールした場合は機能しません。

アプリ内更新機能は次のように機能します。

この機能は、App Center Distribute サービスを使用して配布される RELEASE ビルド (既定) でのみ機能します。 iOS ガイド付きアクセス機能が有効になっている場合は機能しません。
SDK を統合したら、アプリのリリースバージョンをビルドし、App Center にアップロードします。配布グループ内のユーザーには、新しいリリースに関する通知が電子メールで送信されます。
各ユーザーがメールでリンクを開くと、アプリケーションがデバイスにインストールされます。電子メールリンクを使用してインストールすることが重要です。サイドローディングはサポートされていません。アプリケーションがリンクからダウンロードされると、SDK は後で更新プログラムを確認するために Cookie から重要な情報を保存します。それ以外の場合、SDK にはその重要な情報がありません。
アプリケーションがトラックをプライベートに設定すると、ブラウザーが開いてユーザーを認証し、アプリ内更新を有効にします。パブリックトラックに戻り、後で再度プライベートに戻っても、認証情報が有効なままである限り、ブラウザーは再び開きません。ブラウザー認証が成功すると、ユーザーは自動的にアプリケーションにリダイレクトされます。トラックがパブリック (既定) の場合は、次の手順が直接実行されます。
アプリの新しいリリースでは、アプリ内更新ダイアログが表示され、次の場合にアプリケーションを更新するようユーザーに求められます。
- iOS:
  - より高い値の CFBundleShortVersionString または
  - CFBundleShortVersionStringの値が等しいが、CFBundleVersionの値が大きい。
  - バージョンは同じですが、ビルドの一意の識別子が異なります。
- Android
  - より高い値の versionCode または
  - versionCodeの等しい値ですが、versionNameの値は異なります。

ヒント

同じ.apk/.ipa を 2 回目にアップロードした場合、バイナリが同一の場合、ダイアログは表示されません。 iOS では、同じバージョンプロパティを持つ新しいビルドをアップロードすると、更新ダイアログが表示されます。その理由は、別のバイナリであるためです。 Android では、両方のバージョンプロパティが同じ場合、バイナリは同じと見なされます。

アプリ内更新プログラムをテストする方法

リリースビルド (App Center SDK の配布モジュールを使用) を App Center Portal にアップロードして、アプリ内更新プログラムをテストし、毎回バージョン番号を増やす必要があります。

まだ作成していない場合は、App Center ポータルでアプリを作成します。
新しい配布グループを作成し、名前を付けます。
自分自身 (またはアプリ内更新機能のテストに含めるすべてのユーザー) を追加します。この手順では、このアプリでまだ使用されていない新しいメールアドレスまたは捨てメールアドレスを使用します。これにより、実際のテスターのエクスペリエンスに近いエクスペリエンスが保証されます。
App Center の配布を含み、次に説明するようにセットアップロジックを含むアプリの新しいビルドを作成します。グループがプライベートの場合は、 UpdateTrack プロパティの使用を開始する前に、アプリ内のプライベート更新トラックを設定することを忘れないでください。
ポータルで [ 新しいリリースの配布 ] ボタンをクリックし、アプリのビルドをアップロードします。
アップロードが完了したら、[ 次へ ] をクリックし、以前に作成した 配布グループ をそのアプリ配布の宛先として選択します。
配布を確認し、アプリ内テストグループにビルドを配布します。
そのグループのユーザーは、アプリのテスト担当者への招待を受け取ります。招待を受け入れると、モバイルデバイスから App Center ポータルからアプリをダウンロードできます。アプリ内更新プログラムがインストールされたら、アプリ内更新プログラムをテストする準備が整います。
アプリのバージョンをバンプする (iOS の場合はCFBundleShortVersionString または CFBundleVersion 、Android の場合は versionCode )。
アプリのリリースバージョンをビルドし、前の手順と同様に新しいビルドをアップロードします。前に作成した 配布グループに配布 します。配布グループのメンバーは、次回アプリを起動すると、新しいバージョンの入力を求められます。

ヒント

配布グループなどに関する詳細情報については、App Center の配布を利用する方法に関する情報をご覧ください。App Center Distribute を使用して、コードを追加せずに新しいバージョンのアプリを配布することはできますが、アプリのコードに App Center Distribute を追加すると、テスト担当者とユーザーがアプリ内更新エクスペリエンスを取得する際に、よりシームレスなエクスペリエンスが得られます。