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

您可以使用 Firebase CLI 将构建版本分发给测试人员。借助此 CLI 工具,您可以为构建版本指定测试人员和版本说明,并相应地分发该构建版本。

准备工作

将 Firebase 添加到您的 Android 项目(如果尚未添加)。

如果您没有使用任何其他 Firebase 产品,只需创建一个项目并注册应用。但是,如果您决定以后使用其他产品,请务必完成上述链接页面上的所有步骤。

第 1 步:构建您的应用

当您准备好将应用的预发布版本分发给测试人员时,应按照常规流程构建一个 APK。您必须使用调试密钥或应用签名密钥对 APK 进行签名。

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

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

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

    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
    

在您分发构建版本后,即可在 150 天(5 个月)内在 Firebase 控制台的“应用分发”信息中心中访问该构建版本。当该版本距离过期还有 30 天的时候,在控制台和测试人员的测试设备上的构建版本列表中都会显示到期通知。

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