Swift Package Manager
从 Firebase iOS SDK v8.0.0 开始,Firebase 的 Swift Package Manager 支持 Beta 版测试就已经结束,现已正式推出。Swift Package Manager 用户不需要使用 CocoaPods。
对于 Firebase 版本 8 及更高版本,建议使用 Swift Package Manager 安装。
通过 Xcode
如需获得 Swift Package Manager 支持,您需要使用 13.3.1 或更高版本。
如果要从基于 CocoaPods 的项目迁移,请运行
pod deintegrate
,从您的 Xcode 项目中移除 CocoaPods。之后可以安全地删除 CocoaPods 生成的.xcworkspace
文件。如果您是第一次向项目添加 Firebase,可以忽略此步骤。在 Xcode 中,转到 File(文件)> Add Packages(添加软件包)以安装 Firebase 库
在出现的提示中,选择 Firebase GitHub 代码库:
https://github.com/firebase/firebase-ios-sdk.git
选择您要使用的 Firebase 版本。对于新项目,我们建议使用最新版本的 Firebase。
选择要加入您应用中的 Firebase 库。
完成之后,Xcode 将开始解析您的软件包依赖项,并在后台下载它们。
通过 Package.swift
要通过 Package.swift
清单将 Firebase 集成到 Swift 软件包,您可以将 Firebase 添加到软件包的 dependencies
数组中。如需了解详情,请参阅 Swift Package Manager 文档。
dependencies: [
.package(name: "Firebase",
url: "https://github.com/firebase/firebase-ios-sdk.git",
from: "8.0"),
// ...
],
然后,在任何依赖于 Firebase 产品的目标中,将 Firebase 添加到该目标的 dependencies
数组中。
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
各产品特有的注意事项
对于某些 Firebase 产品,您需要执行额外的集成步骤才能确保其正常运行。
Google Analytics(分析)
如果以转换方式包含 -ObjC
链接器标记,Google Analytics(分析)需要将其添加到目标的构建设置中。
Crashlytics
Crashlytics 要求您上传调试符号。
您可以使用适用于 Xcode 的运行脚本构建阶段在构建后自动上传调试符号。运行脚本位于以下位置:
${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run
上传符号的另一种方法是使用 upload-symbols
脚本。将脚本放在项目文件的子目录(例如 scripts/upload-symbols
)中,并确保该脚本可执行:
chmod +x scripts/upload-symbols
此脚本可用于手动上传 dSYM 文件。如需查看脚本的使用说明和其他说明,请运行 upload-symbols
(不带任何参数)。
CocoaPods
除了 Swift Package Manager 之外,Firebase 还支持使用 CocoaPods 进行安装。
Firebase 的 CocoaPods 分发要求使用 Xcode 13.3.1 和 CocoaPods 1.10.0 或更高版本。使用 CocoaPods 安装 Firebase 的方法如下:
如果您没有 Podfile,请创建一个:从您的项目目录的根目录中,运行以下命令:
pod init
将想要用在应用中的 Firebase pod 添加到 Podfile。
您可以将任何受支持的 Firebase 产品添加到您的应用中。
已启用 Analytics
# Add the Firebase pod for Google Analytics pod 'FirebaseAnalytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'FirebaseAuth' pod 'FirebaseFirestore'
如需详细了解 IDFA(设备级广告标识符),请参阅 Apple 的用户隐私和数据使用和 App Tracking Transparency 文档。
未启用 Analytics
# Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'FirebaseAuth' pod 'FirebaseFirestore'
安装 pod,然后打开
.xcworkspace
文件,以便在 Xcode 中查看该项目:pod install --repo-update
open your-project.xcworkspace
各产品特有的注意事项
对于某些 Firebase 产品,您需要执行额外的集成步骤才能确保其正常运行。
Crashlytics
Crashlytics 要求您上传调试符号。
您可以使用适用于 Xcode 的运行脚本构建阶段在构建后自动上传调试符号。运行脚本位于以下位置:
"${PODS_ROOT}/FirebaseCrashlytics/run"
Carthage
Carthage 支持服务尚处于实验阶段。如需了解如何通过 Carthage 在应用中添加 Firebase,请参阅 GitHub 上的说明。
手动集成
Firebase 提供了一个预构建的二进制 XCFramework 发行版,适合希望在不使用依赖项管理器的情况下集成 Firebase 的用户。如需安装 Firebase,请执行以下操作:
下载框架 SDK zip。此文件包含适用于所有 Firebase SDK 的所有可用目标架构的架构切片,因此下载可能需要一些时间。
解压缩文件,然后查看要包含在应用中的框架的
README
。在目标的构建设置中,将
-ObjC
链接器标记添加到Other Linker Settings
中。