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

Swift 套件管理工具

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

透過 Xcode

Swift Package Manager 的支援服務需要 14.1 以上版本。

  1. 如果是從 CocoaPods 為基礎的專案遷移，請執行 pod deintegrate 來將 CocoaPods 從 Xcode 專案中移除。之後可以安全刪除 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 14.1 和 CocoaPods 1.12.0 以上版本。以下說明如何使用 CocoaPods 安裝 Firebase：

  1. 如果您尚未建立 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 連結器標記。