App Center Distribute – Android アプリ内更新プログラム

2025-01-16

重要

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

App Center Distribute を使用すると、App Center 経由で配布するときに、ユーザーが新しいバージョンのアプリをインストールできるようになります。新しいバージョンのアプリが利用可能になると、SDK によって更新ダイアログがユーザーに表示され、新しいバージョンがダウンロードされるか延期されます。更新を選択すると、SDK によってアプリケーションの更新が開始されます。

警告

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

注

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

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

まだアプリケーションで SDK を設定して開始していない場合は、「はじめに」セクションに従ってください。

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

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

プロジェクトのアプリレベルの build.gradle ファイル (app/build.gradle) を開き、 apply pluginの後に次の行を追加します。
```
dependencies {
   def appCenterSdkVersion = '5.0.6'
   implementation "com.microsoft.appcenter:appcenter-distribute:${appCenterSdkVersion}"
}
```
注

Android Gradle プラグインのバージョンが 3.0.0 未満の場合は、実装を コンパイルに置き換える必要があります。
build.gradle ファイルを保存し、Android Studio で Gradle 同期をトリガーしてください。
DownloadManager は、更新プログラムをダウンロードするために使用されます。 App Center SDK では、セキュリティを強化するために TLS 1.2 が適用されます。

2. App Center の配布を開始する

App Center を使用するには、使用するモジュールにオプトインします。既定では、モジュールは起動されません。SDK を起動するときに、各モジュールを明示的に呼び出す必要があります。

AppCenter.start() メソッドに Distribute クラスを追加して、App Center Distribute サービスを開始します。

AppCenter.start(getApplication(), "{Your App Secret}", Distribute.class);

AppCenter.start(application, "{Your App Secret}", Distribute::class.java)

上記のコードサンプルの {Your App Secret} をアプリシークレットに置き換えたかどうかを確認します。 start() メソッドに Distribute クラスへの参照を追加すると、Android Studio によって必要な import ステートメントが自動的に提案されますが、クラス名が認識されないというエラーが表示された場合は、アクティビティクラスの import ステートメントに次の行を追加します。

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.distribute.Distribute;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.distribute.Distribute

注

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 ビルドを準備する

プロジェクトのアプリレベルの build.gradle ファイル (app/build.gradle) を開きます。

製品のフレーバーを追加してビルドバリアントを構成します。

android {
    flavorDimensions "distribute"
    productFlavors {
        appCenter {
            dimension "distribute"
        }
        googlePlay {
            dimension "distribute"
        }
    }
}

依存関係ブロックを変更して、製品のフレーバーに基づいて異なる依存関係を使用します。

dependencies {
    def appCenterSdkVersion = "5.0.6"
    appCenterImplementation "com.microsoft.appcenter:appcenter-distribute:${appCenterSdkVersion}"
    googlePlayImplementation "com.microsoft.appcenter:appcenter-distribute-play:${appCenterSdkVersion}"
}

build.gradle ファイルを保存し、Android Studio で Gradle 同期をトリガーしてください。
ビルドバリアントは、ツールウィンドウバーの [ビルド] > [ビルドバリアントの選択 ] ドロップダウンメニューまたは [ビルドバリアント] で変更できます。

ビルドバリアントの構成の詳細については、 Android のドキュメントを参照してください。

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

既定では、配布ではパブリック配布グループが使用されます。プライベート配布グループを使用する場合は、 setUpdateTrack API を使用して明示的に設定する必要があります。

Distribute.setUpdateTrack(UpdateTrack.PRIVATE);

Distribute.setUpdateTrack(UpdateTrack.PRIVATE)

注

既定値は UpdateTrack.PUBLIC です。このメソッドは、 AppCenter.start メソッド呼び出しの前にのみ呼び出すことができます。更新トラックの変更は、アプリケーションプロセスの再起動時には保持されないため、 AppCenter.start 呼び出しの前にメソッドが常に呼び出されない場合、既定ではパブリックになります。

