跨平台开发 / 系统课时
接入本地存储保存任务
接入本地存储保存任务
本篇解决 Flutter 应用数据无法跨重启保存的问题,通过接入本地存储,让任务列表在关闭应用后仍能恢复。你将实现数据序列化、保存和读取流程,为完整应用补齐持久化能力。
学习目标
- 理解 Flutter 应用中本地持久化的基本方式
- 使用 shared_preferences 保存简单任务数据
- 在应用启动时恢复本地数据并同步到界面
选择适合的本地存储方案
Flutter 中的本地存储方式取决于数据复杂度。简单配置和少量键值数据适合使用 shared_preferences,例如用户设置、开关状态和小型任务列表。
如果数据包含大量记录、复杂查询或关系结构,则应考虑 SQLite 等数据库方案。本篇的任务列表数据规模较小,因此使用键值存储完成持久化。
保存任务数据
shared_preferences 只能保存基础类型,例如字符串、数字、布尔值和字符串列表。任务对象需要先转换成 JSON 字符串,再写入本地。
添加依赖后,可以通过异步方式获取存储实例:
yaml
dependencies:
shared_preferences: ^2.2.3下面是一个任务模型和保存方法示例:
dart
import 'dart:convert';
import 'package:shared_preferences/shared_preferences.dart';
class Task {
Task({required this.title, required this.done});
final String title;
final bool done;
Map<String, dynamic> toJson() => {
'title': title,
'done': done,
};
}
Future<void> saveTasks(List<Task> tasks) async {
final prefs = await SharedPreferences.getInstance();
final jsonText = jsonEncode(
tasks.map((task) => task.toJson()).toList(),
);
await prefs.setString('tasks', jsonText);
}预期结果
text
本地存储中生成 tasks 键,对应值为任务列表 JSON 字符串。保存时需要注意,键名应保持稳定。如果后续版本修改了键名,旧用户的数据将无法读取。
启动时恢复任务
应用启动后,需要先读取本地数据,再更新状态管理中的任务列表。读取流程通常发生在页面初始化阶段。
dart
Future<List<Task>> loadTasks() async {
final prefs = await SharedPreferences.getInstance();
final jsonText = prefs.getString('tasks');
if (jsonText == null) {
return [];
}
final List<dynamic> data = jsonDecode(jsonText);
return data.map((item) {
return Task(
title: item['title'] as String,
done: item['done'] as bool,
);
}).toList();
}预期结果
text
首次安装应用返回空列表。
重新打开已有数据的应用时,返回之前保存的任务集合。在真实项目中,读取操作通常需要结合 FutureBuilder、状态管理或初始化方法,在数据准备完成前展示加载状态,避免界面提前渲染空数据。
处理数据同步问题
本地存储接入后,新增、修改和删除任务都需要同步更新存储,否则界面状态和磁盘数据会出现不一致。
常见做法是在任务发生变化后调用统一保存方法,而不是在多个按钮事件中重复编写存储逻辑。这样可以降低遗漏保存的风险。
对于任务数量较少的应用,每次保存完整列表即可。如果数据规模增长,需要考虑增量更新或数据库存储方案。
按自己的节奏,确认真正理解。