在您的 Apple 应用中安装 Firebase

Swift 包管理器

从 Firebase Apple SDK 的 v8.0.0 开始,Firebase 的Swift 包管理器支持已经过测试版,并且可以普遍使用。 Swift Package Manager 用户不需要 CocoaPods。

对于 Xcode 12.5 及更高版本,Swift Package Manager 是推荐的安装方法。

通过 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 包管理器文档

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 需要将-ObjC链接器标志添加到目标的构建设置中。

崩溃分析器

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

可可豆荚

除了 Swift 包管理器之外,Firebase 还支持使用CocoaPods进行安装。

Firebase 的 CocoaPods 发行版需要 Xcode 12.5 和 CocoaPods 1.10.0 或更高版本。以下是使用 CocoaPods 安装 Firebase 的方法:

  1. 如果您还没有 Podfile,请创建一个。从项目目录的根目录运行以下命令:

    pod init
  2. 在您的 Podfile 中,添加您要在应用中使用的 Firebase pod。

    您可以将任何受支持的 Firebase 产品添加到您的应用中。

    启用分析

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

    在 Apple 的用户隐私和数据使用以及App Tracking Transparency文档中了解有关 IDFA(设备级广告标识符)的更多信息。

    未启用分析

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. 安装 pod,然后打开.xcworkspace文件以在 Xcode 中查看项目:

    pod install --repo-update
    open your-project.xcworkspace

特定于产品的注意事项

某些 Firebase 产品需要额外的集成步骤才能正常运行。

崩溃分析器

Crashlytics 要求您上传调试符号。

您可以使用 Xcode 的运行脚本构建阶段在构建后自动上传调试符号。在这里找到运行脚本:

"${PODS_ROOT}/FirebaseCrashlytics/run"

迦太基

迦太基支持是实验性的。有关通过 Carthage 在您的应用中包含 Firebase 的说明,请参阅 GitHub 上的说明。

手动集成

Firebase 为想要在不使用依赖管理器的情况下集成 Firebase 的用户提供预构建的二进制 XCFramework 分发。要安装 Firebase:

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

  2. 解压缩文件,然后查看README以了解要包含在应用程序中的框架。

  3. 在目标构建设置的Other Linker Settings-ObjC链接器标志