將 Firebase 添加到您的 Apple 項目

先決條件

  • 安裝以下內容：

    • Xcode 12.5 或更高版本

  • 確保您的項目滿足以下要求：

    • 您的項目必須針對以下平台版本或更高版本：
      • iOS 10
      • macOS 10.12
      • tvOS 12
      • 手錶操作系統 6

  • 設置物理 Apple 設備或使用模擬器來運行您的應用程序。

如果你不已經有一個Xcode項目，只是想嘗試一個火力地堡的產品，你可以下載我們的一個入門示例。

第1步：創建一個火力地堡項目

在將 Firebase 添加到 Apple 應用之前，您需要創建一個 Firebase 項目以連接到您的應用。參觀了解火力地堡項目，詳細了解項目的火力地堡。

第2步：註冊與火力地堡您的應用程序

在您擁有 Firebase 項目後，您可以向其中添加您的 Apple 應用程序。

參觀了解火力地堡項目，詳細了解最佳實踐和注意事項添加應用到火力地堡項目，包括如何處理多個構建變種。

  1. 轉至火力地堡控制台。

  2. 在項目概述頁面的中心，點擊iOS +圖標來啟動安裝工作流程。

    如果您已經添加的應用程序到你的火力地堡項目，單擊添加應用程序，以顯示平台的選擇。

  3. 在包ID字段中輸入您的應用程序的包ID。

  4. （可選）輸入其他應用程序的信息：應用程序的暱稱和App Store的ID。

  5. 點擊註冊應用。

第3步：添加火力地堡配置文件

  1. 點擊下載GoogleService-Info.plist中獲得你的火力地堡蘋果平台的配置文件（ GoogleService-Info.plist ）。

  2. 將您的配置文件移動到 Xcode 項目的根目錄中。如果出現提示，請選擇將配置文件添加到所有目標。

如果你在你的項目中有多個包ID，必須每捆ID用在火力地堡控制台，以便每個應用程序都可以有自己的註冊應用關聯GoogleService-Info.plist文件。

第4步：添加火力地堡的SDK到您的應用

使用 Swift Package Manager 安裝和管理 Firebase 依賴項。

  1. 在Xcode中，您的應用項目打開，導航到File>斯威夫特包>添加包的依賴。
  2. 出現提示時，添加 Firebase Apple 平台 SDK 存儲庫：
    3.   https://github.com/firebase/firebase-ios-sdk
  3. 選擇要使用的 SDK 版本。

  4. 選擇您要使用的 Firebase 庫。

    如果谷歌Analytics（分析）在您的火力地堡項目啟用，確保添加FirebaseAnalytics 。對於沒有IDFA收集能力分析，加FirebaseAnalyticsWithoutAdId代替。

完成後，Xcode 將在後台自動開始解析和下載您的依賴項。

第5步：初始化火力地堡在您的應用程序

最後一步是向應用程序添加初始化代碼。您可能已經在將 Firebase 添加到您的應用程序的過程中完成了此操作。如果您使用的是快速啟動示例項目，這已經為你做。

  1. 導入火力地堡模塊在UIApplicationDelegate ：

    迅速

    import Firebase

    目標-C

    @import Firebase;
  2. 配置一個FirebaseApp共享實例，通常在你的應用程序的application:didFinishLaunchingWithOptions:方法：

    迅速

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

    目標-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. 如果您已包含適用於 Google Analytics 的 Firebase SDK，則可以運行您的應用以向 Firebase 控制台發送您已成功安裝 Firebase 的驗證。

而已！您可以直接跳到下一個步驟。

如果你在設置時遇到問題，雖然有，請訪問蘋果平台的故障排除和常見問題解答。

可用庫

本部分列出了 Apple 平台支持的 Firebase 產品。詳細了解這些 Firebase Apple 平台庫：

服務或產品豆莢SwiftPM 庫添加分析？
廣告pod 'Google-Mobile-Ads-SDK'不適用
分析pod 'Firebase/Analytics' FirebaseAnalytics
應用檢查pod 'Firebase/AppCheck' FirebaseAppCheck
應用分發pod 'Firebase/AppDistribution' FirebaseAppDistribution
驗證pod 'Firebase/Auth' FirebaseAuth
雲防火牆pod 'Firebase/Firestore' FirebaseFirestore
Firebase 客戶端 SDK 的雲函數pod 'Firebase/Functions' FirebaseFunctions
雲消息pod 'Firebase/Messaging' FirebaseMessaging
雲儲存pod 'Firebase/Storage' FirebaseStorage
Crashlytics pod 'Firebase/Crashlytics' FirebaseCrashlytics
動態鏈接pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
應用內消息pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
（必需的）
Firebase 安裝pod 'Firebase/Installations' FirebaseInstallations
Firebase ML 自定義模型 API pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
性能監控pod 'Firebase/Performance' FirebasePerformance
實時數據庫pod 'Firebase/Database' FirebaseDatabase
遠程配置pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

無需依賴管理器即可集成

如果您不想使用 Swift Package Manager，您仍然可以通過直接導入框架或使用 CocoaPods 來利用 Firebase SDK。

構架

除了支持iOS平台，拉鍊現在包括.xcframework文件。有關詳細信息，請參閱該火力地堡蘋果平台SDK README GitHub上。

  1. 下載框架SDK的壓縮。這是一個約 200MB 的文件，下載可能需要一些時間。

  2. 解壓縮文件，然後查看README為您希望在您的應用程序包括框架。

  3. 添加-ObjC鏈接器標記您的Other Linker Settings你的目標的構建設置。

可可豆

了解更多有關的CocoaPods整合我們的導遊。

下一步

了解 Firebase：

將 Firebase 服務添加到您的應用：