App Distribution 问题排查及常见问题解答

iOS+ Android

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

分发应用

请按照以下提示排查在向测试人员分发应用时可能遇到的问题。

因缺少联系电子邮件地址而无法分发应用

上传应用时，您可能会遇到以下错误：

“我们找不到应用 <app-id> 的联系人电子邮件地址。请访问 Firebase 控制台中的 App Distribution，设置一个电子邮件地址。”

如果可以，请在 Firebase 控制台中设置联系人电子邮件地址。如果问题仍然存在，请与 Firebase 支持团队联系。

预配您的应用时出错（400、409 或 500 错误）

如果您在预配期间反复遇到错误 400、409 或 500，请与 Firebase 支持团队联系。请向支持团队提供您的 Firebase 项目编号和应用标识符。

无法上传 IPA

以下是浏览器网络响应的一个示例：

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

如需解决此问题，请按以下步骤操作：

1. 验证 IPA 的大小。所有二进制文件的大小上限为 2048 MiB，略高于 2 GB。

2. 如果 IPA 大小在文件大小上限内且错误可重现，请按以下步骤操作：

   1. 检查 Info.plist 文件并确认 CFBundleDisplayName 是否包含任何 <array> 分隔符。

      注意：App Distribution 不接受数组形式的 CFBundleDisplayName 值。

   2. 移除 <array> 分隔符并重新构建您的应用。上传应该会成功。

   3. 如果您仍然遇到问题，请与 Firebase 支持团队联系。

3. 如果 IPA 大小超过文件大小限制，请进行任何必要的更改以缩减文件大小。

4. 如果缩减 IPA 文件大小未能解决问题，请与 Firebase 支持团队联系，询问如何使用 Testflight。

安装和测试应用

请按照以下提示排查测试人员在安装和测试应用时可能会遇到的问题。

测试人员没有 Google 账号

用户创建 Google 账号后，便会自动收到 Gmail 地址。

如果测试人员没有 Google Workspace 或 Gmail 地址，或者他们更希望使用其他电子邮件地址登录，请让测试人员将非 Gmail 电子邮件地址与账号关联，并使用该电子邮件地址进行登录。

选择备用电子邮件地址时，测试人员必须遵循以下指南：

• 不使用 Gmail 地址。
• 请勿使用已与其他 Google 账号相关联的电子邮件地址。
• 在使用此电子邮件地址登录时，请务必使用您的 Google 账号密码。

如需了解详情，请参阅使用其他电子邮件地址登录您的 Google 账号。

测试人员看不到正确的应用或 build

如果测试人员接受邀请时使用的电子邮件地址不同于收到邀请的电子邮件地址，测试人员可能无法看到所需的应用或 build。

接收开发者发送的邀请和添加到新 build 的电子邮件地址（电子邮件 A）可能与测试人员用于接受邀请的电子邮件地址（电子邮件 B）不同。这种情况下，系统会在后台创建一个链接。每当电子邮件 A 添加到新 build 时，实际上是电子邮件 B 获得了访问权限。

如果测试人员使用其他电子邮件地址接受电子邮件邀请，请按照以下步骤解决此问题：

1. 从 Firebase 控制台的 App Distribution 页面中，从测试人员和群组标签页的查看所有测试人员部分中删除测试人员。现有邀请会被移除。

2. 重新邀请测试人员测试您的应用。测试人员应该会收到一封邀请电子邮件。

3. 请确保测试人员使用同一电子邮件地址接受邀请。

测试人员收不到电子邮件通知

如果出现以下任一情况，测试人员可能不会收到电子邮件通知：

• 电子邮件通知发送到“垃圾邮件”文件夹。

• 设置了电子邮件过滤器。

• 邀请已发送到一个电子邮件账号，但测试人员使用其他电子邮件账号接受了邀请。测试人员会在最初收到邀请的电子邮件账号中收到新版本电子邮件。

• 测试人员之前曾受到邀请，但未接受初始邀请。 如果测试人员已被添加到后续版本，则 App Distribution 不会自动向该测试人员发送版本通知，因为测试人员未接受初始邀请。

解决方案 1

1. 让测试人员检查他们的垃圾邮件文件夹以及他们在其电子邮件服务中设置的任何电子邮件过滤器。

2. 如果测试人员退订了电子邮件，请让其执行以下操作：

   1. 查找测试人员之前通过应用收到的电子邮件。
   2. 点击底部的管理电子邮件设置，然后点击允许发送电子邮件以重新订阅。

解决方案 2

如果测试人员不关心是否收到电子邮件通知，只是希望能够接受应用邀请，他们可以直接在 Firebase App Distribution Web 片段 (appdistribution.firebase.google.com) 中查看待处理的应用邀请。

注意：如需查看待处理的应用邀请，测试人员用于登录 Web 片段的 Google 账号的电子邮件地址必须与开发者邀请的收件人电子邮件地址一致。

解决方案 3

1. 从 Firebase 控制台的 App Distribution 页面中，从测试人员和群组标签页的查看所有测试人员部分中删除测试人员。此操作会移除现有邀请。

2. 重新邀请测试人员测试您的应用。测试人员应该会收到一封邀请电子邮件。请确保测试人员使用收到邀请的同一电子邮件地址来接受邀请。

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

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

尝试运行测试应用时出现“需要开发者模式”错误

