將 Firebase 新增至您的 Apple 專案

事前準備

  • 安裝下列項目:

    • Xcode 15.2 以上版本
  • 確認專案符合下列規定:

    • 您的專案必須指定下列平台版本或更新版本:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7
  • 設定實體 Apple 裝置,或使用模擬器執行應用程式。

  • 使用 Google 帳戶。

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

步驟 1:建立 Firebase 專案

您需要先建立 Firebase,才能將 Firebase 新增到 Apple 應用程式 連線至應用程式前往 如要進一步瞭解 Firebase 專案,請參閱這篇文章 Firebase 專案。

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

如要在 Apple 應用程式中使用 Firebase,請向以下應用程式註冊應用程式: Firebase 專案。註冊應用程式通常稱為「新增」將應用程式 專案。

  1. 前往 Firebase 控制台

  2. 按一下專案總覽頁面中央的「iOS+」圖示 啟動設定工作流程

    如果您已在 Firebase 專案中加入應用程式,請按一下「新增應用程式」 顯示平台選項

  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 中保持開啟應用程式專案,然後前往「檔案」檔案 >新增套件
  2. 在系統提示時,新增 Firebase Apple 平台 SDK 存放區:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. 選取要使用的 SDK 版本。
  5. 選擇要使用的 Firebase 程式庫。

    如果您的 Firebase 專案已啟用 Google Analytics,請確認 即可新增 FirebaseAnalytics。不收集廣告識別碼的 Analytics 新增 FirebaseAnalyticsWithoutAdId

完成後,Xcode 會自動開始解析並下載 複製到背景依附元件

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

最後一步是將初始化程式碼新增至應用程式。您可能已經 因為您是在應用程式中加入 Firebase 時完成這項操作。如果使用 快速入門範例專案,已經為您完成這項工作。

  1. FirebaseCore 模組匯入至 UIApplicationDelegate和任何其他 應用程式委派所用的 Firebase 模組。 例如,如要使用 Cloud FirestoreAuthentication

    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. 設定 FirebaseApp敬上 共用執行個體 application(_:didFinishLaunchingWithOptions:) 方法:

    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,則必須建立並附加應用程式委派 透過 UIApplicationDelegateAdaptorApp NSApplicationDelegateAdaptor。您也必須停用應用程式委派功能切換功能。適用對象 詳情請參閱 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 程式庫 Google Analytics。">要新增Analytics嗎?
AdMob pod 'Google-Mobile-Ads-SDK' 不適用
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(必填)
安裝次數:Firebase pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML 自訂模型 API pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI in Firebase 不適用 FirebaseVertexAI-Preview

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

如果不想使用 Swift Package Manager,仍可善用 Firebase SDK 套件,例如使用 CocoaPods 或直接匯入架構。

CocoaPods

進一步瞭解 CocoaPods 的整合功能: 指南

架構

除了支援 iOS 平台,ZIP 檔案現在也包含 .xcframework 檔案。詳情請參閱 Firebase 專用 Apple 平台 SDK README GitHub ,直接在 Google Cloud 控制台實際操作。

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

  2. 解壓縮檔案,然後整合您要納入的架構 。

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

    如需架構版本或依附元件的相關資訊,請參閱 METADATA.md 檔案。

  3. -ObjC 連接器標記 位於目標建構設定中的 Other Linker Settings

後續步驟

瞭解 Firebase:

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