Check out what’s new from Firebase at Google I/O 2022. Learn more

在您的 Apple 應用中安裝 Firebase

Swift 包管理器

從 Firebase Apple SDK 的 v8.0.0 開始,Firebase 的Swift 包管理器支持已經過測試版,並且可以普遍使用。 Swift Package Manager 用戶不需要 CocoaPods。

對於 Firebase 版本 8 及更高版本,建議使用 Swift Package Manager 安裝方法。

通過 Xcode

Swift Package Manager 支持需要 13.3.1 或更高版本。

  1. 如果從基於 CocoaPods 的項目遷移,請運行pod deintegrate以從 Xcode 項目中刪除 CocoaPods。之後可以安全地刪除 CocoaPods 生成的.xcworkspace文件。如果您是第一次將 Firebase 添加到項目中,則可以忽略此步驟。

  2. 在 Xcode 中,通過導航到File > Add Packages來安裝 Firebase 庫

  3. 在出現的提示中,選擇 Firebase GitHub 存儲庫:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. 選擇您要使用的 Firebase 版本。對於新項目,我們建議使用最新版本的 Firebase。

  5. 選擇要包含在應用中的 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 包管理器之外,Firebase 還支持使用CocoaPods進行安裝。

Firebase 的 CocoaPods 發行版需要 Xcode 13.3.1 和 CocoaPods 1.10.0 或更高版本。以下是使用 CocoaPods 安裝 Firebase 的方法:

  1. 如果您還沒有 Podfile,請創建一個。從項目目錄的根目錄運行以下命令:

    pod init
  2. 在您的 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'
  3. 安裝 pod,然後打開.xcworkspace文件以在 Xcode 中查看項目:

    pod install --repo-update
    open your-project.xcworkspace

特定於產品的注意事項

某些 Firebase 產品需要額外的集成步驟才能正常運行。

崩潰分析器

Crashlytics 要求您上傳調試符號。

您可以使用 Xcode 的運行腳本構建階段在構建後自動上傳調試符號。在這裡找到運行腳本:

"${PODS_ROOT}/FirebaseCrashlytics/run"

迦太基

迦太基支持是實驗性的。有關通過 Carthage 在您的應用中包含 Firebase 的說明,請參閱 GitHub 上的說明。

手動集成

Firebase 為想要在不使用依賴管理器的情況下集成 Firebase 的用戶提供預構建的二進制 XCFramework 分發。要安裝 Firebase:

  1. 下載框架 SDK zip 。此文件包含適用於所有 Firebase SDK 的所有可用目標架構的架構切片,因此下載可能需要一些時間。

  2. 解壓縮文件,然後查看README以了解要包含在應用程序中的框架。

  3. 在目標構建設置的Other Linker Settings-ObjC鏈接器標誌