Catch up on highlights from Firebase at Google I/O 2023. Learn more

將 Firebase 添加到您的 Apple 項目

先決條件

  • 安裝以下內容:

    • Xcode 14.1 或更高版本
  • 確保您的項目滿足以下要求:

    • 您的項目必須針對這些平台版本或更高版本:
      • iOS 11
      • macOS 10.13
      • 電視操作系統 12
      • watchOS 6
  • 設置物理 Apple 設備或使用模擬器來運行您的應用程序。

如果您還沒有 Xcode 項目並且只想試用 Firebase 產品,您可以下載我們的快速入門示例之一。

第 1 步:創建一個 Firebase 項目

在將 Firebase 添加到您的 Apple 應用程序之前,您需要創建一個 Firebase 項目以連接到您的應用程序。訪問了解 Firebase 項目以了解有關 Firebase 項目的更多信息。

第 2 步:向 Firebase 註冊您的應用

要在您的 Apple 應用程序中使用 Firebase,您需要在 Firebase 項目中註冊您的應用程序。註冊您的應用程序通常稱為將您的應用程序“添加”到您的項目中。

  1. 轉到Firebase 控制台

  2. 在項目概覽頁面的中央,單擊iOS+圖標以啟動設置工作流程。

    如果您已將應用程序添加到 Firebase 項目,請單擊添加應用程序以顯示平台選項。

  3. bundle ID字段中輸入您應用程序的 bundle ID。

  4. (可選)輸入其他應用信息:應用暱稱App Store ID

  5. 單擊註冊應用程序

第 3 步:添加 Firebase 配置文件

  1. 單擊下載 GoogleService-Info.plist以獲取您的 Firebase Apple 平台配置文件 ( GoogleService-Info.plist )。

  2. 將配置文件移動到 Xcode 項目的根目錄中。如果出現提示,請選擇將配置文件添加到所有目標。

如果您的項目中有多個 bundle ID,則必須將每個 bundle ID 與 Firebase 控制台中註冊的應用相關聯,以便每個應用都可以擁有自己的GoogleService-Info.plist文件。

第 4 步:將 Firebase SDK 添加到您的應用

使用 Swift Package Manager 安裝和管理 Firebase 依賴項。

  1. 在 Xcode 中,打開您的應用程序項目,導航至File > Add Packages
  2. 出現提示時,添加 Firebase Apple 平台 SDK 存儲庫:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. 選擇您要使用的 SDK 版本。
  5. 選擇您要使用的 Firebase 庫。

    如果在您的 Firebase 項目中啟用了 Google Analytics,請確保添加FirebaseAnalytics 。對於沒有 IDFA 收集功能的 Analytics,請改為添加FirebaseAnalyticsWithoutAdId

完成後,Xcode 將自動開始在後台解析和下載您的依賴項。

第 5 步:在您的應用中初始化 Firebase

最後一步是將初始化代碼添加到您的應用程序中。作為將 Firebase 添加到您的應用程序的一部分,您可能已經完成了此操作。如果您使用的是快速入門示例項目,這已經為您完成了。

  1. 在您的UIApplicationDelegate中導入FirebaseCore模塊,以及您的應用委託使用的任何其他Firebase 模塊。例如,要使用 Cloud Firestore 和身份驗證:

    斯威夫特用戶界面

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    迅速

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    目標-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 在您的應用委託的application(_:didFinishLaunchingWithOptions:)方法中配置一個FirebaseApp共享實例:

    斯威夫特用戶界面

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    迅速

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    目標-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 如果您使用的是 SwiftUI,則必須創建一個應用程序委託並通過UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor將其附加到您的App結構。您還必須禁用應用委託調配。有關詳細信息,請參閱SwiftUI 說明

    斯威夫特用戶界面

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. 如果您已包含適用於 Google Analytics 的 Firebase SDK,則可以運行您的應用程序以向 Firebase 控制台發送驗證,表明您已成功安裝 Firebase。

就是這樣!您可以跳到下一步

不過,如果您在設置時遇到問題,請訪問Apple 平台故障排除和常見問題解答

可用庫

本部分列出了 Apple 平台支持的 Firebase 產品。詳細了解這些 Firebase Apple 平台庫:

服務或產品豆莢SwiftPM 庫添加分析?
AdMob pod 'Google-Mobile-Ads-SDK'不適用
分析pod 'FirebaseAnalytics' FirebaseAnalytics
應用檢查pod 'FirebaseAppCheck' FirebaseAppCheck
應用分發pod 'FirebaseAppDistribution' FirebaseAppDistribution
驗證pod 'FirebaseAuth' FirebaseAuth
雲端 Firestore pod 'FirebaseFirestore' FirebaseFirestore
Firebase 客戶端 SDK 的雲函數pod 'FirebaseFunctions' FirebaseFunctions
雲消息pod 'FirebaseMessaging' FirebaseMessaging
雲儲存pod 'FirebaseStorage' FirebaseStorage
崩潰分析pod 'FirebaseCrashlytics' FirebaseCrashlytics
動態鏈接pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
應用內消息pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(必需的)
Firebase 安裝pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML 自定義模型 API pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
性能監控pod 'FirebasePerformance' FirebasePerformance
實時數據庫pod 'FirebaseDatabase' FirebaseDatabase
遠程配置pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

不使用 Swift 包管理器進行集成

如果您不想使用 Swift Package Manager,您仍然可以通過使用 CocoaPods 或直接導入框架來利用 Firebase SDK。

可可豆

我們的指南中了解有關 CocoaPods 集成的更多信息。

構架

除了支持 iOS 平台外,該 zip 現在還包含.xcframework文件。有關詳細信息,請參閱GitHub 上的 Firebase Apple 平台 SDK 自述文件

  1. 下載框架 SDK zip 。這是一個約 200MB 的文件,下載可能需要一些時間。

  2. 解壓縮文件,然後集成要包含在應用程序中的框架。

    您可以在以下任一位置找到集成說明:

    有關框架版本或依賴項的信息,請參閱下載的 zip 分發包中的METADATA.md文件。

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

下一步

了解 Firebase:

將 Firebase 服務添加到您的應用: