斯威夫特套件管理器
Firebase 建議為新專案使用 Swift Package Manager。
透過Xcode
Swift 套件管理器支援需要 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分析
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 的使用者隱私和資料使用以及應用程式追蹤透明度文檔,以了解有關裝置層級廣告識別碼 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"
迦太基
迦太基的支持是實驗性的。請參閱GitHub 上的說明,以了解如何透過 Carthage 將 Firebase 新增至您的應用程式。
手動集成
Firebase 為想要在不使用依賴項管理器的情況下整合 Firebase 的使用者提供了預先建置的二進位 XCFramework 發行版。要安裝 Firebase:
下載框架 SDK zip 。此檔案包含所有 Firebase SDK 的所有可用目標架構的架構切片,因此可能需要一些時間下載。
解壓縮該文件,然後查看您想要包含在應用程式中的框架的
README
。在目標的建置設定中的
Other Linker Settings
中新增-ObjC
連結器標誌。