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

在您的 Apple 應用中安裝 Firebase

Swift 包管理器

與火力地堡蘋果SDK的V8.0.0開始,火力地堡的斯威夫特軟件包管理器支持功能的測試通常可以使用。 Swift Package Manager 用戶不需要 CocoaPods。

對於 Xcode 12.5 及更高版本,推薦使用 Swift Package Manager 安裝方法。

通過 Xcode

Swift Package Manager 支持需要 Xcode 12.5 或更高版本。

  1. 如果是從基於的CocoaPods項目遷移,運行pod deintegrate ,去掉你的Xcode項目的CocoaPods。該的CocoaPods生成.xcworkspace文件可以安全地刪除之後。如果您是第一次將 Firebase 添加到項目中,則可以忽略此步驟。

  2. 在Xcode中,導航到文件>斯威夫特軟件包安裝火力地堡庫>添加包的依賴...

  3. 在出現的提示中,選擇 Firebase GitHub 存儲庫:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. 選擇您要使用的 Firebase 版本。對於新項目,我們建議使用最新版本的 Firebase。

  5. 選擇要包含在應用中的 Firebase 庫。

完成後,Xcode 將開始解析您的包依賴項並在後台下載它們。

通過Package.swift

要通過整合火力地堡的斯威夫特包Package.swift清單,你可以添加火力地堡的dependencies你的包陣列。有關詳細信息,請參閱斯威夫特軟件包管理器文件

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

然後以依賴於一個火力地堡產品的任何目標,將其添加到dependencies數組該目標的。

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

特定於產品的注意事項

某些 Firebase 產品需要額外的集成步驟才能正常運行。

谷歌分析

谷歌Analytics(分析)需要添加-ObjC鏈接器標誌,以您的目標構建設置,如果包括及物動詞。

Crashlytics

Crashlytics 要求您上傳調試符號。

您可以使用 Xcode 的運行腳本構建階段來自動上傳構建後的調試符號。在這裡找到運行腳本:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

上載符號的另一種選擇是使用upload-symbols腳本。把腳本在您的項目文件的子目錄(例如scripts/upload-symbols ),那麼請確保腳本是可執行的:

chmod +x scripts/upload-symbols

此腳本可用於手動上傳 dSYM 文件。對於使用注意事項和腳本的附加說明,運行upload-symbols不帶任何參數。

可可豆

火力支持安裝用的CocoaPods除了斯威夫特軟件包管理器。

Firebase 的 CocoaPods 發行版需要 Xcode 12.5 和 CocoaPods 1.10.0 或更高版本。以下是使用 CocoaPods 安裝 Firebase 的方法:

  1. 如果您還沒有 Podfile,請創建一個 Podfile。從項目目錄的根目錄,運行以下命令:

    pod init
  2. 在 Podfile 中,添加要在應用中使用的 Firebase pod。

    您可以添加任何的支持火力地堡的產品為您的應用。

    啟用分析

    # 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,設備級的廣告標識,在蘋果公司的用戶隱私和數據使用應用跟踪透明度文檔。

    未啟用分析

    # 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 --repo-update
    open your-project.xcworkspace

特定於產品的注意事項

某些 Firebase 產品需要額外的集成步驟才能正常運行。

Crashlytics

Crashlytics 要求您上傳調試符號。

您可以使用 Xcode 的運行腳本構建階段來自動上傳構建後的調試符號。在這裡找到運行腳本:

"${PODS_ROOT}/FirebaseCrashlytics/run"

迦太基

迦太基支持是實驗性的。見GitHub上的指示進行,包括在火力地堡通過迦太基您的應用程序。

手動集成

Firebase 為希望在不使用依賴項管理器的情況下集成 Firebase 的用戶提供了預構建的二進制 XCFramework 分發版。要安裝 Firebase:

  1. 下載框架SDK的壓縮。此文件包含適用於所有 Firebase SDK 的所有可用目標架構的架構切片,因此下載可能需要一些時間。

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

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