Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

將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'
    # 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'

    尚未啟用分析

    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. 將Firebase模塊導入UIApplicationDelegate

    迅速

    import Firebase

    物鏡

    @import Firebase;
  2. 配置FirebaseApp共享實例,通常在應用程序的application:didFinishLaunchingWithOptions:方法中:

    迅速

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

    物鏡

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 如果您已包括Firebase Analytics,則可以運行您的應用程序以將驗證發送到已成功安裝Firebase的Firebase控制台。

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

可用豆莢

本部分列出了iOS及其Pod支持的Firebase產品。了解有關這些Firebase iOS庫的更多信息:

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

無需CocoaPods即可集成

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

構架

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

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

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

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

迅捷軟件包管理器

Swift Package Manager支持目前處於測試階段。請遵循GitHub上文檔,並將任何反饋提交給GitHub問題跟踪器

下一步

了解有關Firebase的信息:

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