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

1。概要

image10.png

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

あなたが学ぶこと

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

必要なもの

  • Android Studio v4.0 +
  • AndroidStudioから生成した署名付きバンドルファイル
  • あなたが所有者または管理者であるGooglePlayデベロッパーアカウント
  • 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. プロジェクトの作成]クリックし、その後、残りの手順を完了します。

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

  1. Firebaseコンソールでは、追加アプリをクリックしてください。

    image5.png
  2. あなたのアプリを登録する場合は、Google PlayデベロッパーアカウントにアップロードのAppと同じパッケージ名を使用してください。最後に、登録アプリをクリックしてください。
  3. あなたのアプリのFirebase設定ファイル(追加する残りのステップ完了google-services.json自分のアプリにします)。 Androidの場合、AppDistributionにはアプリに追加するFirebaseSDKがないことに注意してください。
  4. コンソールに[続行]クリックします。
  1. Firebaseコンソールでは、あなたのプロジェクトの設定に進みます。

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

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

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

App DistributionGradleプラグインを追加します

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

  1. プロジェクト・レベルのGradleファイルで( android/build.gradle )、アプリケーション配布のGradleプラグインとGoogleのMavenのリポジトリを追加します。
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            jcenter()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. あなたのアプリレベルのGradleファイルで( android/app/build.gradle )、アプリケーション配布プラグインを追加します。
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. あなたは、企業のプロキシまたはファイアウォールの後ろにいる場合は、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のApp IDを。あなたはそれを見つけることができます[全般]タブの[プロジェクト設定の。
  • artifactType :アプリのファイルタイプ( AAB )。
  • testers :あなたのテスターのメールアドレス。このコードラボでは、独自の電子メールを追加して、配布後にビルドをテストできるようにします。

例えば:

android {

   // ...

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

// ...
}

オプションとして、また、あなたの中に設定された値上書きすることができbuild.gradle形式でコマンドライン引数を渡すことで-PappDistribution- property-name = property-value

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

  1. 実行bundle Variant :あなたのアプリを構築するためにGradleのタスクは、ファイルバンドル
    $ ./gradlew :base:bundleRelease
    
  2. アプリケーションのビルドディレクトリ内の束を見つけます(デフォルトの場所は、 app/build/outputs/bundle/release )。
  3. リリースを配布するには、ターゲットの構築bundleReleaseappDistributionUploadReleaseプロジェクトのGradleのラッパーで。 Firebaseトークン(手順3:アプリディストリビューションをアプリに追加するときに受け取ったトークン)を含めます。
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

テスターは、ビルドをダウンロードしてテストするための招待メールを受信します。開発者として、あなたは今のApp配布ダッシュボードのリリースタブでビルドを監視することができます。

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

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

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

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

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

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

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

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

次のステップ