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

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

1。概要

image10.png

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

あなたが学ぶこと

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

必要なもの

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

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

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

    image8.png
  3. (オプション)プロンプトが表示されたら、GoogleAnalyticsを有効にします。
  4. 残りの手順を完了してから、[プロジェクトの作成]をクリックします。

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

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

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

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

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

3.プロジェクトにアプリ配布を追加します

AppDistributionGradleプラグインを追加します

次に、Android Studioを使用して、AppDistributionとそのGradleプラグインをビルドスクリプトの依存関係としてアプリに追加します。

  1. プロジェクトレベルのGradleファイル( android/build.gradle )に、AppDistributionGradleプラグインと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. 企業のプロキシまたはファイアウォールの背後にいる場合は、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コマンドは、AppDistributionプラグインがFirebaseでの認証に使用する更新トークンを出力します。
  3. 環境変数FIREBASE_TOKENを前の手順のトークンに設定します:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

4.AndroidStudioでバンドルプロパティを構成します

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

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

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

例えば:

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:アプリにアプリディストリビューションを追加するで受け取ったもの)を含めます。
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

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

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

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

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

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

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

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

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

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

次のステップ