事前準備
安裝下列項目:
- Xcode 15.2 以上版本
確認專案符合下列規定:
- 您的專案必須指定下列平台版本或更新版本:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- 您的專案必須指定下列平台版本或更新版本:
設定實體 Apple 裝置,或使用模擬器執行應用程式。
如果您沒有 Xcode 專案,只想試用 Firebase 產品,您可以下載其中一個快速入門導覽課程範例。
步驟 1:建立 Firebase 專案
您需要先建立 Firebase,才能將 Firebase 新增到 Apple 應用程式 連線至應用程式前往 如要進一步瞭解 Firebase 專案,請參閱這篇文章 Firebase 專案。
步驟 2:向 Firebase 註冊應用程式
如要在 Apple 應用程式中使用 Firebase,請向以下應用程式註冊應用程式: Firebase 專案。註冊應用程式通常稱為「新增」將應用程式 專案。
前往 Firebase 控制台。
按一下專案總覽頁面中央的「iOS+」圖示 啟動設定工作流程
如果您已在 Firebase 專案中加入應用程式,請按一下「新增應用程式」 顯示平台選項
在「bundle ID」欄位中輸入應用程式的軟體包 ID。
,瞭解如何調查及移除這項存取權。(選用) 輸入其他應用程式資訊: 「應用程式暱稱」和「App Store ID」。
按一下 [Register app] (註冊應用程式)。
步驟 3:新增 Firebase 設定檔
點選「Download GoogleService-Info.plist」,取得 Firebase Apple 平台設定檔 (
GoogleService-Info.plist
)。將設定檔移至 Xcode 專案的根目錄。如果出現提示訊息 選取即可將設定檔新增至所有目標。
如果專案中有多個軟體包 ID,就必須將每個軟體包建立關聯
與 Firebase 控制台中已註冊應用程式的 ID,讓每個應用程式可擁有
自己的 GoogleService-Info.plist
檔案
步驟 4:在應用程式中新增 Firebase SDK
使用 Swift Package Manager 安裝及管理 Firebase 依附元件。
- 在 Xcode 中保持開啟應用程式專案,然後前往「檔案」檔案 >新增套件。
- 在系統提示時,新增 Firebase Apple 平台 SDK 存放區:
- 選取要使用的 SDK 版本。
選擇要使用的 Firebase 程式庫。
如果您的 Firebase 專案已啟用 Google Analytics,請確認 即可新增
FirebaseAnalytics
。不收集廣告識別碼的 Analytics 新增FirebaseAnalyticsWithoutAdId
。
https://github.com/firebase/firebase-ios-sdk
完成後,Xcode 會自動開始解析並下載 複製到背景依附元件
步驟 5:在應用程式中初始化 Firebase
最後一步是將初始化程式碼新增至應用程式。您可能已經 因為您是在應用程式中加入 Firebase 時完成這項操作。如果使用 快速入門範例專案,已經為您完成這項工作。
- 將
FirebaseCore
模組匯入至UIApplicationDelegate
和任何其他 應用程式委派所用的 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; // ...
- 設定
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];
- 如果您使用 SwiftUI,則必須建立並附加應用程式委派
透過
UIApplicationDelegateAdaptor
或App
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() } } } }
- 如果您已加入 Google Analytics 專用 Firebase SDK,只要執行 應用程式,將驗證資料傳送至您已建立的 Firebase 控制台 Firebase 安裝成功。
這樣就可以了!請直接跳到後續步驟。
如果您在設定時遇到問題,請造訪 Apple 平台疑難排解與常見問題。
可用的程式庫
本節列出支援 Apple 平台的 Firebase 產品。學習新知 進一步瞭解以下 Firebase Apple 平台程式庫:
Firebase Apple 平台 SDK GitHub 存放區
服務或產品 | 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 控制台實際操作。
下載架構 SDK ZIP。這個檔案約為 200 MB,可能需要 下載一段時間
解壓縮檔案,然後整合您要納入的架構 。
您可以在以下任一位置找到整合操作說明:
- 在 Firebase iOS SDK GitHub 存放區。
- 在下載的 ZIP 發布版本內,開啟
README.md
檔案。
如需架構版本或依附元件的相關資訊,請參閱
METADATA.md
檔案。將
-ObjC
連接器標記 位於目標建構設定中的Other Linker Settings
。
後續步驟
瞭解 Firebase:
詳情請參閱「瞭解 Firebase 專案」一文 。
探索 Firebase 應用程式範例。
實際操作 Firebase iOS 程式碼研究室。
探索 GitHub 的開放原始碼功能。
準備推出應用程式:
- 設定預算 快訊 。Google Cloud.
- 監控用量與計費 資訊主頁 前往 Firebase 控制台查看專案的整體概況 以及跨多項 Firebase 服務的用量
- 查看 Firebase 發布檢查清單。
使用 Firebase 和 Apple 專案時遇到問題嗎? 參閱 Apple 平台疑難排解和常見問題。
在應用程式中新增 Firebase 服務:
透過以下工具取得使用者行為的深入分析: Analytics。
使用 Authentication 設定使用者驗證。
儲存使用者資訊等資料 Cloud Firestore 或 Realtime Database。
儲存相片和影片等檔案 Cloud Storage。
透過下列方式觸發在安全環境中執行的後端程式碼: Cloud Functions。
傳送通知的應用程式 Cloud Messaging。
透過以下項目瞭解應用程式當機的時機和原因: Crashlytics。