斯威夫特包管理器
从 Firebase Apple SDK 的 v8.0.0 开始,Firebase 的Swift Package Manager支持已结束测试版并已普遍可用。 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 中,通过导航到文件 > 添加包来安装 Firebase 库
在出现的提示中,选择 Firebase GitHub 存储库:
https://github.com/firebase/firebase-ios-sdk.git
选择您要使用的 Firebase 版本。对于新项目,我们建议使用最新版本的 Firebase。
选择您要包含在应用中的 Firebase 库。
完成后,Xcode 将开始解析您的包依赖项并在后台下载它们。
通过Package.swift
要通过Package.swift
清单将 Firebase 集成到 Swift 包中,您可以将 Firebase 添加到包的dependencies
数组中。有关详细信息,请参阅Swift 包管理器文档。
dependencies: [
.package(name: "Firebase",
url: "https://github.com/firebase/firebase-ios-sdk.git",
from: "8.0"),
// ...
],
然后在依赖于 Firebase 产品的任何目标中,将其添加到该目标的dependencies
数组中。
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
特定于产品的注意事项
某些 Firebase 产品需要额外的集成步骤才能正常运行。
谷歌分析
如果传递包含,Google Analytics 需要将-ObjC
链接器标志添加到目标的构建设置中。
崩溃分析
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
。
可可豆
除了 Swift Package Manager 之外,Firebase 还支持使用CocoaPods安装。
Firebase 的 CocoaPods 发行版需要 Xcode 13.3.1 和 CocoaPods 1.10.0 或更高版本。以下是使用 CocoaPods 安装 Firebase 的方法:
如果您还没有 Podfile,请创建一个。从项目目录的根目录运行以下命令:
pod init
在您的 Podfile 中,添加您要在您的应用中使用的 Firebase pod。
您可以将任何受支持的 Firebase 产品添加到您的应用中。
启用分析
# 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'
在 Apple 的用户隐私和数据使用以及App Tracking Transparency文档中了解有关设备级广告标识符 IDFA 的更多信息。
未启用分析
# 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 要求您上传调试符号。
您可以使用 Xcode 的运行脚本构建阶段在构建后自动上传调试符号。在这里找到运行脚本:
"${PODS_ROOT}/FirebaseCrashlytics/run"
迦太基
Carthage 支持是实验性的。请参阅GitHub 上的说明,了解如何通过 Carthage 在您的应用中包含 Firebase。
手动集成
Firebase 为想要在不使用依赖项管理器的情况下集成 Firebase 的用户提供预构建的二进制 XCFramework 分发。安装 Firebase:
下载框架 SDK zip 。此文件包含所有 Firebase SDK 的所有可用目标架构的架构切片,因此可能需要一些时间才能下载。
解压缩文件,然后查看您要包含在应用程序中的框架的
README
文件。在目标构建设置的
Other Linker Settings
中-ObjC
链接器标志。