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

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

1。概要

image10.png

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

学習内容

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

必要なもの

  • Android Studio v4.0+
  • 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 を自動的に割り当てます。

    image8.png
  3. (オプション)プロンプトが表示されたら、Google アナリティクスを有効にします。
  4. 残りの手順を完了してから、 [Create project]をクリックします。

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

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

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

    image2.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 ) で、App Distribution Gradle プラグインと Google の Maven リポジトリを追加します。
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            mavenCentral()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. アプリ レベルの Gradle ファイル ( android/app/build.gradle ) で、App Distribution プラグインを追加します:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. 企業のプロキシまたはファイアウォールの内側にいる場合は、次の Java システム プロパティを追加して、App Distribution がディストリビューションを Firebase にアップロードできるようにします:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

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

Gradle プラグインを使用する前に、Firebase プロジェクトを認証する必要があります。この Codelab では、プラグインのログイン アクションを使用して 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で、 firebaseAppDistributionセクションを追加し、次のパラメーターを含めます。

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

例えば:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

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

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

  1. bundle Variant Gradle タスクを実行して、アプリ バンドル ファイルをビルドします:
    $ ./gradlew :base:bundleRelease
    
  2. アプリケーションのビルド ディレクトリでバンドルを見つけます (デフォルトの場所はapp/build/outputs/bundle/releaseです)。
  3. リリースを配布するには、プロジェクトの Gradle ラッパーを使用して、ターゲットのbundleReleaseappDistributionUploadReleaseをビルドします。 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 からの招待状を開きます。

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

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

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

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

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

次のステップ