アプリがフォアグラウンド ( Distribute.setUpdateTrack(UpdateTrack.PRIVATE); および AppCenter.start後) になると、ブラウザーウィンドウが開いてユーザーを認証します。以降のすべての更新チェックでは、プライベートトラックの最新リリースが取得されます。

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

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

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

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

新しいリリースを手動で確認する場合は、更新プログラムの自動チェックを無効にすることができます。これを行うには、SDK の開始前に次のメソッドを呼び出します。

Distribute.disableAutomaticCheckForUpdate();

Distribute.disableAutomaticCheckForUpdate()

注

このメソッドは、 AppCenter.start メソッド呼び出しの前に呼び出す必要があります。

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

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

Distribute.checkForUpdate();

Distribute.checkForUpdate()

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

注

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

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

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

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

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

DistributeListener インターフェイスを実装することで、既定の更新ダイアログの外観をカスタマイズできます。次の例に示すように、 AppCenter.start を呼び出す前にリスナーを登録する必要があります。

Distribute.setListener(new MyDistributeListener());
AppCenter.start(...);

Distribute.setListener(MyDistributeListener())
AppCenter.start(...)

SDK ダイアログをカスタムダイアログに置き換えるリスナー実装の例を次に示します。

import android.app.Activity;
import android.app.AlertDialog;
import android.content.DialogInterface;
import android.net.Uri;

import com.microsoft.appcenter.distribute.Distribute;
import com.microsoft.appcenter.distribute.DistributeListener;
import com.microsoft.appcenter.distribute.ReleaseDetails;
import com.microsoft.appcenter.distribute.UpdateAction;

public class MyDistributeListener implements DistributeListener {

    @Override
    public boolean onReleaseAvailable(Activity activity, ReleaseDetails releaseDetails) {

        // Look at releaseDetails public methods to get version information, release notes text or release notes URL
        String versionName = releaseDetails.getShortVersion();
        int versionCode = releaseDetails.getVersion();
        String releaseNotes = releaseDetails.getReleaseNotes();
        Uri releaseNotesUrl = releaseDetails.getReleaseNotesUrl();

        // Build our own dialog title and message
        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(activity);
        dialogBuilder.setTitle("Version " + versionName + " available!"); // you should use a string resource instead, this is just a simple example
        dialogBuilder.setMessage(releaseNotes);

        // Mimic default SDK buttons
        dialogBuilder.setPositiveButton(com.microsoft.appcenter.distribute.R.string.appcenter_distribute_update_dialog_download, new DialogInterface.OnClickListener() {

            @Override
            public void onClick(DialogInterface dialog, int which) {

                // This method is used to tell the SDK what button was clicked
                Distribute.notifyUpdateAction(UpdateAction.UPDATE);
            }
        });

        // We can postpone the release only if the update isn't mandatory
        if (!releaseDetails.isMandatoryUpdate()) {
            dialogBuilder.setNegativeButton(com.microsoft.appcenter.distribute.R.string.appcenter_distribute_update_dialog_postpone, new DialogInterface.OnClickListener() {

                @Override
                public void onClick(DialogInterface dialog, int which) {

                    // This method is used to tell the SDK what button was clicked
                    Distribute.notifyUpdateAction(UpdateAction.POSTPONE);
                }
            });
        }
        dialogBuilder.setCancelable(false); // if it's cancelable you should map cancel to postpone, but only for optional updates
        dialogBuilder.create().show();

        // Return true if you're using your own dialog, false otherwise
        return true;
    }
    
    @Override
    public void onNoReleaseAvailable(Activity activity) {
        Toast.makeText(activity, activity.getString(R.string.no_updates_available), Toast.LENGTH_LONG).show();
    }
}

import android.app.Activity
import android.app.AlertDialog
import com.microsoft.appcenter.distribute.Distribute
import com.microsoft.appcenter.distribute.DistributeListener
import com.microsoft.appcenter.distribute.ReleaseDetails
import com.microsoft.appcenter.distribute.UpdateAction

