將 Firebase 新增至您的 Apple 專案

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

步驟 2：透過 Firebase 註冊應用程式

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

1. 前往 Firebase 控制台。

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

   如果您已將應用程式新增至 Firebase 專案，請按一下「Add app」，顯示平台選項。

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

   什麼是軟體包 ID？如何找出軟體包 ID？

   • 軟體包 ID 可用來識別 Apple 生態系統中的應用程式。

   • 找出軟體包 ID：在 Xcode 中開啟專案，選取專案導覽器中的頂層應用程式，然後選取「General」分頁。

     「Bundle Identifier」欄位的值為軟體包 ID (例如 com.yourcompany.yourproject)。

   • 請注意，套件 ID 值會區分大小寫，且在 Firebase 專案註冊此 Firebase 應用程式後，就無法變更。

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

   如何在 Firebase 中使用應用程式暱稱和應用程式商店 ID？

   • 應用程式暱稱：內部方便使用識別碼，僅會在 Firebase 管理中心顯示

   • App Store ID：Firebase Dynamic Links 會使用此 ID 將使用者重新導向至您的 App Store 頁面，Google Analytics 則會使用此 ID 將轉換事件匯入 Google Ads。如果應用程式尚未有 App Store ID，您可以稍後在專案設定中新增 ID。

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

步驟 3：新增 Firebase 設定檔

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

   您需要瞭解這個設定檔的哪些資訊？

   • Firebase 設定檔包含專案的非祕密專屬 ID。如要進一步瞭解這個設定檔，請參閱「瞭解 Firebase 專案」。

   • 您隨時可以重新下載 Firebase 設定檔。

   • 請確認設定檔名稱未附加額外的字元，例如 (2)。

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

如果專案中有多個套件 ID，您必須在 Firebase 主控台中將每個套件 ID 與已註冊的應用程式建立關聯，讓每個應用程式都能擁有自己的 GoogleService-Info.plist 檔案。

步驟 4：將 Firebase SDK 新增至應用程式

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

1. 在 Xcode 中保持開啟應用程式專案，然後依序點選「File」>「Add Packages」。
2. 系統提示時，請新增 Firebase Apple 平台 SDK 存放區：

  https://github.com/firebase/firebase-ios-sdk

3. 選取要使用的 SDK 版本。

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

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

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

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

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

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

   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 結構體。您也必須停用應用程式委派程式 swizzling 功能。詳情請參閱 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 平台程式庫：

• 參考說明文件 (Swift | Obj-C)

• Firebase Apple 平台 SDK GitHub 存放區

不使用 Swift Package Manager 進行整合

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

CocoaPods

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

架構

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

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

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

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

   • 前往 Firebase iOS SDK GitHub 存放區。
   • 在下載的 ZIP 發布項目中的 README.md 檔案中。

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

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

後續步驟

瞭解 Firebase：

• 請參閱「瞭解 Firebase 專案」一文，進一步瞭解 Firebase 專案和專案的最佳做法。

• 探索 Firebase 應用程式範例。

• 透過 Firebase iOS Codelab 實際操作。

• 瀏覽 GitHub 中的開放原始碼。

• 準備發布應用程式：

  • 在 Google Cloud 控制台中為專案設定預算快訊。
  • 請在 Firebase 控制台中監控使用量和帳單資訊主頁，全面掌握專案在多項 Firebase 服務中的用量。
  • 詳閱 Firebase 上市檢查清單。

• 使用 Firebase 和 Apple 專案時遇到問題嗎？請參閱 Apple 平台疑難排解與常見問題。

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

• 使用 Analytics 深入瞭解使用者行為。

• 使用 Authentication 設定使用者驗證機制。

• 使用 Cloud Firestore 或 Realtime Database 儲存使用者資訊等資料。

• 使用 Cloud Storage 儲存相片和影片等檔案。

• 使用 Cloud Functions 觸發在安全環境中執行的後端程式碼。

• 使用 Cloud Messaging 傳送通知。

• 使用 Crashlytics 找出應用程式當機的時間和原因。