获取我们在 Firebase 峰会上发布的所有信息，了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

将 Firebase 添加到您的 Apple 项目

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

先决条件

  • 安装以下内容：

    • Xcode 13.3.1 或更高版本

  • 确保您的项目满足以下要求：

    • 您的项目必须针对这些平台版本或更高版本：
      • iOS 11
      • macOS 10.13
      • 电视操作系统 12
      • watchOS 6

  • 设置物理 Apple 设备或使用模拟器来运行您的应用程序。

如果您还没有 Xcode 项目并且只想试用 Firebase 产品，您可以下载我们的快速入门示例之一。

第 1 步：创建一个 Firebase 项目

在将 Firebase 添加到您的 Apple 应用程序之前，您需要创建一个 Firebase 项目以连接到您的应用程序。访问了解 Firebase 项目以了解有关 Firebase 项目的更多信息。

第 2 步：向 Firebase 注册您的应用

要在您的 Apple 应用程序中使用 Firebase，您需要在 Firebase 项目中注册您的应用程序。注册您的应用程序通常称为将您的应用程序“添加”到您的项目中。

  1. 转到Firebase 控制台。

  2. 在项目概览页面的中央，单击iOS+图标以启动设置工作流程。

    如果您已将应用程序添加到 Firebase 项目，请单击添加应用程序以显示平台选项。

  3. 在bundle ID字段中输入您应用程序的 bundle ID。

  4. （可选）输入其他应用信息：应用昵称和App Store ID 。

  5. 单击注册应用程序。

第 3 步：添加 Firebase 配置文件

  1. 单击下载 GoogleService-Info.plist以获取您的 Firebase Apple 平台配置文件 ( GoogleService-Info.plist )。

  2. 将配置文件移动到 Xcode 项目的根目录中。如果出现提示，请选择将配置文件添加到所有目标。

如果您的项目中有多个 bundle ID，则必须将每个 bundle ID 与 Firebase 控制台中注册的应用相关联，以便每个应用都可以拥有自己的GoogleService-Info.plist文件。

第 4 步：将 Firebase SDK 添加到您的应用

使用 Swift Package Manager 安装和管理 Firebase 依赖项。

  1. 在 Xcode 中，打开您的应用程序项目，导航至File > Add Packages 。
  2. 出现提示时，添加 Firebase Apple 平台 SDK 存储库：
    3.   https://github.com/firebase/firebase-ios-sdk
  3. 选择您要使用的 SDK 版本。

  4. 选择您要使用的 Firebase 库。

    如果在您的 Firebase 项目中启用了 Google Analytics，请确保添加FirebaseAnalytics 。对于没有 IDFA 收集功能的 Analytics，请改为添加FirebaseAnalyticsWithoutAdId 。

完成后，Xcode 将自动开始在后台解析和下载您的依赖项。

第 5 步：在您的应用中初始化 Firebase

最后一步是将初始化代码添加到您的应用程序中。作为将 Firebase 添加到您的应用程序的一部分，您可能已经完成了此操作。如果您使用的是快速入门示例项目，这已经为您完成了。

  1. 在您的UIApplicationDelegate中导入FirebaseCore模块，以及您的应用委托使用的任何其他Firebase 模块。例如，要使用 Cloud Firestore 和身份验证：

    斯威夫特用户界面

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    迅速

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    目标-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. 在您的应用委托的application(_:didFinishLaunchingWithOptions:)方法中配置一个FirebaseApp共享实例：

    斯威夫特用户界面

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    迅速

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    目标-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. 如果您使用的是 SwiftUI，则必须创建一个应用程序委托并通过UIApplicationDelegateAdaptor或NSApplicationDelegateAdaptor将其附加到您的App结构。您还必须禁用应用委托调配。有关详细信息，请参阅SwiftUI 说明。

    斯威夫特用户界面

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. 如果您已包含适用于 Google Analytics 的 Firebase SDK，则可以运行您的应用程序以向 Firebase 控制台发送验证，表明您已成功安装 Firebase。

