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

将 Firebase 添加到您的 Apple 项目

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

先决条件

  • 安装以下内容:

    • Xcode 13.3.1 或更高版本
  • 确保您的项目满足以下要求:

    • 您的项目必须针对这些平台版本或更高版本:
      • iOS 11
      • macOS 10.13
      • 电视操作系统 12
      • 手表操作系统 6
  • 设置物理 Apple 设备或使用模拟器来运行您的应用程序。

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

第 1 步:创建 Firebase 项目

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

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

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

  1. 转到Firebase 控制台

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

    如果您已将应用添加到 Firebase 项目,请点击添加应用以显示平台选项。

  3. 捆绑包 ID字段中输入您应用的捆绑包 ID。

  4. (可选)输入其他应用信息:应用昵称应用商店ID

  5. 点击注册应用

第 3 步:添加 Firebase 配置文件

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

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

如果您的项目中有多个捆绑包 ID,则必须将每个捆绑包 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
  4. 选择您要使用的 SDK 版本。
  5. 选择您要使用的 Firebase 库。

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

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

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

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

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

    迅速

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

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

    迅速

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 如果您已包含适用于 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
云防火墙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 包管理器,您仍然可以通过使用 CocoaPods 或直接导入框架来利用 Firebase SDK。

可可豆荚

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

构架

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

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

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

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

下一步

了解 Firebase:

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