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

Swift 套件管理員

Firebase 建議使用 Swift Package Manager 來處理新專案。

透過 Xcode

Swift Package Manager 必須支援 14.1 以上版本。

  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 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

除了 Swift 套件管理員以外，Firebase 也支援使用 CocoaPods 安裝。

Firebase 的 CocoaPods 發布需要 Xcode 14.1 和 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'

    如要進一步瞭解廣告識別碼 (裝置層級廣告 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 為希望在不使用依附元件管理員的情況下整合 Firebase 的使用者，提供預先建構的二進位 XCFramework 發布。如要安裝 Firebase，請按照下列步驟操作：

  1. 下載架構 SDK ZIP 檔案。這個檔案包含所有 Firebase SDK 所有可用目標架構的架構配量，因此可能需要一段時間才能完成下載。

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

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