前提条件
- 安装
firebase_core
并向您的应用添加初始化代码(如果您尚未执行这些操作)。 - 在 Firebase 控制台中将您的应用添加到您的 Firebase 项目。
创建数据库
前往 Firebase 控制台的 Realtime Database 部分。系统将会提示您选择一个现有 Firebase 项目。按照数据库创建工作流操作。
为您的安全规则选择一个初始模式:
测试模式
此模式适合刚开始使用移动和 Web 客户端库的用户,但它会允许其他人读取和覆盖您的数据。测试完成后,请务必查看了解 Firebase Realtime Database 规则部分。
首先,请选择测试模式。
锁定模式
拒绝来自移动和 Web 客户端的所有读写操作。 经过身份验证的应用服务器仍然可以访问您的数据库。
为数据库选择一个区域。根据您选择的区域,数据库命名空间的格式将是
<databaseName>.firebaseio.com
或<databaseName>.<region>.firebasedatabase.app
。如需了解详情,请参阅为项目选择位置。点击完成。
如果启用 Realtime Database,也就在 Cloud API 管理器中启用了相应 API。
将 Firebase Realtime Database 添加至您的应用
从 Flutter 项目的根目录运行以下命令,以安装该插件:
flutter pub add firebase_database
完成后,重新构建您的 Flutter 应用:
flutter run
配置数据库规则
Realtime Database 提供了声明性规则语言,可用于定义数据的结构、将数据编入索引的方式,以及何时可以在其中读取和写入数据。
初始化 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 设计数据结构。