欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

在您的 Apple 应用中安装 Firebase

Swift 包管理器

从 Firebase Apple SDK 的 v8.0.0 开始,Firebase 的Swift 包管理器支持已经过测试版,并且可以普遍使用。 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 包管理器文档

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 13.3.1 和 CocoaPods 1.10.0 或更高版本。以下是使用 CocoaPods 安装 Firebase 的方法:

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

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

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

    启用分析

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

    在 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 'FirebaseAuth'
    pod 'FirebaseFirestore'
  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链接器标志