将 app bundle 版本分发给测试人员 - Codelab

1. 概览

在此 Codelab 中，您将学习如何使用 Firebase App Distribution 及其 Gradle 插件将 Android App Bundle 版本分发给测试人员。App Distribution 提供了一个中心，供您管理应用的预发布版本以及您邀请加入每个版本的测试人员。

学习内容

• 如何将 Firebase 应用关联到 Google Play
• 如何将应用打包和构建为 app bundle
• 如何创建版本并将其分享给在线测试人员
• 测试人员如何下载并测试新版本

所需条件

• 最新 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。
   
   
3. （可选）当系统提示时，启用 Google Analytics（分析）。
4. 完成其余步骤，然后点击创建项目。

将您的 app bundle 添加到项目中

1. 在 Firebase 控制台中，点击添加应用。
   
   
2. 注册应用时，请务必使用与上传到您的 Google Play 开发者帐号的应用相同的软件包名称。

   注意：必须使用相同的软件包名称才能将您的 Firebase 应用与 Google Play 开发者帐号相关联，我们将在下一部分中介绍如何操作。

   最后，点击注册应用。
3. 完成其余步骤，将应用的 Firebase 配置文件 (google-services.json) 添加到应用。请注意，对于 Android，App Distribution 没有可添加到应用的 Firebase SDK。
4. 点击继续前往控制台。

关联到 Google Play

1. 在 Firebase 控制台中，前往项目设置。
   
   
2. 在“集成”标签页中，点击 Google Play 卡片上的关联。
3. 按照屏幕上的说明启用 App Distribution 集成，然后选择新创建的 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. 在项目级 Settings 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 项目进行身份验证

您需要先对 Firebase 项目进行身份验证，然后才能使用 Gradle 插件。在此 Codelab 中，您将使用 Firebase CLI 登录您的 Google 帐号。

在您的 Android 项目的根目录下运行以下命令：

~/your-android-project$ firebase login

如需了解详情，请参阅参考文档。

4.在 Android Studio 中配置软件包属性

在此步骤中，您需要将自己添加为稍后将分发的 build 的测试人员。在您分发构建版本后，测试人员会收到 Firebase 发送的邀请他们测试新构建的电子邮件通知。

在 app/build.gradle.kts 中，添加 firebaseAppDistribution 部分并添加以下参数：

• appID：您的应用的 Firebase 应用 ID。您可以在“项目设置”的常规标签页中找到该 ID。
• artifactType：应用的文件类型 (AAB)。
• testers：测试人员的电子邮件地址。对于此 Codelab，请添加您自己的电子邮件地址，以便在分发 build 后对其进行测试。

例如：

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

您也可以选择通过传递 -PappDistribution-property-name=property-value 形式的命令行参数来替换 build.gradle.kts 中设置的值。

5. 构建和分发版本

1. 运行 bundleVariant Gradle 任务以构建 app bundle 文件：

   $ ./gradlew :base:bundleRelease
   

2. 在应用的 build 目录中找到相应软件包（默认位置为 app/build/outputs/bundle/release）。
3. 如需分发此版本，请使用项目的 Gradle 封装容器构建目标 bundleRelease 和 appDistributionUploadRelease。添加 Firebase 令牌（您在“第 3 步：将 App Distribution 添加到您的应用”中收到的令牌）。

   export FIREBASE_TOKEN=your_firebase_token
   
   ./gradlew --stop // Only needed for environment variable changes
   
   ./gradlew bundleRelease appDistributionUploadRelease
   

测试人员现在会收到一封邀请其下载并测试此 build 的电子邮件。作为开发者，您现在可以在 App Distribution 信息中心的版本标签页中监控 build。

6. 下载并测试您的版本

在本部分中，您需要被设置为测试人员，以便下载您分发的版本。作为测试人员，您需要对测试设备进行身份验证，并在 Google Play 商店应用中启用内部应用分享功能。

1. 在测试设备上，登录您的测试人员电子邮件帐号，然后打开来自 Firebase 的邀请。
   
   
2. 使用您的 Google 账号登录，然后接受邀请，测试分发的版本。您也可以选择下载 Firebase App Tester，这会阻止下载的版本添加到设备的 Downloads 文件夹中。该面板还会显示有关各个版本的更多信息，例如下载进度和发布版本。
   
   
3. 点按相应发布版本上的下载即可从 Play 商店安装。
4. 出现提示时，完成剩余步骤即可启用内部应用分享功能（相关说明会显示在测试设备上，只需完成一次即可）。

下载完成后，您的发布版本会自动以快捷方式的形式显示在设备主屏幕上。

7. 恭喜！

您刚刚使用 Firebase App Distribution 上传了一个 app bundle，并向测试人员分发了一个版本。

后续步骤

• 如需详细了解如何管理版本的测试人员，请参阅 App Distribution 文档。
• 如需了解可用于部署应用的其他工具，请参阅构建和测试 Android App Bundle。