斯威夫特包管理器
從 Firebase Apple SDK 的 v8.0.0 開始,Firebase 的Swift Package Manager支持已結束測試版並已普遍可用。 Swift Package Manager 用戶不需要 CocoaPods。
對於 Firebase 版本 8 及更高版本,Swift Package Manager 是推薦的安裝方法。
通過 Xcode
Swift Package Manager 支持需要 14.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 14.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
鏈接器標誌。