Google 致力于为黑人社区推动种族平等。查看具体举措

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

图像10.png

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

你会学到什么

  • 如何将您的 Firebase 项目连接到您的 Google Play 帐户
  • 如何在 Firebase 和 Google Play 之间关联应用
  • 如何将您的应用程序打包并构建为应用程序包
  • 如何创建发布并与实时测试人员共享
  • 作为测试人员如何下载和测试新版本

你需要什么

  • 安卓工作室 v4.0+
  • 您从 Android Studio 生成的签名包文件
  • 您是管理员或所有者的 Google Play 帐户
  • 您的 Google Play 开发者帐户中已发布到内部、封闭、生产或开放测试轨道的应用
  • 您可以用作测试人员以接收来自 Firebase 的新构建邀请的电子邮件地址
  1. 登录火力地堡
  2. 在火力地堡控制台中,单击添加项目,然后将项目命名为“AppBundlesCodelab。”记住您的 Firebase 项目的项目 ID。如果您不修改项目 ID,Firebase 会自动为您的项目分配一个唯一 ID。

图像8.png

  1. 出现提示时,启用 Google Analytics。
  2. 完成其余的步骤,然后单击创建项目

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

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

图像5.png

  1. 注册您的应用程序时,请确保使用与上传到您的 Google Play 开发者帐户的应用程序相同的程序包名称。最后,点击注册应用
  2. 完成剩余步骤,将增加google-services.json文件和火力地堡SDK应用程式。
  3. 点击继续安慰

连接到 Google Play 和 Google Analytics

  1. 导航到您的项目设置

图像2.png

  1. 集成选项卡,点击谷歌播放的集成连接
  2. 最后,点击下发行和显示器部分应用程序分配。然后,点击开始使用

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

添加 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
    

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

  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
    

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

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

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

图片6.png

  1. 使用您的 Google 帐户登录并接受测试分布式版本的邀请。作为一个选项,你还可以下载应用程序火力地堡测试仪,防止下载的版本中被添加到您的设备Downloads文件夹中。它还显示有关发布的其他信息,例如下载进度和发布版本。

图像9.png

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

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

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

下一步