跳到正文
教程首页
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/main.dart
// 第 14 章 · 本地持久化。
//
// 启动顺序很重要:
//   1. 确保 binding 初始化;
//   2. 异步读取 SharedPreferences(必须先于 runApp,否则首帧拿不到主题);
//   3. 用 override 把 SettingsStore 注入 ProviderScope。
//
// drift 的数据库连接是懒加载的(LazyDatabase),所以不需要在这里 await。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:shared_preferences/shared_preferences.dart';

import 'src/providers.dart';
import 'src/settings_store.dart';
import 'src/todos_page.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  final SharedPreferences prefs = await SharedPreferences.getInstance();
  runApp(
    ProviderScope(
      overrides: [settingsProvider.overrideWithValue(SettingsStore(prefs))],
      child: PersistenceApp(initialMode: SettingsStore(prefs).themeMode),
    ),
  );
}

class PersistenceApp extends ConsumerStatefulWidget {
  const PersistenceApp({super.key, required this.initialMode});

  final ThemeMode initialMode;

  @override
  ConsumerState<PersistenceApp> createState() => _PersistenceAppState();
}

class _PersistenceAppState extends ConsumerState<PersistenceApp> {
  late ThemeMode _mode = widget.initialMode;

  Future<void> _toggleTheme() async {
    setState(() {
      _mode = _mode == ThemeMode.dark ? ThemeMode.light : ThemeMode.dark;
    });
    // 持久化:下次启动还是这个主题。
    await ref.read(settingsProvider).setThemeMode(_mode);
  }

  @override
  Widget build(BuildContext context) {
    final ColorScheme scheme = ColorScheme.fromSeed(seedColor: const Color(0xFF2E7D32));
    return MaterialApp(
      title: '本地持久化',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(useMaterial3: true, colorScheme: scheme),
      darkTheme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(
          seedColor: const Color(0xFF2E7D32),
          brightness: Brightness.dark,
        ),
      ),
      themeMode: _mode,
      home: _Shell(onToggleTheme: _toggleTheme),
    );
  }
}

/// 把主题切换按钮塞进页面 AppBar 的简单包装。
class _Shell extends StatelessWidget {
  const _Shell({required this.onToggleTheme});

  final VoidCallback onToggleTheme;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Builder(
        builder: (BuildContext context) => Stack(
          children: [
            const TodosPage(),
            Positioned(
              top: 0,
              right: 56,
              child: SafeArea(
                child: IconButton(
                  key: const Key('theme-toggle'),
                  tooltip: '切换主题(会持久化)',
                  onPressed: onToggleTheme,
                  icon: const Icon(Icons.brightness_6_outlined),
                ),
              ),
            ),
          ],
        ),
      ),
    );
  }
}

代码构成: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 真实构建并启动成功
查看全部示例