就是这样！您可以跳到下一步。

不过，如果您在设置时遇到问题，请访问Apple 平台故障排除和常见问题解答。

可用库

本部分列出了 Apple 平台支持的 Firebase 产品。详细了解这些 Firebase Apple 平台库：

服务或产品豆荚SwiftPM 库添加分析？
AdMob pod 'Google-Mobile-Ads-SDK'不适用
分析pod 'FirebaseAnalytics' FirebaseAnalytics
应用检查pod 'FirebaseAppCheck' FirebaseAppCheck
应用分发pod 'FirebaseAppDistribution' FirebaseAppDistribution
验证pod 'FirebaseAuth' FirebaseAuth
云端 Firestore pod 'FirebaseFirestore' FirebaseFirestore
Firebase 客户端 SDK 的云函数pod 'FirebaseFunctions' FirebaseFunctions
云消息pod 'FirebaseMessaging' FirebaseMessaging
云储存pod 'FirebaseStorage' FirebaseStorage
崩溃分析pod 'FirebaseCrashlytics' FirebaseCrashlytics
动态链接pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
应用内消息pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
（必需的）
Firebase 安装pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML 自定义模型 API pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
性能监控pod 'FirebasePerformance' FirebasePerformance
实时数据库pod 'FirebaseDatabase' FirebaseDatabase
远程配置pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

不使用 Swift 包管理器进行集成

如果您不想使用 Swift Package Manager，您仍然可以通过使用 CocoaPods 或直接导入框架来利用 Firebase SDK。

可可豆

在我们的指南中了解有关 CocoaPods 集成的更多信息。

构架

除了支持 iOS 平台外，该 zip 现在还包含.xcframework文件。有关详细信息，请参阅GitHub 上的 Firebase Apple 平台 SDK 自述文件。

  1. 下载框架 SDK zip 。这是一个约 200MB 的文件，下载可能需要一些时间。

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

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

下一步

了解 Firebase：

将 Firebase 服务添加到您的应用：

,

先决条件

  • 安装以下内容：

    • Xcode 13.3.1 或更高版本

  • 确保您的项目满足以下要求：

    • 您的项目必须针对这些平台版本或更高版本：
      • iOS 11
      • macOS 10.13
      • 电视操作系统 12
      • watchOS 6

  • 设置物理 Apple 设备或使用模拟器来运行您的应用程序。

如果您还没有 Xcode 项目并且只想试用 Firebase 产品，您可以下载我们的快速入门示例之一。

第 1 步：创建一个 Firebase 项目

在将 Firebase 添加到您的 Apple 应用程序之前，您需要创建一个 Firebase 项目以连接到您的应用程序。访问了解 Firebase 项目以了解有关 Firebase 项目的更多信息。

第 2 步：向 Firebase 注册您的应用

要在您的 Apple 应用程序中使用 Firebase，您需要在 Firebase 项目中注册您的应用程序。注册您的应用程序通常称为将您的应用程序“添加”到您的项目中。

  1. 转到Firebase 控制台。

  2. 在项目概览页面的中央，单击iOS+图标以启动设置工作流。

    如果您已将应用程序添加到 Firebase 项目，请单击添加应用程序以显示平台选项。

  3. 在bundle ID字段中输入您应用程序的 bundle ID。

  4. （可选）输入其他应用信息：应用昵称和App Store ID 。

  5. 单击注册应用程序。

第 3 步：添加 Firebase 配置文件

  1. 单击下载 GoogleService-Info.plist以获取您的 Firebase Apple 平台配置文件 ( GoogleService-Info.plist )。

  2. 将配置文件移动到 Xcode 项目的根目录中。如果出现提示，请选择将配置文件添加到所有目标。

如果您的项目中有多个 bundle ID，则必须将每个 bundle ID 与 Firebase 控制台中注册的应用相关联，以便每个应用都可以拥有自己的GoogleService-Info.plist文件。

