使用 Firebase App Distribution Android SDK 提醒测试人员您的新应用发布 - Codelab

一、概述

欢迎来到在您的 Android 应用代码实验室中集成 Firebase 应用分发 SDK。在此 Codelab 中，您将 App Distribution Android SDK 添加到您的应用，以便在新版本可供下载时向您的测试人员显示应用内提醒。您将了解如何使用基本配置和自定义配置让您的测试人员登录以接收更新。然后，您将向 App Distribution 推送新版本并在应用程序中触发新构建警报。

你会学到什么

• 如何使用 App Distribution 将预发布应用分发给测试人员
• 如何将 App Distribution Android SDK 集成到您的应用中
• 当有新的预发布版本准备安装时如何提醒测试人员
• 如何自定义 SDK 以满足您的测试需求

你需要什么

• 最新的Android Studio版本。
• 示例代码。
• 具有 Android 4.4+ 和 Google Play 服务 9.8 或更高版本的测试设备，或者具有 Google Play 服务 9.8 或更高版本的模拟器。
• 如果使用设备，连接电缆。

您将如何使用本教程？

只通读一遍阅读并完成练习

您如何评价您构建 Android 应用程序的体验？

新手中间的精通

2.获取示例代码

从命令行克隆 GitHub 存储库。

$ git clone https://github.com/FirebaseExtended/codelab-appdistribution-android.git

如果您没有安装 git，您还可以从其 GitHub 页面或单击此链接下载示例项目。

“codelab-appdistribution-android”存储库包含两个文件夹：

• start — 您将在此 Codelab 中构建的起始代码。
• final — 完成的示例应用程序的完整代码。

3. 导入入门应用

在 Android Studio 中，选择codelab-appdistribution-android/start目录 ( ) 从示例代码下载（文件>打开> .../codelab-appdistribution-android/start）。

您现在应该在 Android Studio 中打开了启动项目。

4.创建一个Firebase控制台项目

添加一个新的 Firebase 项目

1. 打开Firebase 控制台。
2. 选择添加项目，然后将您的项目命名为“Firebase Codelab”。

您不需要为此项目启用 Google Analytics。

3. 单击创建项目。

将应用程序添加到 Firebase

向 Firebase 注册您的应用程序。使用“com.google.firebase.appdistributioncodelab”作为包名。

将 google-services.json 文件添加到您的应用

添加包名称并选择注册后，按照以下步骤将 google-services.json 添加到您的应用程序：

1. 单击下载 google-services.json以获取您的 Firebase Android 配置文件。
2. 将 google-services.json 文件复制到项目的app目录中。
3. 下载文件后，您可以跳过控制台中显示的后续步骤（它们已在 build-android-start 项目中为您完成）。

更新应用 ID 以匹配您的 Firebase 应用

1. 在左侧菜单（项目选项卡）中，确保您位于“Android”视图并找到“Gradle 脚本”选项卡并打开您的模块（应用程序级）Gradle 文件（通常是app/build.gradle.kts ）。
2. 更改applicationId属性以匹配您的 Firebase 应用程序的应用程序 ID。这应该是“com.google.firebase.appdistributioncodelab”

将您的项目与 Gradle 文件同步

为确保您的应用程序可以使用所有依赖项，请将您的项目与 Gradle 文件同步，从 Android Studio 工具栏中选择文件 > 将项目与 Gradle 文件同步。

5. 使用 App Distribution Android SDK 设置应用内新构建警报

在此步骤中，您会将 Firebase App Distribution Android SDK 添加到您的应用，并在您的应用的新版本可供安装时向您的测试人员显示应用内提醒。为此，请确保您已为“Firebase Codelab”项目（在 Google Cloud Console 中）启用Firebase App Testers API 。您需要使用相同的帐户登录并从顶部的下拉菜单中选择正确的项目。

配置应用内提醒

App Distribution Android SDK 提供了两种为测试人员设置应用内构建提醒的方法：

• 一个基本的警报配置，它带有一个预构建的对话框以显示给测试人员。
• 高级警报配置，可让您自定义用户界面 (UI)。

我们将从基本的警报配置开始。您可以使用updateIfNewReleaseAvailable向尚未启用警报的测试人员显示预构建的启用警报对话框，然后检查是否有新版本可用。测试人员通过登录有权访问 App Distribution 中的应用程序的帐户来启用警报。调用时，该方法执行以下序列：

1. 检查测试人员是否启用了警报。如果没有，该方法会显示一个预建对话框，提示测试人员使用他们的 Google 帐户登录 App Distribution。

启用警报是测试设备上的一次性过程，它会在您的应用更新期间持续存在。在卸载应用程序或调用signOutTester方法之前，警报在测试设备上保持启用状态。

2. 检查新的可用构建以供测试人员安装。
3. 显示预建警报，提示测试人员下载最新版本。
4. 在继续更新之前检查新的构建类型：
5. 如果新构建是 App Bundle (AAB)，则将测试人员重定向到 Play Store 以完成更新过程。
6. 如果新构建是 APK，SDK 会在后台下载新构建，并在下载完成时提示测试人员安装新构建。 SDK 使用NotificationManager.您可以通过将onProgressUpdate处理程序附加到updateIfNewReleaseAvailable任务来添加自己的进度指示器。

您可以在应用中的任何位置调用updateIfNewReleaseAvailable() 。例如，您可以在 MainActivity 的onResume()方法期间调用updateIfNewReleaseAvailable() ：

打开MainActivity.kt ，并像这样创建onResume()方法：

主活动.kt

override fun onResume() {
    super.onResume()
    checkForUpdate()
}

现在让我们实现checkForUpdate()方法。

