Firebase Apple SDK 将于 2026 年 10 月后不再发布到 CocoaPods,已安装版本继续可用;新增 Firebase AI Logic 预览版支持 Gemini。
CocoaPods:Firebase Apple SDK 的新版本将于 2026 年 10 月后不再发布到 CocoaPods。现有 CocoaPods 版本将保持可用,安装功能不受影响。详见迁移指南。
Preview Release:Firebase AI Logic 的 Gemini Foundation Models framework adapter 现已提供预览版。访问文档开始使用。
本仓库包含除 FirebaseAnalytics 之外所有 Apple 平台 Firebase 库的源代码。
Firebase 是一个应用开发平台,提供库、服务和工具,帮助你构建、增长和变现你的应用。在 Firebase 官方网站了解更多关于 Firebase 的信息。
以下产品为开源,包含在本仓库中:
Firebase Analytics 并非开源,但通过 Swift Package Manager 或 CocoaPods 安装 Firebase 时会包含其预编译二进制文件。
请参阅下面的子章节,了解不同安装方法的详细信息。在可用的情况下,建议安装带有 Swift 后缀的库,以获得最佳的 Swift 开发体验。
在 Firebase 快速入门文档中找到使用 Swift Package Manager 安装的说明。
在 Firebase 安装选项文档中找到使用 CocoaPods(pod install)安装的说明。
注意:为配合 CocoaPods 的只读公告,Firebase 将于 2026 年 10 月停止向 CocoaPods 发布新版本。了解更多。
你可以从 GitHub 安装以访问其他分支、标签或提交中的 Firebase 仓库。
有关覆盖 pod 源位置的说明和选项,请参阅 Podfile 语法参考。
所有官方版本均在此仓库中标记,可通过 CocoaPods 获取。要访问本地源代码快照或未发布分支,请使用 Podfile 指令。以下是一些示例指令,以 FirebaseFirestore 为例库。
要通过分支访问 FirebaseFirestore:
pod 'FirebaseCore', :git => 'https://github.com/firebase/firebase-ios-sdk.git', :branch => 'main'
pod 'FirebaseFirestore', :git => 'https://github.com/firebase/firebase-ios-sdk.git', :branch => 'main'
要通过检出的 firebase-ios-sdk 仓库版本访问 FirebaseFirestore:
pod 'FirebaseCore', :path => '/path/to/firebase-ios-sdk'
pod 'FirebaseFirestore', :path => '/path/to/firebase-ios-sdk'
在仓库内找到有关实验性 Carthage 分发(仅限 iOS)的说明。
在仓库内的 firebase_in_libraries.md 中找到有关在框架或库中使用 Firebase 的详细信息。
Firebase 为 macOS、Catalyst 和 tvOS 提供官方 beta 支持。visionOS 和 watchOS 由社区支持。感谢社区对许多多平台 PR 的贡献。
目前,大多数 Firebase 产品在 Apple 平台上可用。仍然存在一些差距,尤其是在 visionOS 和 watchOS 上。关于当前支持矩阵的详细信息,请参阅 Firebase 文档中的此图表。
在受支持的地方,visionOS 按预期工作,但通过 Swift Package Manager 使用 Firestore 除外,此时需要使用源代码分发。
要启用 Firestore 源代码分发,请退出 Xcode 并使用 FIREBASE_SOURCE_FIRESTORE 环境变量从命令行打开所需项目:open --env FIREBASE_SOURCE_FIRESTORE /path/to/project.xcodeproj。要恢复使用 Firestore 的二进制分发,请正常退出 Xcode 并打开 Xcode,不使用环境变量。
感谢社区的贡献,许多 Firebase SDK 现在可以编译、运行单元测试并在 watchOS 上工作。请参阅 Independent Watch App Sample。
请记住,Firebase 官方不支持 watchOS。虽然我们可以通过 GitHub Actions 捕获基本的单元测试问题,但可能会有一些变化导致 SDK 在 watchOS 上无法按预期工作。如果遇到此问题,请提交 issue。
在控制台中进行应用设置时,你可能会看到一个步骤提示"Checking if the app has communicated with our servers"。这依赖于 FirebaseAnalytics,在 watchOS 上无法工作。可以忽略此消息并继续,其他 SDK 将按预期工作。
在 watchOS 上使用 Crashlytics 的支持有限。由于 watchOS 限制,mach 异常和信号崩溃不会被记录。(SwiftUI 中的崩溃会生成 mach 异常,因此不会被记录)。
感谢社区的贡献,FirebaseCombineSwift 包含对 Apple Combine 框架的支持。该模块目前正在开发中,尚未支持在生产环境中使用。关于更多详细信息,请参阅仓库内的文档。
有关 Firebase Apple SDK 开源计划和方向的更多信息,请参阅 Roadmap。
有关如何贡献、设置开发环境、构建或测试 SDK 的信息,请参阅 Contributing Guide。
本仓库的内容受 Apache License 版本 2.0 约束。
你对 Firebase 的使用受 Firebase Services 服务条款的约束。