跨平台开发 / 系统课时

区分持久目录和缓存目录

区分持久目录和缓存目录

本地文件能否长期保留,不只取决于是否成功写入,还取决于写到了什么目录。Flutter 应用通常需要同时保存重要业务数据和可重新生成的临时文件,本节用 path_provider 区分持久目录与缓存目录,并建立明确的选择规则。

学习目标

  • 理解持久目录和缓存目录在数据生命周期上的差异
  • 使用 path_provider 获取适合长期保存和临时缓存的目录
  • 根据数据能否重建选择正确的存储位置

先判断文件丢失后能不能重建

选择目录时最实用的问题是:如果这个文件明天消失,应用能否自动重新得到它? 如果答案是否定的,就应保存到持久目录;如果可以通过网络、计算或源文件重新生成,则更适合缓存目录。

数据 推荐目录 原因
用户草稿、离线编辑数据 应用文档目录 丢失后通常无法自动恢复
应用生成且需要长期保留的数据 应用文档目录 生命周期应跟随应用数据
图片缩略图、接口响应缓存 临时目录 可以重新下载或计算
解压中间文件、一次性转换结果 临时目录 使用完成后即可删除

缓存目录并不是“写入失败也无所谓”的目录,而是业务上允许被清理并重新生成的目录。重要文件即使体积很小,也不应该因为方便而放入缓存。

用 path_provider 获取两类目录

项目需要已经添加 path_provider 依赖。下面的 Flutter 代码分别调用 getApplicationDocumentsDirectory() 和 getTemporaryDirectory(),将长期数据与可重建数据写到不同位置。

dart
import 'dart:io';

import 'package:flutter/widgets.dart';
import 'package:path_provider/path_provider.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  final documentsDirectory = await getApplicationDocumentsDirectory();
  final cacheDirectory = await getTemporaryDirectory();

  // 草稿无法自动重建,因此写入持久目录。
  final draftFile = File('${documentsDirectory.path}/draft.json');
  await draftFile.writeAsString('{"title":"Local draft"}');

  // 预览内容可以重新生成,因此放入缓存目录。
  final previewFile = File('${cacheDirectory.path}/preview.txt');
  await previewFile.writeAsString('rebuildable preview');

  print('persistent: ${draftFile.path}');
  print('cache: ${previewFile.path}');
}

预期输出:

text
persistent: <PATH>/draft.json
cache: <PATH>/preview.txt

<PATH> 会随操作系统、设备和应用沙箱变化,不应在代码中硬编码。真正需要依赖的是 path_provider 返回的目录,而不是某个平台当前观察到的绝对路径。

持久不等于永久不会丢失

getApplicationDocumentsDirectory() 适合保存应用需要长期保留的数据,但“持久”描述的是应用的数据管理意图,并不意味着文件绝对不会消失。用户卸载应用、清除应用数据或设备发生存储故障时,文件仍可能丢失,因此真正不可替代的数据还需要同步、导出或备份策略。

getTemporaryDirectory() 返回的目录则应按缓存看待。应用可以主动清理,其中的内容也不应成为业务正确性的唯一来源。读取缓存文件时仍要准备文件不存在的分支,因为缓存被清理本身就是允许发生的情况。

让目录选择成为数据设计的一部分

实际项目中可以先按“是否可重建”分类,再决定文件位置。用户产生且没有其他副本的数据进入持久目录;从服务端获取、由原始数据派生或只用于加速的数据进入缓存目录。这样即使系统清理缓存,应用最多损失性能,不会损失真正重要的数据。

目录选择本质上是在声明数据生命周期:持久目录承担“应保留”的数据,缓存目录承担“允许消失”的数据。只要先明确文件是否可重建,就能避免把重要数据误放进可能被清理的位置。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分持久目录和缓存目录

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

登录哪都通