注册其他 iOS 设备

如果您想使用 App Distribution 分发临时 iOS build,您必须按照本指南中的说明注册测试人员的设备。临时 build 是指没有使用企业配置文件签名的 build。只有当设备的唯一设备标识符 (UDID) 包含在临时 build 的预配配置文件中时,设备才能安装该临时 build。

在测试人员接受您的测试应用邀请之后,App Distribution 会请求相应的权限,以便与您(即开发者)共享测试人员的设备标识符。在下载临时 build 之前,App Distribution 会要求测试人员注册其设备。如果测试人员注册其设备,App Distribution 会收集该设备的 UDID,并通过电子邮件将该 UDID 发送给您。

当您收到包含 UDID 的电子邮件后,请使用该 UDID 更新您的预配配置文件,并将新的 build 分发给测试人员。您可以使用 Firebase 控制台或 Firebase CLI 手动导出 UDID,也可以使用 fastlane 以编程方式导出 UDID。

手动导出 UDID

  1. 将相应设备添加到 Apple Developer 门户。
    • 方案 1:以 CSV 文件形式导入设备 UDID。

      App Distribution 信息中心的测试人员和群组标签页中,选择所有测试人员,然后点击导出 Apple UDID 来下载 CSV 文件。接下来,使用注册多台设备选项将文件导入 Apple 开发者账号。如需了解详情,请参阅将应用分发到已注册的设备

      请注意,您的 Apple 开发者账号可能每年只允许您导入一定数量的设备。

    • 选项 2 :收集 UDID 并通过电子邮件发送。

      在 Apple Developer 门户的 Add Devices 页面中,注册您收到的电子邮件中指定的新 UDID。

  2. 将已注册的设备添加到您的预配配置文件
  3. 下载预配配置文件并使用它来重新构建您的应用。如果您重新构建的目的只是为了更新已注册的设备,请勿更新 build 号或版本。
  4. 通过 Firebase 控制台CLI 重新分发您的应用。如果您不更改版本、build 号或应用代码,App Distribution 将不会创建新版本,也不会通知测试人员。如果您已分发了具有相同 build 号和版本的 build,则只有新注册设备的用户才会收到电子邮件通知。

使用 Fastlane 以编程方式导出 UDID

  1. 使用 Fastlane 将所有测试人员设备 UDID 导出到一个 CSV 文件中。例如,创建并运行新的 download_udids 通道:

    lane :download_udids do
        firebase_app_distribution_get_udids(
            app: "<your Firebase app ID>",
            output_file: "<path to output file>",
        )
    end
    
  2. 使用注册多台设备选项将 UDID 导入您的 Apple 开发者账号。如需了解详情,请参阅 Apple 的文档。请注意,您的 Apple 开发者账号可能每年只允许您导入一定数量的设备。

  3. 将已注册的设备添加到您的预配配置文件

  4. 下载预配配置文件并使用它来重新构建您的应用。如果您重新构建的目的只是为了更新已注册的设备,请勿更新 build 号或版本。

  5. 重新分发您的应用。如果您不更改版本、build 号或应用代码,App Distribution 将不会创建新版本,也不会通知测试人员。如果您已分发了具有相同 build 号和版本的 build,则只有新注册设备的用户才会收到电子邮件通知。

接收提醒

接收默认提醒

默认情况下,Firebase 可以在有用户注册新的 iOS 设备时通过电子邮件发送 App Distribution 提醒。

如需通过此默认机制接收 App Distribution 提醒,您必须拥有 firebase.projects.update 权限。以下角色默认包含这项必需权限:Firebase Admin,或者项目的 Owner 或 Editor

默认情况下,拥有接收提醒所需权限的每个项目成员都将在有用户注册新的 iOS 设备时收到电子邮件通知。

为自己的账号开启/关闭提醒

对于您自己的账号,您可以开启/关闭 App Distribution 提醒,而不会影响项目的其他成员。请注意,您仍需要拥有接收提醒所需的权限。

如需开启或关闭 App Distribution 提醒,请按以下步骤操作:

  1. Firebase 控制台的右上角,前往“Firebase 提醒”
  2. 然后,前往“设置”,为 App Distribution 提醒设定您的账号偏好设置。

设置发送到第三方服务的高级提醒

您还可以使用 Cloud Functions for FirebaseApp Distribution 提醒发送到团队的首选通知渠道。例如,您可以编写一个函数,在有用户注册新的 iOS 设备时捕获一个提醒事件,并将提醒信息发布到第三方服务(如 Discord、Slack 或 Jira)。

为了能够为新加入的 iOS 测试人员自动完成初始配置,您可以编写一个函数,将新 iOS 设备的 UDID 添加到应用的预配配置文件中,然后使用更新后的预配配置文件重新构建应用并重新分发应用。

如需使用 Cloud Functions for Firebase 设置高级提醒功能,请按以下步骤操作:

  1. 设置 Cloud Functions for Firebase,您需完成以下任务:

    1. 为 Node.js 或 Python 设置开发环境。
    2. 安装并登录 Firebase CLI。
    3. 使用 Firebase CLI 初始化 Cloud Functions for Firebase
  2. 编写并部署一个函数,该函数会从 App Distribution 捕获提醒事件并处理事件载荷(例如,在 Discord 上的消息中发布提醒信息)。

如需了解您可以捕获的所有提醒事件,请参阅 App Distribution 提醒的参考文档。

后续步骤