当您尝试在未先启用开发者模式的情况下在 iOS 16 或更高版本上启动临时预配的 iOS 应用时，系统会显示“需要开发者模式”错误。

如需启用开发者模式并解决此错误，请按以下步骤操作：

1. 在 iPhone 上，打开“设置”应用，然后点按隐私与安全性。
2. 向下滚动到“安全”，然后点按开发者模式。
3. 点按开发者模式滑块。
4. 点按重启。
5. 设备重启后，解锁设备。系统随即会显示“开启开发者模式？”对话框。
6. 点按开启。现在，您可以启动应用并开始测试。

“设备已注册，您已准备就绪！当应用可供测试时，您会收到一封电子邮件”

您安装临时版时，如果开发者尚未将其应用配置为在测试设备上运行，系统就会显示此消息。 如需使该应用可供您使用，开发者必须完成注册其他设备中规定的操作。

注意：如果开发者已经分发了具有相同 build 编号和版本的 build，则只有新注册设备的用户才会收到电子邮件通知。

Google 账号无权访问测试应用

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

请注意以下几点：

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

403 错误：“请联系您的管理员以获取访问权限”

如果出现 403 错误，则表示您使用的账号无权安装和测试应用。具体访问权限由您在 Google Workspace 中的账号网域的管理员决定。

如果您认为自己应该有权限安装和测试应用，请让您的 Google Workspace 账号管理员更改您的账号设置。您的管理员应按照管理对无法单独控制的服务的访问权限中的说明操作。

如果您有多个账号，请尝试使用可不受限制地安装和测试应用的其他账号登录。

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

请按照以下提示，排查使用 App Distribution iOS SDK 启用应用内新 build 提醒时发生的问题。

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

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

1. 在您的应用中启用调试模式。要了解具体操作方法，请参阅 Google Analytics 文档。

2. 在模拟器中运行您的应用，然后搜索字符串“[Firebase/AppDistribution]”。

3. 检查测试人员是否有权访问新版本：

   • 如果返回了有效的版本对象，那么可能是视图控制器生命周期中存在问题，导致提醒对话框在视图显示之前加载。

     注意：默认情况下，App Distribution iOS SDK 不会显示提醒对话框。您必须指定对话框在应用中的显示方式和显示位置。如需了解详情，请参阅基本提醒配置。

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

     如果您的测试人员仍未收到更新，请让他们按照以下提示操作，确保他们已接受测试应用的邀请，并且正确设置了测试设备：

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

     2. 确保 Web Clip 中包含新的应用版本。

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

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

• 确认您已启用 Firebase App Testers API。如需了解详情，请参阅启用 App Distribution Tester API。

• 在密钥限制下，确保 Firebase API Testers API 包含在允许的 API 列表中。

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

常见问题解答

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

Firebase App Distribution 具有以下测试人员限制：

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

• 一个 App Distribution 群组最多可添加 200 名测试人员

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

我的测试人员邀请会过期吗？

在邀请到期前，测试人员有 30 天的时间来接受测试应用的邀请。 当邀请距离到期还有 5 天的时候，Firebase 控制台会在相应版本的测试人员旁边显示到期通知。您可以使用测试人员对应行中的下拉菜单重发邀请来重新开始邀请测试人员。

何时会为 iOS 上传内容创建新版本？

请参阅注册其他设备。

应用版本可以使用多长时间？

如果出现以下任一情况，系统会从 App Distribution 中移除应用版本：

• 应用版本已超过 150 天。
• 您超过了 1000 个应用版本限制，并且应用版本早于最近的 1000 个应用版本。

如需了解详情，请参阅 App Distribution 最多支持 1000 个版本。

当应用达到或超过 150 天到期限制或 1000 个应用版本限制后，系统将从 App Distribution 信息中心和 App Distribution 测试人员 Web 应用中移除该版本。如果您的测试人员已安装该版本，则应用的本地版本会继续运行。

如需将应用版本保留更长的时间，请采用以下某个建议：

• 在应用版本到期或超出版本数量限制之前，请下载 IPA，然后从 App Distribution 信息中心删除该版本。然后，将新 IPA 作为新 build 重新上传到 App Distribution。
• 下载此版本并将其上传到 Cloud Storage 进行长期归档。

应用版本将在 150 天后过期

当您将应用版本上传到 Firebase 后，该版本会在 App Distribution 信息中心中显示 150 天（从上传之日算起）。上传版本后，您可以将其分发给测试人员，以便测试人员在测试设备上安装 App Distribution 测试人员 Web 应用中的版本。

当应用版本距离到期日还有 30 天时，Firebase 控制台的 App Distribution 页面以及 App Distribution 测试人员 Web 应用中的版本上会显示应用版本到期通知。

App Distribution 最多支持 1000 个版本

App Distribution 允许每个应用最多可以有 1000 个版本。当您的应用达到 1000 个应用版本数量限制时，App Distribution 会自动删除超出此限制的最早版本。

如果您要手动管理应用版本，请使用 App Distribution REST API 列出和批量删除应用版本。

如果您有任何疑问，请与 Firebase 支持团队联系。

什么是 Firebase 配置文件？

Firebase 配置文件是一个配置文件，可让您使用 App Distribution 功能执行以下操作：

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

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

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

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

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

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

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

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

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

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

如何删除测试人员账号？

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

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

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

   删除账号。

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