在 Apple 應用程式中安裝 Firebase 的選項

Swift 套件管理工具

Firebase 建議使用 Swift Package Manager 建立新專案。

透過 Xcode

Swift Package Manager 需要 15.2 以上版本才能支援 Swift 套件管理員。

  1. 如果是從 CocoaPods 為基礎的專案遷移，請執行 pod deintegrate 來移除 擷取 Xcode 專案中的 CocoaPodsCocoaPods 產生的.xcworkspace 檔案即可安全刪除將 Firebase 加入專案時 可略過這個步驟。

  2. 在 Xcode 中，依序點選「File」>「Add Packages」，即可安裝 Firebase 程式庫。

  3. 在隨即顯示的提示中，選取 Firebase GitHub 存放區：

    https://github.com/firebase/firebase-ios-sdk.git

  4. 選取要使用的 Firebase 版本。以新專案來說 建議使用最新版 Firebase。

  5. 選擇要納入應用程式的 Firebase 程式庫。

完成後，Xcode 就會開始解析套件依附元件 並在背景下載及下載

走Package.swift

如要透過 Package.swift 資訊清單將 Firebase 整合到 Swift 套件，您可以 將 Firebase 加入套件的 dependencies 陣列中。詳情請參閱 Swift Package Manager 說明文件。

dependencies: [

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

],

接著在依賴 Firebase 的任何目標中，將該產品加入 dependencies 陣列 目標資源

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

特定產品注意事項

部分 Firebase 產品需要額外的整合步驟才能運作 正確。

Google Analytics

使用 Google 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 以及 Swift Package Manager 以外的額外功能

Firebase 的 CocoaPods 發行版需要 Xcode 15.2 和 CocoaPods 1.12.0 以上版本。以下是使用 CocoaPods 安裝 Firebase 的方式：

  1. 如果您尚未建立 Podfile，請建立一個。從 ，請執行下列指令：

    pod init
    敬上

  2. 在 Podfile 中新增要用於應用程式的 Firebase Pod。

    您可以將任何支援的 Firebase 產品新增至應用程式。

    已啟用 Analytics

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# 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 'FirebaseAuth'
pod 'FirebaseFirestore'

    進一步瞭解 IDFA (裝置層級廣告 ID)。請前往 Apple 的 使用者隱私權和資料使用方式 和 應用程式追蹤資訊公開 說明文件。

    未啟用「Analytics」

    # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

  3. 安裝 Pod，然後開啟 .xcworkspace 檔案即可在 Xcode：

    pod install --repo-update
     
    open your-project.xcworkspace

特定產品注意事項

部分 Firebase 產品需要額外的整合步驟才能運作 正確。

Crashlytics

「Crashlytics」要求你上傳偵錯符號。

你可以透過執行指令碼建構階段，讓 Xcode 自動上傳偵錯 加上符號執行指令碼的位置如下：

"${PODS_ROOT}/FirebaseCrashlytics/run"

迦太基

車輛支援功能仍在實驗階段，詳情請參閱 GitHub 的操作說明 透過 Carthage 將 Firebase 納入應用程式

手動整合

Firebase 提供預建的二進位 XCFramework 發布功能，滿足各種需求的使用者 ，不必使用依附元件管理工具即可整合 Firebase。如要安裝 Firebase，請按照下列步驟操作：

  1. 下載架構 SDK ZIP。這個檔案包含所有 Firebase SDK 可用的目標架構的架構切片，因此下載時間可能會比較久。

  2. 解壓縮檔案，然後查看 README 並找出您想要的架構 納入你的應用程式

  3. 新增 -ObjC 連結器 標記 Other Linker Settings。