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

Swift 套件管理工具

Firebase 建議您在新專案中使用 Swift Package Manager。

透過 Xcode

如要支援 Swift Package Manager，則必須使用 15.2 以上版本。

  1. 如果您要從以 CocoaPods 為基礎的專案遷移，請執行 pod deintegrate 來從 Xcode 專案中移除 CocoaPods。之後，您可以放心刪除 CocoaPods 產生的 .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 套件管理員說明文件。

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

除了 Swift Package Manager，Firebase 也支援使用 CocoaPods 進行安裝。

Firebase 的 CocoaPods 發布項目需要 Xcode 15.2 和 CocoaPods 1.12.0 以上版本。以下說明如何使用 CocoaPods 安裝 Firebase：

  1. 如果您沒有 Podfile，請先建立 Podfile。在專案目錄的根目錄中執行下列指令：

    pod init

  2. 將您要在應用程式中使用的 Firebase Pod 新增至 Podfile。

    您可以將任何支援的 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"

迦太基

車輛支援功能仍在實驗階段，如要透過 Carthage 在應用程式中加入 Firebase，請參閱 GitHub 上的操作說明。

手動整合

Firebase 提供預先建構的二進位 XCFramework 發布功能，適用於想在不使用依附元件管理員的情況下整合 Firebase 的使用者。如要安裝 Firebase，請按照下列步驟操作：

  1. 下載架構 SDK ZIP。這個檔案包含所有 Firebase SDK 可用的目標架構的架構切片，因此下載可能需要一些時間。

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

  3. 在目標的建構設定中，在 Other Linker Settings 中新增 -ObjC 連結器標記。