アプリバンドルリリースをテスターに​​配布する-Codelab

1。概要

画像10.png

このコードラボでは、Firebase App Distribution とその Gradle プラグインを使用して、Android App Bundle リリースをテスターに​​配布する方法を学習します。 App Distribution は、アプリのプレリリース バージョンと各リリースに招待するテスターを管理するための中央ハブを提供します。

学べること

  • Firebase アプリを Google Play にリンクする方法
  • アプリをアプリバンドルとしてパッケージ化して構築する方法
  • リリースを作成してライブテスターと共有する方法
  • テスターとして新しいリリースをダウンロードしてテストする方法

必要なもの

  • 最新のAndroid Studioバージョン
  • Android Studio から生成した署名付きバンドル ファイル
  • 自分が所有者または管理者である Google Play デベロッパー アカウント
  • Google Play のアプリはGoogle Play アプリのダッシュボードに設定されており、次のステータスになります。
    • アプリは、Google Play トラック (内部テスト、クローズド テスト、オープン テスト、または本番) のいずれかに配布されます。
    • Google Play でのアプリのレビューが完了し、アプリが公開されました。 [アプリのステータス] 列に次のステータスのいずれかが表示される場合、アプリは公開されています: 内部テスト (ドラフト内部テストではない)、クローズド テスト、オープン テスト、または運用。
  • Firebase から新しいビルドの招待状を受信するためにテスターとして使用できるメール アドレス

2. Firebaseプロジェクトを作成する

  1. Firebaseにサインインします。
  2. Firebase コンソールで[プロジェクトの追加]をクリックし、プロジェクトに「AppBundlesCodelab」という名前を付けます。 Firebase プロジェクトのプロジェクト ID を覚えておいてください。プロジェクト ID を編集しない場合、Firebase はプロジェクトに一意の ID を自動的に割り当てます。

    画像8.png
  3. (オプション)プロンプトが表示されたら、Google Analytics を有効にします。
  4. 残りの手順を完了し、 「プロジェクトの作成」をクリックします。

アプリバンドルをプロジェクトに追加します

  1. Firebase コンソールで、 [アプリを追加]をクリックします。

    画像5.png
  2. アプリを登録するときは、Google Play デベロッパー アカウントにアップロードされたアプリと同じパッケージ名を使用してください。最後に、 「アプリの登録」をクリックします。
  3. 残りの手順を完了して、アプリの Firebase 構成ファイル ( google-services.json ) をアプリに追加します。 Android の場合、App Distribution にはアプリに追加する Firebase SDK がないことに注意してください。
  4. 「コンソールに進む」をクリックします。
  1. Firebase コンソールで、プロジェクト設定に移動します。

    画像2.png
  2. [統合]タブで、 Google Playカードの[リンク]をクリックします。
  3. 画面上の指示に従って App Distribution 統合を有効にし、新しく作成した Firebase アプリを選択して Google Play にリンクします。

これらの手順を完了すると、アプリのパッケージ名が一致する限り、Firebase アプリは Google Play デベロッパー アカウントのアプリにリンクされます。

3. App Distributionをプロジェクトに追加します

App Distribution Gradle プラグインを追加する

次に、Android Studio を使用して、App Distribution とその Gradle プラグインをアプリに追加します。

  1. プロジェクト レベルの Gradle ファイル ( android/build.gradle.kts ) で、App Distribution Gradle プラグインをpluginsブロックに追加します。
    plugins {
     //...

     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution") version "4.0.0" apply false
}
  2. プロジェクト レベルの設定 Gradle ファイル ( android/settings.gradle.kts ) で、Google の Maven リポジトリをpluginManagementブロックに追加します。
     pluginManagement {
     // Check that you have Google's Maven repository (if not, add it).
     repositories {
         google()
         mavenCentral()
     }
 }
  3. アプリレベルの Gradle ファイル ( android/app/build.gradle.kts ) で、App Distribution プラグインをpluginsブロックに追加します。
    plugins {
     //...

     // Add the App Distribution plugin
     id("com.google.firebase.appdistribution")
}
  4. 企業プロキシまたはファイアウォールの内側にいる場合は、App Distribution がディストリビューションを Firebase にアップロードできるようにする次の Java システム プロパティを追加します:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password

