应用分发问题排查

iOS Android

本页面提供了问题排查帮助，并解答了有关使用应用分发功能分发和测试应用的常见问题。

安装和测试应用

以下提示有助于测试人员排查有关在设备上安装和访问测试应用的问题。

Google 帐号无权访问测试应用

如果您的 Google 帐号无法访问您之前安装（或受邀安装）的测试应用，那么很可能是您登录了错误的 Google 帐号。您具有权访问的应用与您首次受邀测试应用时所用的 Google 帐号相关联。请使用先前用来接受邀请的 Google 帐号登录，然后重试。

请注意以下几点：

• 您用来接受邀请的 Google 帐号可能不是该邀请最初发送到的 Google 帐号。
• Google 帐号可以与任何电子邮件地址相关联，而不仅仅是 Gmail 或 G Suite 网域中的地址。了解如何使用其他电子邮件地址登录。

尝试运行测试应用时出现“不受信任的企业开发者”错误

如果您在打开应用之前未信任测试设备上的开发者证书，则系统会显示不受信任的企业开发者错误。在设置应用 > 配置文件和设备管理屏幕中，选择该应用的开发者名称并信任该开发者。

“正在等待开发者”消息阻止安装测试应用

您安装临时版时，如果开发者尚未将其应用配置为在测试设备上运行，系统会显示正在等待开发者按钮。如需使其应用可供您使用，开发者必须完成以下步骤：

1. 在 Apple Developer 门户中添加测试设备的 UDID（在您向 Firebase 注册设备时，系统会通过电子邮件将 UDID 发送给开发者）。

2. 将设备添加到应用的预配配置文件中。

3. 使用更新后的预配配置文件构建应用。

4. 使用 Firebase 控制台、CLI 或 Fastlane 分发新版本。

使用 App Distribution SDK 启用应用内提醒

以下提示有助于您和测试人员排查使用 App Distribution SDK 启用应用内新构建版本提醒的问题。

测试人员收不到应用内提醒

如果您已在应用中设置了 App Distribution SDK，但测试人员收不到应用内提醒，请检查您的应用是否提取了新的版本：

1. 在您的应用中启用调试模式（请参阅 Google Analytics（分析）文档以了解具体操作方法），然后在模拟器中运行您的应用，并搜索字符串“[Firebase/AppDistribution]”。

2. 检查您是否提取到了应用版本：

   • 如果返回了有效的版本对象，那么可能是视图控制器生命周期中存在问题，导致提醒对话框在视图显示之前加载。请注意，App Distribution SDK 默认不显示提醒对话框；您必须指定此对话框在应用中的显示方式和显示位置（如需查看示例，请参阅基本提醒配置）。

   • 如果没有返回任何版本，则表示您的测试人员可能尚未关联至新版本。在 Firebase 控制台的“应用分发”信息中心内，确保您的构建版本的分发中包含该测试人员，并且该测试人员处于已接受状态。

     如果照此设置后，您的测试人员仍然没有收到提醒，请让其按照以下提示操作，确保其已接受您的应用测试邀请，并且正确设置了测试设备：

     • 在测试设备上登录 Firebase App Distribution Web Clip（切记，请选择您最初在接受应用测试邀请时使用的 Google 帐号）。

     • 检查以确保 Web Clip 中包含最新应用版本。

测试人员在关闭应用后收到再次登录的提醒

默认情况下，您的测试人员只需登录其 Google 帐号一次，即可启用新构建版本提醒以及安装新构建版本。如果在关闭并重新打开应用后，系统提示您的测试人员再次登录，请按照以下提示操作，以确保正确设置 App Distribution 的配置：

• 确认您是否已启用 App Distribution Tester API（请参阅 App Distribution SDK 指南中的说明）。

• 在 Google Cloud Platform Console 的密钥限制下，确保您使用的不是受限的 API 密钥。

• 如果您经常在退出时清除 UserDefaults，那么可能是您清除了测试人员的状态。应用分发会存储一个标记，指示测试人员是否已登录应用（如需了解详情，请参阅我们的 GitHub 代码库）。

常见问题解答

向我的应用添加测试人员时是否会受到限制？

Firebase 应用分发具有以下测试人员限制：

• 一个 Firebase 项目最多可添加 500 名测试人员

• 一个应用分发组最多可添加 200 名测试人员

• 每个发行版最多可添加 200 名测试人员

如需添加更多测试人员，请申请免费提高限额。

我的应用构建会过期吗？

当您将应用的构建上传到 Firebase 后，即可在（Firebase 控制台的）“App Distribution”信息中心中访问该构建，其有效期为上传之日起 150 天（五个月）。随后，您可以将该构建分发给测试人员，以便他们在测试设备上使用 Firebase 应用分发 Web Clip 进行安装。为了提醒您和您的测试人员，系统会在自过期之日起 30 天后显示该构建的过期通知。

150 天的期限过后，该构建将过期，并会从“应用分发”信息中心和 Firebase 应用分发 Web Clip 中移除。如果您的测试人员已经安装了该构建，则您应用的本地版本将继续运行。

如果您希望延长构建的有效期，我们建议您采用以下解决方案：

• 在构建过期之前，请下载 IPA，然后从 App Distribution 信息中心删除相应构建。然后，将 IPA 重新上传到 Firebase App Distribution（作为新构建版本）。

• 下载该构建并将其上传到 Cloud Storage for Firebase 进行长期归档。

什么是 Firebase 配置文件？

Firebase 配置文件使您可以通过应用分发功能执行以下操作：

• 通过收集设备的唯一设备 ID (UDID) 来注册测试设备。如果您要测试临时版，Firebase 会向应用开发者发送一封电子邮件，其中包含测试设备的 UDID，以及有关如何在应用的预配配置文件中添加该设备的说明，以便可以在您的设备上测试版本。

• 在设备的主屏幕上安装 Firebase 应用分发 Web Clip。通过 Web Clip，您可以在一个位置安装和访问所有测试应用。您受邀测试的新版本会自动添加到 Web Clip 中。

如需有关在 iOS 设备上安装配置文件的帮助，请参阅 Apple 的文档。

如何访问我在设备上安装的测试应用？

如果您是测试人员，则可以通过安装 Firebase 配置文件时自动添加到测试设备主屏幕的 Firebase App Distribution Web Clip 访问所有测试应用。如果您要测试临时版，则必须先安装配置文件，然后才能测试应用。

如果您要测试企业版，可以手动安装配置文件：

1. 如果您尚未登录，请登录 Google 并接受邀请。

2. 在测试应用下，选择您要测试的应用。

3. 在应用页面的右上角，点按 。

4. 按照显示的说明安装 Firebase 配置文件。

如何删除测试人员帐号？

如需删除您的 App Distribution 测试人员帐号及其相关数据，请按顺序执行以下步骤：

1. 访问 https://appdistribution.firebase.google.com 并使用您的 Google 帐号登录。

2. 点击右上角的 （管理帐号）

   删除帐号。

3. 可选：在 Google 帐号权限中，针对 Firebase App Distribution 撤消帐号的访问权限。请注意，如果在未先删除 App Distribution 帐号的情况下撤消访问权限，就不会删除您的测试人员帐号或数据。