Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

將 Firebase 添加到您的 iOS 項目

先決條件

  • 安裝以下內容:

    • Xcode 12.2 或更高版本
    • CocoaPods 1.10.0 或更高版本
  • 確保您的項目滿足以下要求:

    • 您的項目必鬚麵向 iOS 10 或更高版本。
  • 設置物理 iOS 設備或使用 iOS 模擬器運行您的應用程序。

如果您還沒有 Xcode 項目並且只想試用 Firebase 產品,您可以下載我們的快速入門示例之一

第 1 步:創建 Firebase 項目

在將 Firebase 添加到您的 iOS 應用之前,您需要創建一個 Firebase 項目以連接到您的 iOS 應用。訪問了解 Firebase 項目以了解有關 Firebase 項目的更多信息。

第 2 步:向 Firebase 註冊您的應用

擁有 Firebase 項目後,您可以向其中添加您的 iOS 應用。

訪問了解 Firebase 項目,詳細了解將應用添加到 Firebase 項目的最佳做法和注意事項,包括如何處理多個構建變體。

  1. 轉到Firebase 控制台

  2. 在項目概覽頁面的中心,單擊iOS圖標 ( ) 以啟動設置工作流程。

    如果您已將應用添加到 Firebase 項目,請點擊添加應用以顯示平台選項。

  3. iOS 捆綁包 ID字段中輸入您應用的捆綁包 ID

  4. (可選)輸入其他應用信息:應用暱稱應用商店ID

  5. 點擊註冊應用程序

第 3 步:添加 Firebase 配置文件

  1. 單擊下載 GoogleService-Info.plist以獲取您的 Firebase iOS 配置文件 ( GoogleService-Info.plist )。

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

如果您的項目中有多個包 ID,則必須將每個包 ID 與 Firebase 控制台中註冊的應用相關聯,以便每個應用都可以擁有自己的GoogleService-Info.plist文件。

第 4 步:將 Firebase SDK 添加到您的應用

我們建議使用CocoaPods來安裝 Firebase 庫。但是,如果您不想使用 CocoaPods,則可以直接集成 SDK 框架或使用Swift Package Manager

您是否在使用快速入門示例之一 Xcode 項目和 Podfile(帶有 Pod)已經存在,但您仍需要添加 Firebase 配置文件安裝Pod。

  1. 如果您還沒有 Podfile,請創建一個:

    cd your-project-directory
    pod init
  2. 在 Podfile 中,添加要在應用中使用的 Firebase pod。

    您可以將任何受支持的 Firebase 產品添加到您的 iOS 應用。

    啟用分析

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'

    在 Apple 的用戶隱私和數據使用App 跟踪透明度文檔中了解有關 IDFA(設備級廣告標識符)的更多信息。

    未啟用分析

    platform :ios, ‘10.0’
    # Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'
  3. 安裝 Pod,然後打開.xcworkspace文件以在 Xcode 中查看項目:

    pod install
    open your-project.xcworkspace

第 5 步:在您的應用中初始化 Firebase

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

  1. UIApplicationDelegate導入 Firebase 模塊:

    迅速

    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. 如果您已包含 Firebase Analytics,則可以運行您的應用以向 Firebase 控制台發送您已成功安裝 Firebase 的驗證。

就是這樣!您可以跳到下一步

但是,如果您在設置時遇到問題,請訪問iOS 故障排除和常見問題解答

可用豆莢

本部分列出了 iOS 支持的 Firebase 產品及其 pod。詳細了解這些 Firebase iOS 庫:

服務或產品豆莢添加分析?
廣告pod 'Google-Mobile-Ads-SDK'
分析pod 'Firebase/Analytics'
應用分發pod 'Firebase/AppDistribution'
驗證pod 'Firebase/Auth'
雲防火牆pod 'Firebase/Firestore'
Firebase 客戶端 SDK 的雲函數pod 'Firebase/Functions'
雲消息pod 'Firebase/Messaging'
雲儲存pod 'Firebase/Storage'
Crashlytics pod 'Firebase/Crashlytics'
動態鏈接pod 'Firebase/DynamicLinks'
應用內消息pod 'Firebase/InAppMessaging'
(必需的)
Firebase 安裝pod 'Firebase/Installations'
Firebase ML 自定義模型 API pod 'Firebase/MLModelDownloader'
性能監控pod 'Firebase/Performance'
實時數據庫pod 'Firebase/Database'
遠程配置pod 'Firebase/RemoteConfig'

無需 CocoaPods 即可集成

如果您不想使用 Cocoapods,您仍然可以通過直接導入框架或使用 Swift 包管理器來利用 Firebase SDK。

構架

除了支持 iOS 平台之外,該 zip 文件現在還包含 .xcframework 文件,這些文件添加了基於社區的 Catalyst 支持。有關詳細信息,請參閱GitHub 上的 Firebase iOS SDK 自述文件

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

  2. 解壓縮文件,然後查看您要包含在應用程序中的框架的README文件。

  3. 在目標構建設置的Other Linker Settings中添加ObjC鏈接器標誌

Swift 包管理器

我們的指南中了解有關 Swift Package Manager 集成的更多信息。

下一步

了解 Firebase:

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