Firebase プロジェクトを認証する

Gradle プラグインを使用する前に、Firebase プロジェクトを認証する必要があります。このコードラボでは、プラグインのログイン アクションを使用して Google アカウントにサインインします。

  1. Android プロジェクトのルートで次のコマンドを実行します:
    ~/your-android-project$ ./gradlew appDistributionLogin
  2. コマンドによって認証リンクが出力されたら、ブラウザで開きます。プロンプトが表示されたら、Google アカウントにサインインし、Firebase プロジェクトへのアクセスを許可します。 Gradle コマンドは、App Distribution プラグインが Firebase での認証に使用するリフレッシュ トークンを出力します。
  3. 環境変数FIREBASE_TOKEN前のステップのトークン
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    に設定します。

4. Android Studio でバンドルのプロパティを設定する

このステップでは、後で配布するビルドのテスターとして自分を追加します。ビルドを配布すると、テスターは Firebase から新しいビルドのテストを促すメール通知を受け取ります。

app/build.gradle.ktsにfirebaseAppDistributionセクションを追加し、次のパラメータを含めます。

  • appID : アプリの Firebase アプリ ID。これは、プロジェクト設定の[全般]タブにあります。
  • artifactType : アプリのファイル タイプ ( AAB )。
  • testers : テスターの電子メール アドレス。このコードラボでは、自分のメールアドレスを追加して、配布後にビルドをテストできるようにします。

例えば：

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

オプションとして、 -PappDistribution- property-name = property-valueの形式でコマンド ライン引数を渡すことで、 build.gradle.ktsに設定されている値をオーバーライドすることもできます。

5. リリースをビルドして配布する

  1. bundle Variant Gradle タスクを実行して、アプリ バンドル ファイル
    $ ./gradlew :base:bundleRelease
    を構築します。
  2. アプリケーションのビルド ディレクトリでバンドルを見つけます (デフォルトの場所はapp/build/outputs/bundle/releaseです)。
  3. リリースを配布するには、プロジェクトの Gradle ラッパーを使用してターゲットbundleReleaseとappDistributionUploadReleaseをビルドします。 Firebase トークン (ステップ 3: App Distribution をアプリに追加するで受け取ったもの) を含めます。
    export FIREBASE_TOKEN=your_firebase_token

./gradlew --stop // Only needed for environment variable changes

./gradlew bundleRelease appDistributionUploadRelease

テスターは、ビルドをダウンロードしてテストするための招待メールを受け取るようになります。開発者は、App Distribution ダッシュボードの[リリース]タブでビルドを監視できるようになりました。

6. リリースをダウンロードしてテストします

このセクションでは、配布したリリースをダウンロードするためにテスターとして設定します。テスターは、テストデバイスを認証し、Google Play ストア アプリで内部アプリ共有を有効にする必要があります。

  1. テストデバイスでテスターメールアカウントにサインインし、Firebase からの招待を開きます。

    画像6.png
  2. Google アカウントでサインインし、配布リリースをテストするための招待を受け入れます。オプションとして、 Firebase App Testerをダウンロードすることもできます。これにより、ダウンロードされたリリースがデバイスのDownloadsフォルダーに追加されなくなります。また、ダウンロードの進行状況やリリース バージョンなど、リリースに関する追加情報も表示されます。

    画像9.png
  3. リリースの[ダウンロード]をタップして、Play ストアからインストールします。
  4. プロンプトが表示されたら、残りの手順を実行して内部アプリ共有を有効にします (手順はテスト デバイスに表示され、完了する必要があるのは 1 回だけです)。

ダウンロードが完了すると、リリースがデバイスのホーム画面にショートカットとして自動的に表示されます。

7. おめでとうございます!

Firebase App Distribution を使用してアプリバンドルをアップロードし、テスターに​​リリースを配布しました。

次のステップ