class MyDistributeListener : DistributeListener {

    override fun onReleaseAvailable(activity: Activity, releaseDetails: ReleaseDetails): Boolean {

        // Look at releaseDetails public methods to get version information, release notes text or release notes URL
        val versionName = releaseDetails.shortVersion
        val versionCode = releaseDetails.version
        val releaseNotes = releaseDetails.releaseNotes
        val releaseNotesUrl = releaseDetails.releaseNotesUrl

        // Build our own dialog title and message
        val dialogBuilder = AlertDialog.Builder(activity)
        dialogBuilder.setTitle("Version $versionName available!") // you should use a string resource instead, this is just a simple example
        dialogBuilder.setMessage(releaseNotes)

        // Mimic default SDK buttons
        dialogBuilder.setPositiveButton(
            com.microsoft.appcenter.distribute.R.string.appcenter_distribute_update_dialog_download
        ) { dialog, which ->
            // This method is used to tell the SDK what button was clicked
            Distribute.notifyUpdateAction(UpdateAction.UPDATE)
        }

        // We can postpone the release only if the update isn't mandatory
        if (!releaseDetails.isMandatoryUpdate) {
            dialogBuilder.setNegativeButton(
                com.microsoft.appcenter.distribute.R.string.appcenter_distribute_update_dialog_postpone
            ) { dialog, which ->
                // This method is used to tell the SDK what button was clicked
                Distribute.notifyUpdateAction(UpdateAction.POSTPONE)
            }
        }
        dialogBuilder.setCancelable(false) // if it's cancelable you should map cancel to postpone, but only for optional updates
        dialogBuilder.create().show()

        // Return true if you're using your own dialog, false otherwise
        return true
    }

    override fun onNoReleaseAvailable(activity: Activity) {
        Toast.makeText(activity, activity.getString(R.string.no_updates_available), Toast.LENGTH_LONG).show()
    }
}

例に示すように、Distribute.notifyUpdateAction(UpdateAction.UPDATE);を呼び出すか、リスナーがtrueを返す場合はDistribute.notifyUpdateAction(UpdateAction.POSTPONE);する必要があります。

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

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

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

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

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

SDK で更新プログラムがチェックされ、現在使用されている更新プログラムよりも新しい更新プログラムが見つからない場合は、DistributeListenerインターフェイスコールバックからのonNoReleaseAvailableが呼び出されます。これにより、このようなシナリオでカスタムコードを実行できます。上記の例は、更新プログラムが見つからないときにトーストメッセージを表示する方法を示しています。

実行時に App Center の配布を有効または無効にする

実行時に App Center の配布を有効または無効にすることができます。無効にした場合、SDK はアプリ内更新機能を提供しませんが、App Center ポータルでサービスの配布を引き続き使用できます。

Distribute.setEnabled(false);

Distribute.setEnabled(false)

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

Distribute.setEnabled(true);

Distribute.setEnabled(true)

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

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

注

このメソッドは、 Distribute が開始された後にのみ使用する必要があります。

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

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

Distribute.isEnabled();

Distribute.isEnabled()

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

注

このメソッドは、 Distribute が開始された後にのみ使用する必要があり、常に開始前に false 返されます。

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

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

デバッグビルドでアプリ内更新を有効にするには、 AppCenter.startする前に次のメソッドを呼び出します。

Distribute.setEnabledForDebuggableBuild(true);

Distribute.setEnabledForDebuggableBuild(true)

注

このメソッドはデバッグビルドにのみ影響し、リリースビルドには影響しません。デバッグビルドとは、 android:debuggable フラグが true に設定されることを意味します (これは通常、gradle の定義済みのデバッグビルドバリアントによって自動的に設定されます)。それ以外の場合、これはリリースビルドです。

アプリ内更新のしくみ

注

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

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

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

ヒント

同じ APK を 2 回目にアップロードした場合、バージョンが同一の場合、ダイアログは表示 されません 。

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

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

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

ヒント

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