1. 概述
在此 Codelab 中,您将了解如何使用 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卡上的链接。
- 按照屏幕上的说明启用应用程序分发集成,然后选择新创建的 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") }
- 如果您位于公司代理或防火墙后面,请添加以下 Java 系统属性,使 App Distribution 能够将您的发行版上传到 Firebase:
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
验证您的 Firebase 项目
在使用 Gradle 插件之前,您需要对 Firebase 项目进行身份验证。在此 Codelab 中,您将使用Firebase CLI登录您的 Google 帐户。
在 Android 项目的根目录运行以下命令:
~/your-android-project$ firebase login
参考文档包含更多详细信息。
4. 在 Android Studio 中配置您的包属性
在此步骤中,您将把自己添加为稍后将分发的构建的测试人员。分发构建后,测试人员会收到来自 Firebase 的电子邮件通知,邀请他们测试新构建。
在您的app/build.gradle.kts
中,添加firebaseAppDistribution
部分并包含以下参数:
-
appID
:您应用的 Firebase 应用 ID。您可以在项目设置的“常规”选项卡中找到它。 -
artifactType
:您的应用程序的文件类型 (AAB
)。 -
testers
:您的测试人员的电子邮件地址。对于此 Codelab,请添加您自己的电子邮件,以便您可以在分发构建后对其进行测试。
例如:
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 步:将应用程序分发添加到您的应用中收到的令牌)。export FIREBASE_TOKEN=your_firebase_token ./gradlew --stop // Only needed for environment variable changes ./gradlew bundleRelease appDistributionUploadRelease
测试人员现在将收到下载和测试构建的电子邮件邀请。作为开发人员,您现在可以在应用程序分发仪表板的“发布”选项卡中监视构建。
6. 下载并测试您的版本
在本部分中,您将被设置为测试人员,以便下载您分发的版本。作为测试人员,您需要验证您的测试设备并在 Google Play 商店应用中启用内部应用共享。
- 在您的测试设备上,登录您的测试人员电子邮件帐户并打开来自 Firebase 的邀请。
- 使用您的 Google 帐户登录并接受测试分布式版本的邀请。作为一个选项,您还可以下载Firebase App Tester ,它可以防止将下载的版本添加到您设备的
Downloads
文件夹中。它还显示有关版本的其他信息,例如下载进度和版本。 - 点击版本上的“下载”以从 Play 商店安装它。
- 出现提示时,完成其余步骤以启用内部应用程序共享(说明将显示在您的测试设备上,只需完成一次)。
下载完成后,您的版本将自动作为快捷方式显示在设备的主屏幕中。
7. 恭喜!
您刚刚使用 Firebase App Distribution 上传应用程序包并将版本分发给测试人员。
下一步
- 请参阅应用程序分发文档,了解有关如何管理您的版本的测试人员的更多信息。
- 有关可用于部署应用程序的其他工具的信息,请参阅构建和测试您的 Android App Bundle 。