Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

在您的 Apple 應用中安裝 Firebase

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

斯威夫特包管理器

從 Firebase Apple SDK 的 v8.0.0 開始,Firebase 的Swift Package Manager支持已結束測試版並已普遍可用。 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 中,通過導航到文件 > 添加包來安裝​​ 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 Package Manager 之外,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 支持是實驗性的。請參閱GitHub 上的說明,了解如何通過 Carthage 在您的應用中包含 Firebase。

手動集成

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

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

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

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