將 Firebase 新增至 Apple 專案

先備知識

  • 安裝下列項目：

    • Xcode 14.1 以上版本

  • 確認專案符合下列規定：

    • 您的專案必須指定下列平台版本或更新版本：
      • iOS 11 作業系統
      • macOS 10.13
      • tvOS 12
      • WatchOS 6

  • 設定實體 Apple 裝置，或使用模擬器執行應用程式。

如果您還沒有 Xcode 專案，只是想試用 Firebase 產品，可以下載其中一個快速入門導覽課程範例。

步驟 1：建立 Firebase 專案

您需要先建立 Firebase 專案並連結至應用程式，才能將 Firebase 新增到 Apple 應用程式。如要進一步瞭解 Firebase 專案，請參閱「瞭解 Firebase 專案」。

步驟 2：向 Firebase 註冊應用程式

如要在 Apple 應用程式中使用 Firebase，您必須使用 Firebase 專案註冊應用程式。註冊應用程式通常稱為「新增」應用程式至專案中。

  1. 前往 Firebase 主控台。

  2. 在專案總覽頁面中間，按一下「iOS+」圖示來啟動設定工作流程。

    如果您已經在 Firebase 專案中加入應用程式，請按一下「Add app」顯示平台選項。

  3. 在「bundle ID」欄位中輸入應用程式的軟體包 ID。

  4. (選用) 輸入其他應用程式資訊：「應用程式暱稱」和「App Store ID」。

  5. 按一下 [Register app] (註冊應用程式)。

步驟 3：新增 Firebase 設定檔

  1. 點選「Download GoogleService-Info.plist」，取得 Firebase Apple 平台設定檔 (GoogleService-Info.plist)。

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

如果專案中有多個軟體包 ID，您必須在 Firebase 控制台中，將每個軟體包 ID 與已註冊的應用程式建立關聯，讓每個應用程式擁有自己的 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
  3. 選取要使用的 SDK 版本。

  4. 選擇要使用的 Firebase 程式庫。

    如果您的 Firebase 專案已啟用 Google Analytics (分析)，請務必新增 FirebaseAnalytics。如為沒有廣告識別碼收集功能的 Analytics (分析)，請改為新增 FirebaseAnalyticsWithoutAdId。

完成後，Xcode 會自動開始在背景解析並下載依附元件。

步驟 5：在應用程式中初始化 Firebase

最後一步是將初始化程式碼新增至應用程式。您可能已經在將 Firebase 新增至應用程式的過程中完成這項操作。如果您使用的是快速入門導覽課程範例專案，系統會自動完成這項作業。

  1. 將 FirebaseCore 模組匯入 UIApplicationDelegate，以及應用程式委派使用的任何其他 Firebase 模組。例如，如要使用 Cloud Firestore 和驗證：

    SwiftUI

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. 在應用程式委派的 application(_:didFinishLaunchingWithOptions:) 方法中設定 FirebaseApp 共用例項：

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. 如果您使用 SwiftUI，則必須建立應用程式委派，並透過 UIApplicationDelegateAdaptor 或 NSApplicationDelegateAdaptor 將其附加至 App 結構體。您也必須停用應用程式委派功能切換功能。詳情請參閱 SwiftUI 操作說明。

    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 平台程式庫：

服務或產品 Pod SwiftPM 程式庫 要新增數據分析嗎？
AdMob pod 'Google-Mobile-Ads-SDK' 不適用
數據分析 pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
應用程式發布 pod 'FirebaseAppDistribution' FirebaseAppDistribution
身分驗證 pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase 用戶端 SDK pod 'FirebaseFunctions' FirebaseFunctions
雲端通訊 pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics 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
適用於 Firebase 的 Vertex AI 不適用 FirebaseVertexAI-Preview

不使用 Swift 套件管理工具進行整合

如果不想使用 Swift Package Manager，仍可透過 CocoaPods 或直接匯入架構來充分運用 Firebase SDK。

CocoaPods

如要進一步瞭解 CocoaPods 整合，請參閱這份指南。

架構

除了支援 iOS 平台外，ZIP 檔案現在也包含 .xcframework 檔案。詳情請參閱 GitHub 上的 Firebase Apple 平台 SDK README。

  1. 下載架構 SDK ZIP。這個檔案大小約為 200 MB，下載可能需要一點時間。

  2. 解壓縮檔案，然後整合您要納入應用程式的架構。

    您可以在以下任一位置找到整合操作說明：

    如需架構版本或依附元件的相關資訊，請參閱所下載的 ZIP 發行版本中的 METADATA.md 檔案。

  3. 在目標建構設定的 Other Linker Settings 中新增 -ObjC 連結器標記。

後續步驟

瞭解 Firebase：

在應用程式中新增 Firebase 服務：