Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

在您的 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鏈接器標誌