將 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. 捆綁包 ID欄位中輸入應用程式的捆綁包 ID。

  4. (可選)輸入其他應用程式資訊:應用程式暱稱應用程式商店 ID

  5. 點擊註冊應用程式

第 3 步:新增 Firebase 設定文件

  1. 按一下「下載 GoogleService-Info.plist」以取得 Firebase Apple 平台設定檔 ( GoogleService-Info.plist )。

  2. 將設定檔移至 Xcode 專案的根目錄中。如果出現提示,請選擇將設定檔新增至所有目標。

如果您的專案中有多個捆綁包 ID,則必須將每個捆綁包 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
    // ...
          

    Objective-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()

    Objective-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 Package Manager 進行集成

如果您不想使用 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 服務新增至您的應用程式: