Realtime Database 使用入门

前提条件

1. 安装 firebase_core 并向您的应用添加初始化代码（如果您尚未执行这些操作）。
2. 在 Firebase 控制台中将您的应用添加到您的 Firebase 项目。

创建数据库

1. 前往 Firebase 控制台的 Realtime Database 部分。系统将会提示您选择一个现有 Firebase 项目。按照数据库创建工作流操作。

2. 为您的安全规则选择一个初始模式：

   测试模式

   此模式适合刚开始使用移动和 Web 客户端库的用户，但它会允许其他人读取和覆盖您的数据。测试完成后，请务必查看了解 Firebase Realtime Database 规则部分。

   注意：如果您在测试模式下创建数据库，并且在试用期间没有更改所有人都可读写的默认安全规则，您将会收到电子邮件提醒，之后您的数据库规则将拒绝所有请求。在 Firebase 控制台设置流程中，请留意失效日期。

   首先，请选择测试模式。

   锁定模式

   拒绝来自移动和 Web 客户端的所有读写操作。 经过身份验证的应用服务器仍然可以访问您的数据库。

3. 为数据库选择一个区域。根据您选择的区域，数据库命名空间的格式将是 <databaseName>.firebaseio.com 或 <databaseName>.<region>.firebasedatabase.app。如需了解详情，请参阅为项目选择位置。

4. 点击完成。

如果启用 Realtime Database，也就在 Cloud API 管理器中启用了相应 API。

将 Firebase Realtime Database 添加至您的应用

1. 从 Flutter 项目的根目录运行以下命令，以安装该插件：

   flutter pub add firebase_database
   

2. 完成后，重新构建您的 Flutter 应用：

   flutter run
   

配置数据库规则

Realtime Database 提供了声明性规则语言，可用于定义数据的结构、将数据编入索引的方式，以及何时可以在其中读取和写入数据。

注意：默认情况下，对数据库的读写权限是有限制的，只有通过身份验证的用户才能读写数据。如需在未设置 Firebase Authentication 的情况下开始使用数据库，您可以将您的规则配置为允许所有人访问。这会使得您的数据库向所有人开放，包括不使用您的应用的用户，因此在设置身份验证时，请务必重新限制数据库的访问权限。

初始化 Firebase Realtime Database 软件包

如需开始在项目中使用 Realtime Database 软件包，请在项目文件的顶部导入该软件包：

import 'package:firebase_database/firebase_database.dart';

如需使用默认的 Database 实例，请对 FirebaseDatabase 调用 instance getter：

FirebaseDatabase database = FirebaseDatabase.instance;

如果您希望将其与辅助 Firebase 应用搭配使用，请使用静态 instanceFor 方法：

FirebaseApp secondaryApp = Firebase.app('SecondaryApp');
FirebaseDatabase database = FirebaseDatabase.instanceFor(app: secondaryApp);

如果您想在同一个项目中使用不同的 RTDB 实例，可以使用静态 instanceFor 方法传入 databaseUrl：

final firebaseApp = Firebase.app();
final rtdb = FirebaseDatabase.instanceFor(app: firebaseApp, databaseURL: 'https://your-realtime-database-url.firebaseio.com/');

后续步骤

• 了解如何为 Realtime Database 设计数据结构。

• 将数据扩展到多个数据库实例。

• 读取和写入数据。

• 在 Firebase 控制台中查看您的数据库。