第 4 步：将 Firebase SDK 添加到您的应用

使用 Swift Package Manager 安装和管理 Firebase 依赖项。

  1. 在 Xcode 中，打开您的应用程序项目，导航至File > Add Packages 。
  2. 出现提示时，添加 Firebase Apple 平台 SDK 存储库：
    3.   https://github.com/firebase/firebase-ios-sdk
  3. 选择您要使用的 SDK 版本。

  4. 选择您要使用的 Firebase 库。

    如果在您的 Firebase 项目中启用了 Google Analytics，请确保添加FirebaseAnalytics 。对于没有 IDFA 收集功能的 Analytics，请改为添加FirebaseAnalyticsWithoutAdId 。

完成后，Xcode 将自动开始在后台解析和下载您的依赖项。

第 5 步：在您的应用中初始化 Firebase

最后一步是将初始化代码添加到您的应用程序中。作为将 Firebase 添加到您的应用程序的一部分，您可能已经完成了此操作。如果您使用的是快速入门示例项目，这已经为您完成了。

  1. 在您的UIApplicationDelegate中导入FirebaseCore模块，以及您的应用委托使用的任何其他Firebase 模块。例如，要使用 Cloud Firestore 和身份验证：

    斯威夫特用户界面

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    迅速

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    目标-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. 在您的应用委托的application(_:didFinishLaunchingWithOptions:)方法中配置一个FirebaseApp共享实例：

    斯威夫特用户界面

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    迅速

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    目标-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. 如果您使用的是 SwiftUI，则必须创建一个应用程序委托并通过UIApplicationDelegateAdaptor或NSApplicationDelegateAdaptor将其附加到您的App结构。您还必须禁用应用委托调配。有关详细信息，请参阅SwiftUI 说明。

    斯威夫特用户界面

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. 如果您已包含适用于 Google Analytics 的 Firebase SDK，则可以运行您的应用程序以向 Firebase 控制台发送验证，表明您已成功安装 Firebase。

就是这样！您可以跳到下一步。

不过，如果您在设置时遇到问题，请访问Apple 平台故障排除和常见问题解答。

可用库

本部分列出了 Apple 平台支持的 Firebase 产品。详细了解这些 Firebase Apple 平台库：

服务或产品豆荚SwiftPM 库添加分析？
AdMob pod 'Google-Mobile-Ads-SDK'不适用
分析pod 'FirebaseAnalytics' FirebaseAnalytics
应用检查pod 'FirebaseAppCheck' FirebaseAppCheck
应用分发pod 'FirebaseAppDistribution' FirebaseAppDistribution
验证pod 'FirebaseAuth' FirebaseAuth
云端 Firestore pod 'FirebaseFirestore' FirebaseFirestore
Firebase 客户端 SDK 的云函数pod 'FirebaseFunctions' FirebaseFunctions
云消息pod 'FirebaseMessaging' FirebaseMessaging
云储存pod 'FirebaseStorage' FirebaseStorage
崩溃分析pod 'FirebaseCrashlytics' FirebaseCrashlytics
动态链接pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
应用内消息pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
（必需的）
Firebase 安装pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML 自定义模型 API pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
性能监控pod 'FirebasePerformance' FirebasePerformance
实时数据库pod 'FirebaseDatabase' FirebaseDatabase
远程配置pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

不使用 Swift 包管理器进行集成

如果您不想使用 Swift Package Manager，您仍然可以通过使用 CocoaPods 或直接导入框架来利用 Firebase SDK。

可可豆

在我们的指南中了解有关 CocoaPods 集成的更多信息。

构架

除了支持 iOS 平台外，该 zip 现在还包含.xcframework文件。有关详细信息，请参阅GitHub 上的 Firebase Apple 平台 SDK 自述文件。

  1. 下载框架 SDK zip 。这是一个约 200MB 的文件，下载可能需要一些时间。

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

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

下一步

了解 Firebase：

将 Firebase 服务添加到您的应用：