Catch up on everthing we announced at this year's Firebase Summit. Learn more

將 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
      
  4. 選擇要使用的 SDK 版本。
  5. 選擇您要使用的 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 服務添加到您的應用: