先決條件
安裝以下內容:
- Xcode 14.1 或更高版本
確保您的項目滿足以下要求:
- 您的項目必須針對這些平台版本或更高版本:
- iOS 11
- macOS 10.13
- 電視操作系統12
- watchOS 6
- 您的項目必須針對這些平台版本或更高版本:
設置物理 Apple 設備或使用模擬器來運行您的應用程序。
對於 Apple 平台上的雲消息傳遞,先決條件如下:
- 設置物理 Apple 設備。
- 為您的Apple 開發者帳戶獲取 Apple 推送通知身份驗證密鑰。
- 在 Xcode 中的App > Capabilties下啟用推送通知。
- 使用您的 Google 帳戶登錄 Firebase 。
如果您還沒有 Xcode 項目而只想嘗試 Firebase 產品,則可以下載我們的快速入門示例之一。
第 1 步:創建 Firebase 項目
在將 Firebase 添加到您的 Apple 應用之前,您需要創建一個 Firebase 項目來連接到您的應用。訪問了解 Firebase 項目以了解有關 Firebase 項目的更多信息。
第 2 步:向 Firebase 註冊您的應用
要在 Apple 應用中使用 Firebase,您需要向 Firebase 項目註冊您的應用。註冊您的應用程序通常稱為將您的應用程序“添加”到您的項目中。
轉到Firebase 控制台。
在項目概述頁面的中心,單擊iOS+圖標以啟動設置工作流程。
如果您已將應用添加到 Firebase 項目,請單擊添加應用以顯示平台選項。
在捆綁包 ID字段中輸入應用程序的捆綁包 ID。
捆綁 ID唯一標識 Apple 生態系統中的應用程序。
查找您的捆綁包 ID:在 Xcode 中打開您的項目,在項目導航器中選擇頂級應用程序,然後選擇“常規”選項卡。
捆綁包標識符字段的值是捆綁包 ID(例如,
com.yourcompany.yourproject
)。請注意,捆綁包 ID 值區分大小寫,並且在向您的 Firebase 項目註冊後,無法更改此 Firebase 應用程序的捆綁包 ID 值。
(可選)輸入其他應用程序信息:應用程序暱稱和應用程序商店 ID 。
應用暱稱:內部便捷標識符,僅您在 Firebase 控制台中可見
App Store ID :Firebase 動態鏈接使用該 ID 將用戶重定向到您的 App Store 頁面,Google Analytics 使用該 ID 將轉化事件導入 Google Ads 。如果您的應用程序還沒有 App Store ID,您可以稍後在項目設置中添加該 ID。
單擊註冊應用程序。
第 3 步:添加 Firebase 配置文件
單擊“下載 GoogleService-Info.plist”以獲取 Firebase Apple 平台配置文件 (
GoogleService-Info.plist
)。Firebase 配置文件包含您的項目的唯一但非秘密的標識符。要了解有關此配置文件的更多信息,請訪問了解 Firebase 項目。
您可以隨時再次下載Firebase 配置文件。
確保配置文件名未附加其他字符,例如
(2)
。
將配置文件移至 Xcode 項目的根目錄中。如果出現提示,請選擇將配置文件添加到所有目標。
如果您的項目中有多個捆綁包 ID,則必須將每個捆綁包 ID 與 Firebase 控制台中註冊的應用程序關聯,以便每個應用程序都可以擁有自己的GoogleService-Info.plist
文件。
第 4 步:將 Firebase SDK 添加到您的應用
使用 Swift Package Manager 安裝和管理 Firebase 依賴項。
- 在 Xcode 中,打開應用程序項目,導航至File > Add Packages 。
- 出現提示時,添加 Firebase Apple 平台 SDK 存儲庫:
- 選擇您要使用的 SDK 版本。
選擇您要使用的 Firebase 庫。
如果您的 Firebase 項目中啟用了 Google Analytics,請確保添加
FirebaseAnalytics
。對於沒有 IDFA 收集功能的 Analytics,請添加FirebaseAnalyticsWithoutAdId
。
https://github.com/firebase/firebase-ios-sdk
完成後,Xcode 將自動開始在後台解析並下載您的依賴項。
第 5 步:在您的應用中初始化 Firebase
最後一步是將初始化代碼添加到您的應用程序中。作為將 Firebase 添加到您的應用的一部分,您可能已經完成了此操作。如果您使用的是快速入門示例項目,那麼我們已經為您完成了此操作。
- 在
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; // ...
- 在應用程序委託的
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];
- 如果您使用 SwiftUI,則必須創建一個應用程序委託並通過
UIApplicationDelegateAdaptor
或NSApplicationDelegateAdaptor
將其附加到您的App
結構。您還必須禁用應用程序委託調配。有關更多信息,請參閱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 存儲庫
服務或產品 | 豆莢 | 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 自述文件。
下載框架 SDK zip 。這是一個約 200MB 的文件,下載可能需要一些時間。
解壓縮文件,然後集成您想要包含在應用程序中的框架。
您可以在以下任一位置找到集成說明:
- 在Firebase iOS SDK GitHub 存儲庫中。
- 在下載的 zip 發行版中的
README.md
文件中。
有關框架版本或依賴項的信息,請參閱下載的 zip 發行版中的
METADATA.md
文件。在目標的構建設置中的
Other Linker Settings
中添加-ObjC
鏈接器標誌。
下一步
了解 Firebase:
訪問了解 Firebase 項目,詳細了解 Firebase 項目和項目最佳實踐。
獲得Firebase iOS Codelab的實踐經驗。
準備啟動您的應用程序:
- 在 Google Cloud Console 中為您的項目設置預算提醒。
- 監控 Firebase 控制台中的使用情況和計費信息中心,全面了解項目在多個 Firebase 服務中的使用情況。
- 查看Firebase 啟動清單。
Firebase 和您的 Apple 項目遇到問題?訪問Apple 平台故障排除和常見問題解答。
將 Firebase 服務添加到您的應用:
通過Analytics深入了解用戶行為。
使用Authentication設置用戶身份驗證。
使用Cloud Firestore或實時數據庫存儲數據,例如用戶信息。
使用Cloud Storage存儲照片和視頻等文件。
使用Cloud Functions觸發在安全環境中運行的後端代碼。
使用雲消息發送通知。
使用Crashlytics了解您的應用程序崩潰的時間和原因。