Swift Package Manager
Firebase 建議使用 Swift Package Manager 建立新專案。
透過 Xcode
如要支援 Swift Package Manager,則必須使用 15.2 以上版本。
如果是從 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 的任何目標中,將該產品加入
dependencies
陣列
目標資源
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
產品相關注意事項
部分 Firebase 產品需要額外的整合步驟才能正常運作。
Google Analytics
如果 Google Analytics 是透過轉接方式加入,就必須將 -ObjC
連結器標記新增至目標的建構設定。
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 15.2 和 CocoaPods 1.12.0 以上版本。以下是使用 CocoaPods 安裝 Firebase 的方式:
如果您沒有 Podfile,請先建立 Podfile。從 ,請執行下列指令:
pod init
在 Podfile 中新增要用於應用程式的 Firebase Pod。
您可以新增 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 (裝置層級廣告 ID)。請前往 Apple 的 使用者隱私權和資料使用方式 和 應用程式追蹤資訊公開 說明文件。
未啟用「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 在應用程式中加入 Firebase,請參閱 GitHub 上的操作說明。
手動整合
Firebase 提供預先建構的 XCFramework 二進位檔發布項目,方便使用者在不使用依附元件管理工具的情況下,整合 Firebase。如要安裝 Firebase,請按照下列步驟操作:
下載 架構 SDK 的 .zip 檔案。這個檔案含有架構配量 適用於所有 Firebase SDK 所有可用的目標架構,因此可能會 下載需要一些時間
解壓縮檔案,然後查看您要納入應用程式的架構的
README
。在目標的建構設定中,在
Other Linker Settings
中新增-ObjC
連結器標記。