Apple 平台和 Firebase 的故障排除和常见问题解答

此页面针对您在使用 Firebase 时可能遇到的特定于 Apple 平台的问题提供提示和故障排除。

有其他挑战或没有在下面列出您的问题吗？请务必查看主要的 Firebase 常见问题解答，了解更多泛 Firebase 或产品特定的常见问题解答。

您还可以查看Firebase Apple 平台 SDK GitHub 存储库以获取报告的问题和故障排除的最新列表。我们鼓励您也在那里提交您自己的 Firebase Apple 平台 SDK 相关问题！

Firebase 支持哪些版本的 Xcode？

Firebase 最多支持两个主要版本的 Xcode，不包括 Apple 不再支持的 Xcode 版本。例如，从 2019 年 3 月开始，Apple 要求所有应用程序至少运行 iOS 12，这意味着 Xcode 9 支持被取消，Xcode 10 是唯一受支持的主要版本。

对 Xcode 的特定次要版本或补丁版本（例如，9.2.0 到 9.4.1）的支持更改是根据 Firebase Apple 平台 SDK 的需求和对开发人员使用情况的调查确定的。这些更改反映在Firebase Apple 平台 SDK 发行说明和Firebase Apple 平台 SDK 设置页面上。

要查看 SDK 支持的最低 Xcode 版本，请查看将Firebase 添加到您的 Apple 项目中列出的要求。

Firebase 对 Xcode Beta 版的支持是在“尽力而为”的基础上提供的。开发人员可以在 GitHub 上的 Firebase Apple 平台 SDK 存储库中跟踪和提交问题。

我的应用提示用户输入密码以访问 macOS 上的钥匙串项目。我该如何解决？

将您的 Firebase 依赖项升级到版本 9.6.0 或更高版本，并将 [Keychain Sharing capability](/docs/ios/troubleshooting-faq#macos-keychain-sharing) 添加到您的目标。

为什么 Firebase 需要 macOS 上的钥匙串共享功能？

Firebase SDK 使用钥匙串来存储信息，例如用于 FCM 的 Firebase 安装 ID。如果没有钥匙串访问权限，Firebase SDK 可能无法正常运行。 macOS 钥匙串的行为不同于其他平台（iOS、tvOS、macCatalyst 和 watchOS）上使用的 iOS 风格钥匙串。

在 macOS 上，应用程序使用可能被其他应用程序和进程修改的共享钥匙串。与 iOS 不同，应用程序没有隐式访问的沙盒钥匙串。因此，当 Mac 应用程序与钥匙串交互时，系统会提示用户进行访问，因为 Mac 应用程序可能正在修改它未创建的钥匙串项目。为解决此差异，Firebase 使用kSecUseDataProtectionKeychain键查询钥匙串，它告诉应用程序查询属于钥匙串访问组的钥匙串项目（这是其他平台上的默认行为）。钥匙串共享功能是必需的，因为应用程序需要它来合成一个可以在其目标之间共享的访问组，从而允许应用程序自由访问访问组中的钥匙串项目。

有关详细信息，请参阅 Apple 的钥匙串文档。