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

1. 概述

图片10.png

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

你会学到什么

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

你需要什么

  • 安卓工作室 v4.0+
  • 您从 Android Studio 生成的签名包文件
  • 您是所有者或管理员的 Google Play 开发者帐户
  • 你在谷歌Play应用程式是在谷歌Play应用程式仪表盘安装,它具有以下状态
    • 该应用程序是在已发布的状态,这意味着它不是在草案和审查已完成(在谷歌的更新状态栏播放控制台为空)。
    • 该应用程序在以下 Google Play 轨道之一上分发:内部测试、封闭式、开放式测试或生产。
  • 您可以用作测试人员以接收来自 Firebase 的新构建邀请的电子邮件地址

2. 创建一个 Firebase 项目

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

    图像8.png
  3. (可选)当提示,使谷歌Analytics(分析)。
  4. 完成其余的步骤,然后单击创建项目

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

  1. 在火力地堡控制台中,单击添加应用程序

    图像5.png
  2. 当注册您的应用,确保使用相同的包名称作为影片上传到您的谷歌Play开发者帐户的应用程序。最后,点击注册应用
  3. 完成剩余的步骤,将您的应用程序的火力地堡配置文件(添加google-services.json )到您的应用程序。请注意,对于 Android,App Distribution 没有可添加到您的应用的 Firebase SDK。
  4. 点击继续安慰
  1. 在火力地堡控制台,转到您的项目设置

    图像2.png
  2. 集成选项卡,单击谷歌播放卡上的链接
  3. 按照屏幕上的说明启用 App Distribution 集成,然后选择您新创建的 Firebase 应用以链接到 Google Play。

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

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

添加 App Distribution Gradle 插件

现在,您将使用 Android Studio 将 App Distribution 及其 Gradle 插件作为 buildscript 依赖项添加到您的应用程序。

  1. 在项目级摇篮文件( android/build.gradle ),添加应用程序分发摇篮插件和谷歌的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. 在您的应用程序级的摇篮文件( android/app/build.gradle ),添加应用程序分发插件:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. 如果你落后企业的代理服务器或防火墙,添加以下Java系统属性,使应用程序分发到您的分发上传到火力地堡:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

验证您的 Firebase 项目

在您可以使用 Gradle 插件之前,您需要对您的 Firebase 项目进行身份验证。对于此代码实验室,您将使用插件的登录操作登录您的 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 中配置您的包属性

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

在您的app/build.gradle ,添加firebaseAppDistribution部分,包括以下参数:

  • appID :应用程式的火力地堡的App ID。您可以在找到常规选项卡项目设置
  • artifactType :您的应用程序的文件类型( AAB )。
  • testers :测试人员的电子邮件地址。对于此代码实验室,请添加您自己的电子邮件,以便您可以在发布后测试您的构建。

例如:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

作为一个选项,你也可以覆盖在你设定的值build.gradle通过将命令行参数的形式-PappDistribution- property-name = property-value

5. 构建和分发版本

  1. 运行bundle Variant摇篮任务来构建应用程序捆绑的文件:
    $ ./gradlew :base:bundleRelease
    
  2. 找到你的应用程序的构建目录捆(默认位置为app/build/outputs/bundle/release )。
  3. 要分发的发布,建立目标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 帐户登录并接受测试分布式版本的邀请。作为一个选项,你还可以下载应用程序火力地堡测试仪,防止下载的版本中被添加到您的设备Downloads文件夹中。它还显示有关发布的其他信息,例如下载进度和发布版本。

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

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

7. 恭喜!

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

下一步