使用 Firebase 控制台将 Android 应用分发给测试人员

APK AAB

本指南介绍如何使用 Firebase 控制台将 Android App Bundle (AAB) 文件上传到 App Distribution 以及分发所生成的 APK。

App Distribution 与 Google Play 的内部应用分享服务相集成，可处理您上传的 AAB 文件，并提供专门根据您的测试人员设备配置而优化的 APK。通过分发 AAB 文件，您可以实现以下目标：

• 运行专门根据您的测试人员设备而优化的 APK（由 Google Play 提供）。

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

• 测试 App Bundle 功能，例如 Play Feature Delivery 和 Play Asset Delivery。

• 减少测试人员下载文件的大小。

所需权限

如需将 AAB 文件上传到 App Distribution，您必须将您的 Firebase 应用与 Google Play 中的应用相关联。您必须拥有所需的访问权限级别才能执行这些操作。

如果您没有必需的 Firebase 访问权限，可以请求 Firebase Project Owner 通过 Firebase 控制台 IAM 设置为您分配合适的角色。如果您对访问 Firebase 项目（包括查找或分配 Owner）有疑问，请查看“权限设置和 Firebase 项目访问权限”常见问题解答。

下表适用于将 Firebase 应用与 Google Play 中的应用相关联以及上传 AAB 文件这两个场景。

注意：如果您的 Firebase 应用已与 Google Play 中的某个应用相关联，那么即使您没有本部分列出的 Google Play 访问权限，也仍然可以上传 AAB 文件。

Firebase 控制台中的操作	所需的 IAM 权限	默认包含所需权限的 IAM 角色	其他必需的角色
将 Firebase 应用与 Google Play 中的应用相关联	firebase.playLinks.update	拥有下列任一角色： Owner Firebase Admin	以管理员身份访问 Google Play 开发者账号
将 AAB 文件上传到 App Distribution	firebaseappdistro.releases.update	拥有下列任一角色： Owner Editor Firebase Admin Firebase Quality Admin Firebase App Distribution Admin	––

准备工作

1. 将 Firebase 添加到您的 Android 项目（如果尚未添加）。在此工作流结束时，您的 Firebase 项目中就有了一个 Firebase Android 应用。

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

   注意：向 Firebase 注册应用时，请输入与您要分发的应用相同的软件包名称。软件包名称值区分大小写。当您向 Firebase 项目注册您的应用后，便无法在 Firebase 中更改该值。

2. 如需创建关联到 Google Play 的 Firebase 链接并上传 AAB 文件，请确保您的应用满足以下要求：

   • Google Play 中的应用和 Firebase Android 应用均使用同一软件包名称进行注册。

     注意：您可以为与正式版应用有不同软件包名称的应用上传 AAB 文件。只需在 Google Play 中新建一个应用，并将其分发到任何轨道（您无需选择正式版轨道）。然后，Google Play 会使用 AAB 文件中的软件包名称注册该 Google Play 应用。

   • Google Play 中的应用在应用信息中心内设置，并发布到某个 Google Play 轨道（内部测试、封闭式测试、开放式测试或正式版）。

   • 该应用在 Google Play 中的审核已完成，且已发布。 如果“应用状态”列显示以下状态之一，表明您的应用已发布：内部测试（非草稿内部测试）、封闭式测试、开放式测试或正式版。

3. 将您的 Firebase Android 应用关联至您的 Google Play 开发者账号：

   1. 在 Firebase 控制台中，转到您的项目设置，然后选择“集成”标签页。

   2. 在“Google Play”卡片中，点击关联。
      如果您已有指向 Google Play 的链接，请改为点击管理。

   3. 按照屏幕上的说明启用 App Distribution 集成，并选择要与 Google Play 关联的 Firebase Android 应用。

   详细了解如何关联到 Google Play。

第 1 步：构建您的应用

当您准备好将应用的预发布版本分发给测试人员时，请构建 AAB 文件（如需查看相关说明，请访问 Android Studio 文档）。

注意：Google Play 会自动使用测试应用签名密钥证书为所生成的 APK 重新签名。当系统提示时，如果您要继续使用 API 提供商的第三方服务，则必须向其注册您的应用。签名后，您可以在 Firebase 控制台中查看您的应用的测试证书。

第 2 步：将您的应用分发给测试人员

如需将您的应用分发给测试人员，请使用 Firebase 控制台上传您的 AAB 文件，具体操作方法如下：

1. 打开 Firebase 控制台的“App Distribution”页面。出现提示时，选择您的 Firebase 项目。

2. 在版本页面上，从下拉菜单中选择您要分发的应用。

3. 将应用的 AAB 文件拖到控制台中以便上传。

4. 上传完成后，指定要接收此 build 的测试人员群组和各个测试人员。然后，为该 build 添加版本说明。

   如需了解如何创建测试人员群组，请参阅管理测试人员。

5. 点击分发以将 build 提供给测试人员。 测试人员会自动收到测试应用邀请电子邮件。

6. （可选）如需与有权访问这些版本的测试人员共享特定版本的链接，请点击链接图标以将版本链接复制到剪贴板。

当您分发 build 后，在 150 天（5 个月）内均可在 Firebase 控制台的 App Distribution 信息中心中访问它。当该 build 距离过期还有 30 天的时候，Firebase 控制台中和测试人员的测试设备上的 build 列表中都会显示到期通知。

之前未受邀测试应用的测试人员会收到邀请其开始测试的电子邮件，而现有测试人员将收到有关新 build 已可供测试的电子邮件通知。如需了解如何安装测试应用，请参阅 App Distribution 测试人员设置指南。您可以在 Firebase 控制台中监控每个测试人员的状态：他们是否接受了邀请以及是否下载了应用。

在邀请到期前，测试人员有 30 天的时间来接受测试应用的邀请。 当邀请距离到期还有 5 天的时候，Firebase 控制台会在相应版本的测试人员旁边显示到期通知。您可以使用测试人员对应行中的下拉菜单重发邀请来重新开始邀请测试人员。

后续步骤

• 实现应用内反馈，以便测试人员轻松发送有关应用的反馈（包括屏幕截图）。

• 了解如何在有新的应用 build 可供安装时向测试人员显示相应的应用内提醒。

• 了解使用 CI/CD 将 Android 应用分发给质量检查测试人员的最佳实践。