Flutter Firebase集成插件 firebase_dart 的使用

firebase_dart 是一个纯 Dart 实现的 Firebase 客户端库，支持多种 Firebase 服务，并且可以在命令行应用、Web 应用以及 Flutter 应用中使用。本文将详细介绍如何在 Flutter 项目中集成和使用 firebase_dart 插件。

开始前的准备工作

初始化 firebase_dart

首先，你需要初始化 firebase_dart 库。对于 Flutter 应用，推荐使用 firebase_dart_flutter 库来简化初始化过程：

import 'package:firebase_dart_flutter/firebase_dart_flutter.dart';

void main() async {
  // 初始化 firebase_dart_flutter
  await FirebaseDartFlutter.setup();
}

如果你希望在单独的 isolate 中运行 Firebase 代码以确保主线程专注于渲染任务，可以设置 isolated 参数为 true（注意：此功能不适用于 Web 环境）：

await FirebaseDartFlutter.setup(isolated: true);

创建 Firebase 应用实例

接下来，创建一个 Firebase 应用实例：

import 'dart:convert';
import 'dart:io';

// 加载 Firebase 配置文件
var options = FirebaseOptions.fromMap(json.decode(
    File('example/firebase-config.json').readAsStringSync()));

// 创建 Firebase 应用实例
var app = await Firebase.initializeApp(options: options);

认证服务

获取 Firebase Auth 实例后，你可以执行各种认证操作。以下是一些常用的方法及其支持状态：

• createUserWithEmailAndPassword
• signInAnonymously
• signInWithEmailAndPassword
• signOut

示例代码：

var auth = FirebaseAuth.instanceFor(app: app);

// 匿名登录
await auth.signInAnonymously();

// 获取当前用户信息
var user = auth.currentUser;
print('Current User ID: ${user?.uid}');

// 更新用户资料
await user?.updateProfile(displayName: 'Jane Doe');
print('Display Name: ${user?.displayName}');

实时数据库

要访问 Firebase 实时数据库实例，请调用以下方法：

var db = FirebaseDatabase(app: app);

// 获取数据引用并读取数据
var dbRef = db.reference().child('test');
var snapshot = await dbRef.once();
print('Content of database /test: ${snapshot.value}');

你也可以创建一个本地内存数据库进行测试：

var localDb = FirebaseDatabase(app: app, databaseURL: 'mem://some.name/');

云存储

要访问 Firebase 存储实例，请调用以下方法：

var storage = FirebaseStorage.instanceFor(app: app);

// 创建存储引用并上传数据
var ref = storage.ref().child('test.txt');
await ref.putString('hello world!', metadata: SettableMetadata(contentType: 'text/plain'));

// 获取文件元数据
var metadata = await ref.getMetadata();
print('Content type of file test.txt: ${metadata.contentType}');

// 下载文件内容
var content = utf8.decode((await ref.getData(metadata.size))!);
print('Content of file test.txt: $content');

示例 Demo

以下是一个完整的示例 Demo，展示了如何使用 firebase_dart 进行匿名登录、更新用户资料、上传文件到云存储以及从实时数据库读取数据：

import 'dart:convert';
import 'dart:io';
import 'dart:typed_data';
import 'package:firebase_dart/auth.dart';
import 'package:firebase_dart/core.dart';
import 'package:firebase_dart/database.dart';
import 'package:firebase_dart/implementation/pure_dart.dart';
import 'package:firebase_dart/storage.dart';
import 'package:firebase_dart_flutter/firebase_dart_flutter.dart';

void main() async {
  // 初始化 Firebase
  await FirebaseDartFlutter.setup();

  // 加载 Firebase 配置
  var options = FirebaseOptions.fromMap(json.decode(
      File('example/firebase-config.json').readAsStringSync()));

  // 创建 Firebase 应用实例
  var app = await Firebase.initializeApp(options: options);

  // 获取认证实例
  var auth = FirebaseAuth.instanceFor(app: app);

  // 匿名登录
  await auth.signInAnonymously();
  var user = auth.currentUser;
  print('Current User ID: ${user?.uid}');

  // 更新用户资料
  await user?.updateProfile(displayName: 'Jane Doe');
  print('Display Name: ${user?.displayName}');

  // 使用云存储
  var storage = FirebaseStorage.instanceFor(app: app);
  var ref = storage.ref().child('test.txt');
  await ref.putString('hello world!', metadata: SettableMetadata(contentType: 'text/plain'));

  var metadata = await ref.getMetadata();
  print('Content type of file test.txt: ${metadata.contentType}');

  var content = utf8.decode((await ref.getData(metadata.size))!);
  print('Content of file test.txt: $content');

  // 使用实时数据库
  var database = FirebaseDatabase(app: app);
  var dbRef = database.reference().child('test');
  var snapshot = await dbRef.once();
  print('Content of database /test: ${snapshot.value}');

  // 删除用户
  await user?.delete();
  user = auth.currentUser;
  print('Current User ID after deletion: ${user?.uid}');

  // 清理资源
  await app.delete();
}