将应用程序包版本分发给测试人员 - Codelab

1. 概述

图片10.png

在此 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 项目

  1. 登录Firebase
  2. 在 Firebase 控制台中,点击添加项目,然后将您的项目命名为“AppBundlesCodelab”。请记住您的 Firebase 项目的项目 ID。如果您不编辑项目 ID,Firebase 会自动为您的项目分配一个唯一 ID。

    图片8.png
  3. (可选)出现提示时,启用 Google Analytics。
  4. 完成其余步骤,然后单击“创建项目”

将您的应用程序包添加到项目中

  1. 在 Firebase 控制台中,点击添加应用

    图片5.png
  2. 注册您的应用时,请确保使用与上传到您的 Google Play 开发者帐户的应用相同的包名称最后,单击注册应用程序
  3. 完成其余步骤,将应用的 Firebase 配置文件 ( google-services.json ) 添加到您的应用。请注意,对于 Android,App Distribution 没有可添加到您的应用中的 Firebase SDK。
  4. 单击继续控制台
  1. 在 Firebase 控制台中,转到您的项目设置

    图片2.png
  2. 集成选项卡中,单击Google Play卡上的链接
  3. 按照屏幕上的说明启用应用程序分发集成,然后选择新创建的 Firebase 应用程序以链接到 Google Play。

现在您已完成这些步骤,只要应用程序包名称匹配,您的 Firebase 应用程序就会链接到 Google Play 开发者帐户中的应用程序。

3. 将 App Distribution 添加到您的项目中

添加 App Distribution Gradle 插件

现在,您将使用 Android Studio 将 App Distribution 及其 Gradle 插件添加到您的应用程序中。

  1. 在项目级 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
    }
    
  2. 在项目级设置 Gradle 文件 ( android/settings.gradle.kts ) 中,将 Google 的 Maven 存储库添加到pluginManagement块中。
     pluginManagement {
         // Check that you have Google's Maven repository (if not, add it).
         repositories {
             google()
             mavenCentral()
         }
     }
    
  3. 在应用程序级 Gradle 文件 ( android/app/build.gradle.kts ) 中,将 App Distribution 插件添加到plugins块中。
    plugins {
         //...
    
         // Add the App Distribution plugin
         id("com.google.firebase.appdistribution")
    }
    
  4. 如果您位于公司代理或防火墙后面,请添加以下 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. 构建并分发版本

  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
    

测试人员现在将收到下载和测试构建的电子邮件邀请。作为开发人员,您现在可以在应用程序分发仪表板的“发布”选项卡中监视构建。

6. 下载并测试您的版本

在本部分中,您将被设置为测试人员,以便下载您分发的版本。作为测试人员,您需要验证您的测试设备并在 Google Play 商店应用中启用内部应用共享。

  1. 在您的测试设备上,登录您的测试人员电子邮件帐户并打开来自 Firebase 的邀请。

    图片6.png
  2. 使用您的 Google 帐户登录并接受测试分布式版本的邀请。作为一个选项,您还可以下载Firebase App Tester ,它可以防止将下载的版本添加到您设备的Downloads文件夹中。它还显示有关版本的其他信息,例如下载进度和版本。

    图片9.png
  3. 点击版本上的“下载”以从 Play 商店安装它。
  4. 出现提示时,完成其余步骤以启用内部应用程序共享(说明将显示在您的测试设备上,只需完成一次)。

下载完成后,您的版本将自动作为快捷方式显示在设备的主屏幕中。

7. 恭喜!

您刚刚使用 Firebase App Distribution 上传应用程序包并将版本分发给测试人员。

下一步