跨平台开发 / 系统课时

接入本地存储保存任务

接入本地存储保存任务

本篇解决 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、状态管理或初始化方法,在数据准备完成前展示加载状态,避免界面提前渲染空数据。

处理数据同步问题

本地存储接入后,新增、修改和删除任务都需要同步更新存储,否则界面状态和磁盘数据会出现不一致。

常见做法是在任务发生变化后调用统一保存方法,而不是在多个按钮事件中重复编写存储逻辑。这样可以降低遗漏保存的风险。

对于任务数量较少的应用,每次保存完整列表即可。如果数据规模增长,需要考虑增量更新或数据库存储方案。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接入本地存储保存任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通