主活动.kt

   private fun checkForUpdate() {
        firebaseAppDistribution.updateIfNewReleaseAvailable()
            .addOnProgressListener { updateProgress ->
                // (Optional) Implement custom progress updates in addition to
                // automatic NotificationManager updates.
            }
            .addOnFailureListener { e ->
                if (e is FirebaseAppDistributionException) {
                    // Handle exception.
                }
            }
    }

6. 构建并邀请测试人员下载您的应用

在此步骤中，您将构建您的应用程序并通过使用 Firebase 控制台将构建分发给测试人员来测试您的实现。

构建您的应用

当您准备好向测试人员分发应用的预发布版本时，请使用正常流程构建您的 APK。您必须使用调试密钥或应用签名密钥对 APK 进行签名。

将您的应用分发给测试人员

要将您的应用分发给测试人员，请使用 Firebase 控制台上传 APK 文件：

1. 打开 Firebase 控制台的App Distribution 页面。出现提示时选择您的 Firebase 项目。
2. 在发布页面上，从下拉菜单中选择要分发的应用程序。

3. 点击开始

4. 将应用程序的 APK 文件拖到控制台以上传它。
5. 上传完成后，指定要接收构建的测试人员组和个人测试人员。 （添加您的电子邮件以接收邀请。）然后，为构建添加发行说明。要了解有关创建测试人员组的更多信息，请参阅添加和删除测试人员。

6. 单击分发以使构建对测试人员可用。

注意：分发构建后，它会在 Firebase 控制台的 App Distribution 仪表板中可用 150 天。当构建距离到期还有 30 天时，控制台和测试人员在其测试设备上的构建列表中都会显示到期通知。

未受邀测试应用程序的测试人员会收到电子邮件邀请以开始测试。活跃的测试人员会收到新版本已准备好进行测试的电子邮件通知。有关如何安装测试应用程序的说明，请参阅设置为测试人员。您可以在 Firebase 控制台中监控每个测试人员的状态，无论他们是否接受了邀请并下载了应用程序。

在 Firebase 控制台中，您现在可以看到您在应用版本下添加的测试人员。

由于您提供了电子邮件地址，因此您会收到一封来自 Firebase App Distribution 的电子邮件，邀请您测试该应用程序。你现在是第一个测试者！按照接受邀请中的说明在您的测试设备上设置为测试人员。

接受邀请

您需要先接受下载和测试版本的邀请。

1. 在您的 Android 测试设备上，打开从 Firebase App Distribution 发送的电子邮件，然后点击Get Started 。
2. 在出现的Firebase App Distribution测试器网络应用程序中，使用您的 Google 帐户登录并点击接受邀请。您现在可以看到受邀测试的版本。

从测试设备下载版本

当您导航到 AppDistribution Codelab 应用程序时，您可以看到该版本已准备好下载。

1. 点击下载，然后安装并运行该应用程序！
2. 当应用程序启动时，它会要求您启用新构建警报。点击打开。

3. 使用您的测试员帐户登录..

您将返回到应用程序。下次运行该应用程序时，您无需登录或接受提醒

向您的测试人员分发更新

1. 在模块（应用程序级）Gradle 文件（通常是 app/build.gradle）中将版本名称更新为“1.1”，将版本代码更新为 2。
2. 使用正常流程构建您的 APK。您必须使用调试密钥或应用签名密钥对 APK 进行签名。
3. 在您的 Firebase 控制台中上传这个新的 APK，再次将您的电子邮件添加为测试人员，然后点击Distribute 。

测试构建警报

1. 如果应用程序处于打开状态，请确保关闭它。
2. 重新启动应用程序。
3. 当应用程序重新启动时，您会收到新版本可用警报。

4. 要接收最新版本，请单击更新。
5. 如果出现提示，请选择启用未知来源安装的选项。
6. 在下一个屏幕上单击安装（或更新）。

7. 恭喜！您可以使用内置警报更新您的应用程序。

7.自定义测试人员登录

signInTester/signOutTester和isTesterSignedIn方法让您可以更灵活地自定义测试人员的登录体验，因此它可以更好地匹配您的应用程序的外观和感觉。

以下示例检查测试人员是否已登录其 Firebase App Distribution 测试人员帐户，因此您可以选择仅对尚未登录的测试人员显示您的登录 UI。测试人员登录后，您可以随后调用checkForUpdate以检查测试人员是否有权访问新构建。

让我们通过注释掉checkForUpdate()调用来禁用在onResume中自动检查更新。

主活动.kt

override fun onResume() {
        super.onResume()
        //checkForupdate()
    }

相反， checkForUpdate()已添加到更新按钮的 OnClickListener 中。

现在，让我们实现我们的signIn()方法，如果用户已注销，它将登录用户，如果用户已经登录，则将用户注销。

主活动.kt

    private fun signIn() {
        if (isTesterSignedIn()) {
            firebaseAppDistribution.signOutTester()
            configureUpdateButton()
            configureSigninButton()
        } else {
            firebaseAppDistribution.signInTester()
        }
    }

最后让我们实现isTesterSignedIn方法。

主活动.kt

    private fun isTesterSignedIn() : Boolean {
        return firebaseAppDistribution.isTesterSignedIn
    }

构建并测试您的实施

8. 恭喜！

您已使用 Firebase App Distribution Android SDK 将“应用内提醒显示”功能构建到应用中。

我们涵盖的内容

• Firebase 应用分发
• Firebase 应用分发新警报 Android SDK

下一步

• 使用快车道插件
• 使用 CLI 工具
• 使用渐变

了解更多

• Firebase.google.com

有一个问题？

• Stackoverflow 'firebase-app-distribution '
• Firebase 社区松弛频道#app-distribution

报告问题

• Github 问题