用于在 Apple 应用中安装 Firebase 的选项

Swift Package Manager

Firebase 建议对新项目使用 Swift Package Manager。

通过 Xcode

如需获得 Swift Package Manager 支持，您需要使用 16.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 Package Manager 文档。

dependencies: [

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

],

然后，在任何依赖于 Firebase 产品的目标中，将 Firebase 添加到该目标的 dependencies 数组中。

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

各产品特有的注意事项

对于某些 Firebase 产品，您需要执行额外的集成步骤才能确保其正常运行。

Google Analytics

如果以转换方式包含 -ObjC 链接器标记，Google Analytics 需要将其添加到目标的构建设置中。

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 16.2 和 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 FirebaseAnalytics/Core

# 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（设备级广告标识符），请参阅 Apple 的用户隐私和数据使用和 App Tracking Transparency 文档。

    未启用 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

Carthage 支持服务尚处于实验阶段。如需了解如何通过 Carthage 在应用中添加 Firebase，请参阅 GitHub 上的说明。

手动集成

Firebase 提供了一个预构建的二进制 XCFramework 发行版，适合希望在不使用依赖项管理器的情况下集成 Firebase 的用户。如需安装 Firebase，请执行以下操作：

  1. 下载框架 SDK zip。此文件包含适用于所有 Firebase SDK 的所有可用目标架构的架构切片，因此下载可能需要一些时间。

  2. 解压缩文件，然后查看要包含在应用中的框架的 README。

  3. 在目标的构建设置中，将 -ObjC 链接器标记添加到 Other Linker Settings 中。