1。概要
この 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 プロジェクトを作成する
- Firebaseにサインインします。
- Firebase コンソールで[プロジェクトを追加]をクリックし、プロジェクトに「AppBundlesCodelab」という名前を付けます。 Firebase プロジェクトのプロジェクト ID を覚えておいてください。プロジェクト ID を編集しない場合、Firebase はプロジェクトに一意の ID を自動的に割り当てます。
- (オプション)プロンプトが表示されたら、Google アナリティクスを有効にします。
- 残りの手順を完了してから、 [Create project]をクリックします。
アプリ バンドルをプロジェクトに追加する
- Firebase コンソールで、 [アプリを追加]をクリックします。
- アプリを登録するときは、Google Play デベロッパー アカウントにアップロードしたアプリと同じパッケージ名を使用してください。最後に、 [アプリの登録]をクリックします。
- 残りの手順を完了して、アプリの Firebase 構成ファイル (
google-services.json
) をアプリに追加します。 Android の場合、App Distribution にはアプリに追加する Firebase SDK がないことに注意してください。 - [Continue to console] をクリックします。
Google Play へのリンク
- Firebase コンソールで、プロジェクト設定に移動します。
- [統合]タブで、 Google Playカードの[リンク]をクリックします。
- 画面の指示に従って App Distribution 統合を有効にし、新しく作成した Firebase アプリを選択して Google Play にリンクします。
これらの手順を完了すると、アプリのパッケージ名が一致する限り、Firebase アプリは Google Play デベロッパー アカウントのアプリにリンクされます。
3. プロジェクトに App Distribution を追加する
App Distribution Gradle プラグインを追加する
次に、Android Studio を使用して、App Distribution とその Gradle プラグインをビルドスクリプトの依存関係としてアプリに追加します。
- プロジェクト レベルの 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` } }
- アプリ レベルの Gradle ファイル (
android/app/build.gradle
) で、App Distribution プラグインを追加します:apply plugin: `com.android.application` // ... // Apply the App Distribution Gradle plugin apply plugin: `com.google.firebase.appdistribution` // ...
- 企業のプロキシまたはファイアウォールの内側にいる場合は、次の Java システム プロパティを追加して、App Distribution がディストリビューションを Firebase にアップロードできるようにします:
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
Firebase プロジェクトを認証する
Gradle プラグインを使用する前に、Firebase プロジェクトを認証する必要があります。この Codelab では、プラグインのログイン アクションを使用して Google アカウントにログインします。
- Android プロジェクトのルートで次のコマンドを実行します:
~/your-android-project$ ./gradlew appDistributionLogin
- コマンドによって認証リンクが出力されたら、ブラウザで開きます。プロンプトが表示されたら、Google アカウントにサインインし、Firebase プロジェクトへのアクセス許可を付与します。 Gradle コマンドは、App Distribution プラグインが Firebase での認証に使用する更新トークンを出力します。
- 環境変数
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. リリースをビルドして配布する
bundle Variant
Gradle タスクを実行して、アプリ バンドル ファイルをビルドします:$ ./gradlew :base:bundleRelease
- アプリケーションのビルド ディレクトリでバンドルを見つけます (デフォルトの場所は
app/build/outputs/bundle/release
です)。 - リリースを配布するには、プロジェクトの 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 ストア アプリで内部アプリ共有を有効にする必要があります。
- テスト デバイスでテスター メール アカウントにサインインし、Firebase からの招待状を開きます。
- Google アカウントでサインインし、配布されたリリースをテストするための招待を受け入れます。オプションとして、 Firebase App Testerをダウンロードすることもできます。これにより、ダウンロードしたリリースがデバイスの
Downloads
フォルダーに追加されなくなります。また、ダウンロードの進行状況やリリース バージョンなど、リリースに関する追加情報も表示されます。 - リリースの[ダウンロード]をタップして、Play ストアからインストールします。
- プロンプトが表示されたら、残りの手順を実行して内部アプリ共有を有効にします (手順はテスト デバイスに表示されるので、一度だけ実行する必要があります)。
ダウンロードが完了すると、リリースがデバイスのホーム画面にショートカットとして自動的に表示されます。
7.おめでとうございます!
Firebase App Distribution を使用してアプリ バンドルをアップロードし、テスターにリリースを配布しました。
次のステップ
- リリースのテスターを管理する方法の詳細については、App Distribution のドキュメントを参照してください。
- アプリのデプロイに使用できるその他のツールについては、Android アプリ バンドルのビルドとテストをご覧ください。