Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

將 Firebase 添加到您的 iOS 項目

先決條件

  • 安裝以下內容:

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

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

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

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

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

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

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

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

  1. 轉至火力地堡控制台

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

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

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

  4. (可選)輸入其他應用程序的信息:應用程序的暱稱App Store的ID。

  5. 點擊註冊應用

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

  1. 點擊下載GoogleService-Info.plist中獲得你的火力地堡的iOS配置文件( GoogleService-Info.plist )。

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

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

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

我們建議您使用的CocoaPods安裝火力地堡庫。但是,如果你不想使用的CocoaPods,您可以直接集成SDK框架或使用雨燕包管理器來代替。

您是否正在使用的一個快速入門樣本 Xcode項目和Podfile(帶豆莢)已經存在,但你仍然需要添加火力地堡的配置文件安裝的豆莢。

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

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

    您可以添加任何的支持火力地堡產品到您的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'

    了解更多關於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. 安裝莢,然後打開你的.xcworkspace文件,看看在Xcode項目:

    pod install
    open your-project.xcworkspace

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

就是這樣!您可以直接跳到下一個步驟

如果你在設置時遇到問題,雖然有,請訪問iOS的故障排除和常見問題解答

可用豆莢

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

服務或產品豆莢添加分析?
廣告pod 'Google-Mobile-Ads-SDK'
分析pod 'Firebase/Analytics'
應用檢查pod 'Firebase/AppCheck'
應用分發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上的iOS火力地堡的README SDK

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

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

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

Swift 包管理器

了解更多關於在斯威夫特包管理器集成我們的導遊

下一步

了解 Firebase:

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