使用 Swift Package Manager 安装 Firebase

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

通过 Xcode

如需获得 Swift Package Manager 支持,您需要使用 Xcode 12.5 或更高版本。

  1. 如果要从基于 CocoaPods 的项目迁移,请运行 pod deintegrate,从您的 Xcode 项目中移除 CocoaPods。之后可以安全地删除 CocoaPods 生成的 .xcworkspace 文件。如果您是第一次向项目添加 Firebase,可以忽略此步骤。

  2. 在 Xcode 中,转到 File > Swift Packages > Add Package Dependency... 以安装 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(分析)

如果使用 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(不带任何参数)。