获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

使用 Firebase CLI 将 Android 应用分发给测试人员

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本指南介绍了如何使用 Firebase CLI 将 Android App Bundle (AAB) 分发给测试人员。 CLI 工具允许您为构建指定测试人员和发行说明,然后相应地分发构建。

App Distribution 与 Google Play 的内部应用共享服务集成,以处理您上传的 AAB 并提供针对测试人员的设备配置进行了优化的 APK。分发 AAB 可让您执行以下操作:

  • 运行针对测试人员的设备进行了优化的优化 APK(由 Google Play 提供)。

  • 发现和调试特定于设备的问题。

  • 测试应用程序包功能,例如Play Feature DeliveryPlay Asset Delivery

  • 减少测试人员的下载量。

所需权限

要将 AAB 上传到 App Distribution,您必须将 Firebase 应用链接到 Google Play 中的应用。您必须具有执行这些操作所需的访问级别。

如果您没有必要的 Firebase 访问权限,您可以要求 Firebase 项目所有者通过Firebase 控制台 IAM 设置为您分配适用的角色。如果您对访问 Firebase 项目(包括查找或分配所有者)有任何疑问,请查看“对 Firebase 项目的权限和访问”常见问题解答

下表适用于将 Firebase 应用链接到 Google Play 中的应用,以及上传 AAB。

Firebase 控制台中的操作所需的 IAM 权限默认情况下包含所需权限的 IAM 角色其他必需的角色
将 Firebase 应用与 Google Play 中的应用相关联firebase.playLinks.update以下角色之一:管理员身份访问 Google Play 开发者帐户
将 AAB 上传到应用分发firebaseappdistro.releases.update以下角色之一:––

在你开始之前

  1. 如果您还没有,请将 Firebase 添加到您的 Android 项目中。在此工作流程结束时,您的 Firebase 项目中将拥有一个 Firebase Android 应用。

    如果您不使用任何其他 Firebase 产品,则只需创建一个项目并注册您的应用。如果您决定使用其他产品,请务必完成将 Firebase 添加到您的 Android 项目中的所有步骤。

  2. 要创建指向 Google Play 的 Firebase 链接并上传 AAB,请确保您的应用满足以下要求:

    • Google Play 中的应用和 Firebase Android 应用都使用相同的包名称注册。

    • Google Play 中的应用设置在应用仪表板上,并分发到 Google Play 轨道之一(内部测试、封闭测试、开放测试或生产)。

    • 该应用在 Google Play 中的审核已完成,该应用已发布。如果应用状态列显示以下状态之一,则您的应用已发布:内部测试(不是内部测试草案)、封闭测试、开放测试或生产。

  3. 将您的 Firebase Android 应用链接到您的 Google Play 开发者帐户:

    1. 在 Firebase 控制台中,转到您的 Project settings ,然后选择Integrations选项卡。

    2. Google Play卡上,点击链接
      如果您已有指向 Google Play 的链接,请改为单击“管理”。

    3. 按照屏幕上的说明启用 App Distribution 集成并选择要链接到 Google Play 的 Firebase Android 应用。

    了解有关链接到 Google Play 的更多信息。

第 1 步:构建您的应用

当您准备好将应用的预发布版本分发给测试人员时,请构建您的 AAB(有关说明,请访问Android Studio 文档)。

步骤 2. 将您的应用分发给测试人员

要将您的应用分发给测试人员,请使用 Firebase CLI 上传您的应用文件:

  1. 安装或更新到最新版本的Firebase CLI (我们建议下载特定于您的操作系统的 CLI 的独立二进制文件)。确保登录并测试您是否可以访问您的项目。
  2. 在 Firebase 控制台的App Distribution 页面中,选择您要分发的应用,然后点击Get started
  3. 运行appdistribution:distribute命令以上传您的应用并将其分发给测试人员。使用以下参数配置分布:

    appdistribution:分发选项
    --app

    必需:您的应用的 Firebase 应用 ID。您可以在 Firebase 控制台的“常规设置”页面上找到应用 ID。

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    使用 Firebase CLI 对 CI 环境进行身份验证时打印的刷新令牌(有关更多信息,请阅读将 CLI 与 CI 系统结合使用)。

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    此版本的发行说明。

    您可以直接指定发行说明:

    --release-notes "Text of release notes"

    或者,指定纯文本文件的路径:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    您要邀请的测试人员的电子邮件地址。

    您可以将测试人员指定为以逗号分隔的电子邮件地址列表:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    或者,您可以指定包含逗号分隔的电子邮件地址列表的纯文本文件的路径:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    您要邀请的测试人员组(请参阅管理测试人员)。组使用指定组别名,您可以在 Firebase 控制台中查找。

    您可以将组指定为逗号分隔的列表:

    --groups "qa-team, trusted-testers"

    或者,您可以指定包含逗号分隔的组名列表的纯文本文件的路径:

    --groups-file "/path/to/groups.txt"
    --debug

    您可以包含一个标志来打印详细的日志输出。

    例如:

    firebase appdistribution:distribute test.aab  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    除了分发版本之外,您还可以使用appdistribution:testers:addappdistribution:testers:remove来邀请新测试人员或从您的 Firebase 项目中删除现有测试人员。将测试人员添加到您的 Firebase 项目后,您可以将其添加到各个版本中。删除测试人员后,他们将无法再访问您项目中的版本。请注意,最近被移除的测试人员仍然可以在一段时间内保留对您的版本的访问权限。

    例如:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    测试人员的电子邮件必须用空格分隔。您还可以使用--file /path/to/testers.txt指定测试人员。

分发构建后,它会在 Firebase 控制台的 App Distribution 仪表板中可用 150 天(五个月)。当构建距离到期 30 天时,控制台和测试人员在其测试设备上的构建列表中都会显示到期通知。

未受邀测试应用程序的测试人员会收到电子邮件邀请以开始使用,现有测试人员会收到电子邮件通知,表明新版本已准备好进行测试(请阅读测试人员设置指南以获取有关如何安装测试应用程序的说明)。您可以在 Firebase 控制台中监控每个测试人员的状态——他们是否接受了邀请以及是否下载了应用程序。

测试人员有 30 天的时间在应用程序过期前接受测试邀请。当邀请距过期还有 5 天时,过期通知会出现在 Firebase 控制台中某个版本的测试人员旁边。可以通过使用测试人员行上的下拉菜单重新发送邀请来更新邀请。

下一步

了解使用 CI/CD 将 Android 应用程序分发给 QA 测试人员的最佳实践。