1。概要
このコードラボでは、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プロジェクトを作成する
- Firebaseにサインインします。
- Firebase コンソールで[プロジェクトの追加]をクリックし、プロジェクトに「AppBundlesCodelab」という名前を付けます。 Firebase プロジェクトのプロジェクト ID を覚えておいてください。プロジェクト ID を編集しない場合、Firebase はプロジェクトに一意の ID を自動的に割り当てます。
- (オプション)プロンプトが表示されたら、Google Analytics を有効にします。
- 残りの手順を完了し、 「プロジェクトの作成」をクリックします。
アプリバンドルをプロジェクトに追加します
- Firebase コンソールで、 [アプリを追加]をクリックします。
- アプリを登録するときは、Google Play デベロッパー アカウントにアップロードされたアプリと同じパッケージ名を使用してください。最後に、 「アプリの登録」をクリックします。
- 残りの手順を完了して、アプリの Firebase 構成ファイル (
google-services.json
) をアプリに追加します。 Android の場合、App Distribution にはアプリに追加する Firebase SDK がないことに注意してください。 - 「コンソールに進む」をクリックします。
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.kts
) で、App Distribution Gradle プラグインをplugins
ブロックに追加します。plugins { //... // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.0" apply false }
- プロジェクト レベルの設定 Gradle ファイル (
android/settings.gradle.kts
) で、Google の Maven リポジトリをpluginManagement
ブロックに追加します。pluginManagement { // Check that you have Google's Maven repository (if not, add it). repositories { google() mavenCentral() } }
- アプリレベルの Gradle ファイル (
android/app/build.gradle.kts
) で、App Distribution プラグインをplugins
ブロックに追加します。plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") }
- 企業プロキシまたはファイアウォールの内側にいる場合は、App Distribution がディストリビューションを Firebase にアップロードできるようにする次の Java システム プロパティを追加します:
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
Firebase プロジェクトを認証する
Gradle プラグインを使用する前に、Firebase プロジェクトを認証する必要があります。このコードラボでは、プラグインのログイン アクションを使用して 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.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. リリースをビルドして配布する
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 ストアからインストールします。
- プロンプトが表示されたら、残りの手順を実行して内部アプリ共有を有効にします (手順はテスト デバイスに表示され、完了する必要があるのは 1 回だけです)。
ダウンロードが完了すると、リリースがデバイスのホーム画面にショートカットとして自動的に表示されます。
7. おめでとうございます!
Firebase App Distribution を使用してアプリバンドルをアップロードし、テスターにリリースを配布しました。
次のステップ
- リリースのテスターを管理する方法の詳細については、App Distribution のドキュメントにアクセスしてください。
- アプリのデプロイに使用できるその他のツールについては、「Android アプリ バンドルの構築とテスト」を参照してください。