跨平台开发 / 系统课时
区分持久目录和缓存目录
区分持久目录和缓存目录
本地文件能否长期保留,不只取决于是否成功写入,还取决于写到了什么目录。Flutter 应用通常需要同时保存重要业务数据和可重新生成的临时文件,本节用 path_provider 区分持久目录与缓存目录,并建立明确的选择规则。
学习目标
- 理解持久目录和缓存目录在数据生命周期上的差异
- 使用
path_provider获取适合长期保存和临时缓存的目录 - 根据数据能否重建选择正确的存储位置
先判断文件丢失后能不能重建
选择目录时最实用的问题是:如果这个文件明天消失,应用能否自动重新得到它? 如果答案是否定的,就应保存到持久目录;如果可以通过网络、计算或源文件重新生成,则更适合缓存目录。
| 数据 | 推荐目录 | 原因 |
|---|---|---|
| 用户草稿、离线编辑数据 | 应用文档目录 | 丢失后通常无法自动恢复 |
| 应用生成且需要长期保留的数据 | 应用文档目录 | 生命周期应跟随应用数据 |
| 图片缩略图、接口响应缓存 | 临时目录 | 可以重新下载或计算 |
| 解压中间文件、一次性转换结果 | 临时目录 | 使用完成后即可删除 |
缓存目录并不是“写入失败也无所谓”的目录,而是业务上允许被清理并重新生成的目录。重要文件即使体积很小,也不应该因为方便而放入缓存。
用 path_provider 获取两类目录
项目需要已经添加 path_provider 依赖。下面的 Flutter 代码分别调用 getApplicationDocumentsDirectory() 和 getTemporaryDirectory(),将长期数据与可重建数据写到不同位置。
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}');
}预期输出:
persistent: <PATH>/draft.json
cache: <PATH>/preview.txt<PATH> 会随操作系统、设备和应用沙箱变化,不应在代码中硬编码。真正需要依赖的是 path_provider 返回的目录,而不是某个平台当前观察到的绝对路径。
持久不等于永久不会丢失
getApplicationDocumentsDirectory() 适合保存应用需要长期保留的数据,但“持久”描述的是应用的数据管理意图,并不意味着文件绝对不会消失。用户卸载应用、清除应用数据或设备发生存储故障时,文件仍可能丢失,因此真正不可替代的数据还需要同步、导出或备份策略。
getTemporaryDirectory() 返回的目录则应按缓存看待。应用可以主动清理,其中的内容也不应成为业务正确性的唯一来源。读取缓存文件时仍要准备文件不存在的分支,因为缓存被清理本身就是允许发生的情况。
让目录选择成为数据设计的一部分
实际项目中可以先按“是否可重建”分类,再决定文件位置。用户产生且没有其他副本的数据进入持久目录;从服务端获取、由原始数据派生或只用于加速的数据进入缓存目录。这样即使系统清理缓存,应用最多损失性能,不会损失真正重要的数据。
目录选择本质上是在声明数据生命周期:持久目录承担“应保留”的数据,缓存目录承担“允许消失”的数据。只要先明确文件是否可重建,就能避免把重要数据误放进可能被清理的位置。