了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

在 Apple 应用中安装 Firebase

Swift Package Manager

从 Firebase iOS SDK v8.0.0 开始,Firebase 的 Swift Package Manager 支持 Beta 版测试就已经结束,现已正式推出。Swift Package Manager 用户不需要使用 CocoaPods。

对于 Firebase 版本 8 及更高版本,建议使用 Swift Package Manager 安装。

通过 Xcode

如需获得 Swift Package Manager 支持,您需要使用 13.3.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 产品的目标中,将 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 13.3.1 和 CocoaPods 1.10.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(设备级广告标识符),请参阅 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 中。