在 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 或更高版本。

如果要从基于 CocoaPods 的项目迁移，请运行 pod deintegrate，从您的 Xcode 项目中移除 CocoaPods。之后可以安全地删除 CocoaPods 生成的 .xcworkspace 文件。如果您是第一次向项目添加 Firebase，可以忽略此步骤。
在 Xcode 中，转到 File（文件）> Add Packages（添加软件包）以安装 Firebase 库
在出现的提示中，选择 Firebase GitHub 代码库：
```
https://github.com/firebase/firebase-ios-sdk.git
```
选择您要使用的 Firebase 版本。对于新项目，我们建议使用最新版本的 Firebase。
选择要加入您应用中的 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 的方法如下：

如果您没有 Podfile，请创建一个：从您的项目目录的根目录中，运行以下命令：
```
pod init
```

将想要用在应用中的 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'

安装 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，请执行以下操作：

下载框架 SDK zip。此文件包含适用于所有 Firebase SDK 的所有可用目标架构的架构切片，因此下载可能需要一些时间。
解压缩文件，然后查看要包含在应用中的框架的 README。
在目标的构建设置中，将 -ObjC 链接器标记添加到 Other Linker Settings 中。

在 Apple 应用中安装 Firebase

Swift Package Manager

通过 Xcode

通过 Package.swift

各产品特有的注意事项

Google Analytics（分析）

Crashlytics

CocoaPods

已启用 Analytics

未启用 Analytics

各产品特有的注意事项

Crashlytics

Carthage

手动集成

通过 `Package.swift`