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

一、概述

image10.png

在此 Codelab 中,您将了解如何使用 Firebase App Distribution 及其 Gradle 插件将 Android App Bundle 版本分发给测试人员。 App Distribution 为您提供了一个中央枢纽,用于管理您的应用程序的预发布版本以及您邀请的每个版本的测试人员。

你会学到什么

  • 如何将您的 Firebase 应用链接到 Google Play
  • 如何将您的应用程序打包和构建为应用程序包
  • 如何创建发布并与现场测试人员共享
  • 作为测试人员如何下载和测试新版本

你需要什么

  • 安卓工作室 v4.0+
  • 您从 Android Studio 生成的签名包文件
  • 您是所有者或管理员的 Google Play 开发者帐号
  • 您在 Google Play 中的应用已在Google Play 应用控制面板上设置,并且具有以下状态
    • 该应用程序分发到 Google Play 轨道之一(内部测试、封闭式测试、开放式测试或生产)。
    • 该应用在 Google Play 中的审核已完成,该应用已发布。如果应用状态列显示以下状态之一,则您的应用已发布:内部测试(不是内部测试草案)、封闭测试、开放测试或生产。
  • 一个电子邮件地址,您可以用作测试人员来接收来自 Firebase 的新构建邀请

2. 创建一个 Firebase 项目

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

    image8.png
  3. (可选)出现提示时,启用 Google Analytics。
  4. 完成其余步骤,然后单击Create project

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

  1. 在 Firebase 控制台中,单击添加应用程序

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

    图像2.png
  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 ) 中,添加 App Distribution Gradle 插件和 Google 的 Maven 存储库。
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            jcenter()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  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`
    
    // ...
    
  3. 如果您使用公司代理或防火墙,请添加以下 Java 系统属性,使 App Distribution 能够将您的分配上传到 Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

验证您的 Firebase 项目

在您可以使用 Gradle 插件之前,您需要对您的 Firebase 项目进行身份验证。对于此 Codelab,您将使用插件的登录操作登录您的 Google 帐户。

  1. 在 Android 项目的根目录下运行以下命令:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. 当命令打印身份验证链接时,在浏览器中打开它。出现提示时,登录您的 Google 帐户并授予访问 Firebase 项目的权限。 Gradle 命令打印一个刷新令牌,App Distribution 插件使用该令牌向 Firebase 进行身份验证。
  3. 将环境变量FIREBASE_TOKEN设置为上一步中的令牌:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

4. 在 Android Studio 中配置你的 bundle 属性

在此步骤中,您将自己添加为稍后将分发的构建的测试人员。分发构建后,测试人员会收到来自 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. 构建和分发版本

  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
    

测试人员现在将收到电子邮件邀请以下载和测试构建。作为开发人员,您现在可以在 App Distribution 仪表板的Releases选项卡中监控构建。

6. 下载并测试您的版本

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

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

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

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

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

7. 恭喜!

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

下一步