跳到正文
教程首页
FlutterCH 14ch14_persistence

ch14-persistence

本地持久化:shared_preferences 与 drift(SQLite)。完整工程共 104 个文件,其中 64 个文本源文件可在下面在线阅读。

64

在线文本文件

4,938

源码行数

dart / c / yaml

语言

289 KB

打包体积

在线阅读源码

左侧按目录浏览,点击文件切换。右上角可复制代码、复制路径或单独下载文件。在线视图只覆盖文本源码,完整工程请下载 zip。

textxmldartyamljson

64 text files · 4,938 lines

dartlib/src/providers.dart
/// Riverpod 接线:数据库、设置、待办流。
library;

import 'package:flutter_riverpod/flutter_riverpod.dart';

import 'database.dart';
import 'settings_store.dart';

/// 数据库:整个应用共享一个连接(SQLite 不建议多连接同时写)。
final databaseProvider = Provider<AppDatabase>((Ref ref) {
  final AppDatabase db = AppDatabase.open();
  ref.onDispose(db.close);
  return db;
});

/// 设置存储:在 `main()` 里用 override 注入(因为 SharedPreferences 需要异步初始化)。
final settingsProvider = Provider<SettingsStore>((Ref ref) {
  throw UnimplementedError('settingsProvider 必须在 ProviderScope 里 override');
});

/// 待办列表:drift 的 `watch()` → StreamProvider。
/// 任何一次 insert/update/delete 都会让这个 Stream 推新值,UI 自动刷新。
final todosProvider = StreamProvider<List<Todo>>(
  (Ref ref) => ref.watch(databaseProvider).watchTodos(),
);

/// 派生状态:已完成数量。
final doneCountProvider = Provider<int>((Ref ref) {
  final List<Todo>? todos = ref.watch(todosProvider).value;
  return todos?.where((Todo t) => t.done).length ?? 0;
});

/// 写操作集中在一处:UI 只调方法,不直接碰数据库。
class TodoActions {
  TodoActions(this._ref);

  final Ref _ref;

  AppDatabase get _db => _ref.read(databaseProvider);

  Future<void> add(String title) async {
    if (title.trim().isEmpty) return;
    await _db.addTodo(title);
  }

  Future<void> toggle(Todo todo) => _db.setDone(todo.id, done: !todo.done);

  Future<void> remove(Todo todo) => _db.deleteTodo(todo.id);

  Future<void> clearDone() => _db.clearDone();

  /// 演示:写库 + 记录同步时间(shared_preferences)。
  Future<void> markSynced() =>
      _ref.read(settingsProvider).markSyncedAt(DateTime.now());
}

final todoActionsProvider = Provider<TodoActions>((Ref ref) => TodoActions(ref));

代码构成:text 78 KB · xml 41 KB · dart 36 KB · yaml 5 KB

本地运行

zip → 解压 → 执行
$cd examples/ch14-persistence && flutter run -d macos

这个 zip 里有什么

  • • 完整工程目录(含 Android / iOS / 桌面平台脚手架)
  • • lib / bin / test / native 全部源码与测试
  • • pubspec.yaml、锁文件与平台配置文件
  • • 已排除 .dart_tool / build / target / ephemeral 等构建产物

已验证

  • flutter analyze 0 告警、flutter test 12 个用例全绿、flutter build macos --debug 真实构建并启动成功
查看全部示例