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

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

准备工作

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

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

第 1 步:构建您的应用

准备好将应用的预发布版本分发给测试人员之后,请构建一个已签名的分发归档。要使用常规构建过程,您必须满足以下要求:

  • 要在开发团队之外分发应用,您必须使用临时或企业分发配置文件。
  • 如果应用使用的是 Game Center、APN(并扩展到 Cloud Messaging)或 iCloud,请确保您的预配配置文件使用明确的应用 ID,而不是通配符 ID。
  • 如果使用临时分发配置文件,请添加测试人员设备的唯一设备 ID(即 UDID)。当有新的 iOS 测试人员加入您的测试计划时,您需要更新预配配置文件,在其中添加他们的设备 UDID。请参阅注册其他测试人员设备
  • 如果您在上次构建之后更改了代码(具体来说,您重新构建的目的不仅仅是为了更新已注册的设备),请更新构建目标的用户可见版本号(版本)和唯一构建版本号(构建)。

构建完成后,它会将一个 IPA 文件和一些日志文件保存在您指定的文件夹中。请按照以下步骤将 IPA 文件分发给测试人员。

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

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

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

    appdistribution:distribute 选项
    --app

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

    
    --app 1:1234567890:ios: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.ipa  \
        --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

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

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

第 3 步:注册其他测试人员设备

当测试人员接受邀请来测试尚未使用企业配置文件签名的构建版本时,系统会询问他们是否同意将其设备的 UDID 提供给您。如果他们同意,“应用分发”将收集该设备的 UDID,并通过电子邮件将新分享的 UDID 发送给您。

当您收到这样的电子邮件时,请使用该 UDID 更新您的预配配置文件,然后按照以下步骤将新的构建版本分发给测试人员:

  1. 在 Apple Developer 门户的 Add Devices 页面中,注册您收到的电子邮件中指定的新 UDID。
  2. iOS 预配配置文件页面中,将注册的设备添加到您的预配配置文件中。
  3. 下载预配配置文件并使用它来重新构建您的应用。如果您重新构建的目的只是为了更新已注册的设备,请勿更新构建版本号或版本。
  4. 通过 Firebase 控制台或 CLI 重新分发您的应用。如果您已经分发了具有同一构建版本号和版本的构建,则只有新注册设备的用户才会收到电子邮件通知。