在您的 Apple 应用中安装 Firebase

斯威夫特包管理器

从 Firebase Apple SDK 的 v8.0.0 开始，Firebase 的Swift Package Manager支持已结束测试版并已普遍可用。 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 中，通过导航到文件 > 添加包来安装 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 Package Manager 之外，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 支持是实验性的。请参阅GitHub 上的说明，了解如何通过 Carthage 在您的应用中包含 Firebase。

手动集成

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

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

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

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