本指南介绍了如何使用 Firebase CLI 将 APK 分发给测试人员。 CLI 工具允许您为构建指定测试人员和发行说明,然后相应地分发构建。
在你开始之前
如果您还没有,请将 Firebase 添加到您的 Android 项目中。
如果您不使用任何其他 Firebase 产品,则只需创建一个项目并注册您的应用程序。但是,如果您决定将来使用其他产品,请务必完成上面链接页面上的所有步骤。
第 1 步。构建您的应用程序
当您准备好向测试人员分发应用的预发布版本时,请使用正常流程构建您的 APK。您必须使用调试密钥或应用签名密钥对 APK 进行签名。
第 2 步:将您的应用分发给测试人员
要将您的应用分发给测试人员,请使用 Firebase CLI 上传您的应用文件:
- 安装或更新到最新版本的Firebase CLI (我们建议下载适用于您操作系统的 CLI 的独立二进制文件)。确保登录并测试您是否可以访问您的项目。
- 在 Firebase 控制台的App Distribution 页面中,选择您要分发的应用,然后点击Get started 。
运行
appdistribution:distribute
命令以上传您的应用程序并将其分发给测试人员。使用以下参数配置分发:应用程序分发:分发选项 --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.apk \ --app 1:1234567890:android:0a1b2c3d4e5f67890 \ --release-notes "Bug fixes and improvements" --testers-file testers.txt
Firebase CLI 在发布上传后输出以下链接。这些链接可帮助您管理二进制文件并确保测试人员和其他开发人员拥有正确的版本:
-
firebase_console_uri
- 指向显示单个版本的 Firebase 控制台的链接。您可以与您组织中的其他开发人员共享此链接。 -
testing_uri
- 测试人员体验(Android 本机应用程序)中发布的链接,让测试人员可以查看发布说明并将应用程序安装到他们的设备上。测试人员需要访问版本才能使用该链接。 -
binary_download_uri
- 直接下载和安装应用程序二进制文件(APK 或 AAB 文件)的签名链接。该链接将在一小时后过期。
除了分发版本,您还可以使用
appdistribution:testers:add
和appdistribution: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 测试人员的最佳实践。