Realtime Database 使用入门

前提条件

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

创建数据库

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

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

    测试模式

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

    首先,请选择测试模式。

    锁定模式

    拒绝来自移动和 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 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/');

后续步骤