Firebase 实时数据库是一个云托管的数据库。数据以 JSON 格式存储并实时同步到每个连接的客户端。当您使用我们的 Android、iOS 和 JavaScript SDK 构建跨平台应用程序时,您的所有客户端共享一个实时数据库实例并自动接收包含最新数据的更新。
Firebase 实时数据库适用于所有 Apple 平台,包括 iOS、macOS、macOS Catalyst、tvOS 和 watchOS。它不适用于轻 App。本页中的设置说明在特定示例中引用了 iOS,但它们是通用的,适用于任何 Apple 平台目标。
先决条件
- 安装 Firebase SDK 。
- 在Firebase 控制台中将您的应用程序添加到您的 Firebase 项目。
创建数据库
导航到Firebase 控制台的实时数据库部分。系统会提示您选择一个现有的 Firebase 项目。遵循数据库创建工作流程。
为您的 Firebase 安全规则选择启动模式:
- 测试模式
适合开始使用移动和 Web 客户端库,但允许任何人读取和覆盖您的数据。测试后,请务必查看了解 Firebase 实时数据库规则部分。
要开始使用 Web、Apple 或 Android SDK,请选择测试模式。
- 锁定模式
拒绝来自移动和 Web 客户端的所有读取和写入。经过身份验证的应用程序服务器仍然可以访问您的数据库。
选择数据库的位置。
根据数据库的位置,新数据库的 URL 将采用以下形式之一:
DATABASE_NAME .firebaseio.com
(对于us-central1
中的数据库)DATABASE_NAME . REGION .firebasedatabase.app
(对于所有其他位置的数据库)
单击完成。
当您启用实时数据库时,它还会启用Cloud API Manager中的 API。
将 Firebase 实时数据库添加到您的应用
使用 Swift Package Manager 安装和管理 Firebase 依赖项。
- 在 Xcode 中,打开您的应用程序项目,导航至File > Add Packages 。
- 出现提示时,添加 Firebase Apple 平台 SDK 存储库:
- 选择实时数据库库。
- 完成后,Xcode 将自动开始在后台解析和下载您的依赖项。
https://github.com/firebase/firebase-ios-sdk
配置实时数据库规则
实时数据库提供了一种声明性规则语言,允许您定义数据的结构、索引方式以及何时可以读取和写入数据。
设置 Firebase 实时数据库
在创建或使用任何 Firebase 应用引用之前,您必须初始化 Firebase。如果您已经为另一个 Firebase 功能完成了此操作,则可以跳过此步骤。
- 在您的
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; // ...
- 在您的应用委托的
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];
- 如果您使用的是 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() } } } }
- 创建对数据库的引用并指定要写入的位置。
迅速
注意:此 Firebase 产品不适用于 App Clip 目标。var ref: DatabaseReference! ref = Database.database().reference()
目标-C
注意:此 Firebase 产品不适用于 App Clip 目标。@property (strong, nonatomic) FIRDatabaseReference *ref; self.ref = [[FIRDatabase database] reference];
下一步
了解如何为实时数据库构建数据结构。
准备启动您的应用程序:
启用App Check以帮助确保只有您的应用程序可以访问您的数据库。
在 Google Cloud Console 中为您的项目设置预算提醒。
监控 Firebase 控制台中的使用情况和计费仪表板,以全面了解项目在多个 Firebase 服务中的使用情况。您还可以访问实时数据库使用情况仪表板以获取更详细的使用信息。