跨平台开发 / 系统课时
读写应用目录中的文件
读写应用目录中的文件
本篇将解决 Flutter 应用如何保存少量本地文件的问题。你会学习获取系统提供的可写目录,并通过文件 API 完成文本和 JSON 数据的写入与读取,为配置缓存、离线数据等场景建立基础。
学习目标
- 理解 Flutter 应用沙盒目录与可写文件位置的关系
- 掌握使用 path_provider 获取应用目录的方法
- 完成文本文件和 JSON 文件的保存与读取
认识应用可写目录
移动应用通常不能随意访问设备文件系统,而是在自己的沙盒空间中读写数据。Flutter 应用需要通过平台提供的目录接口获取安全路径,再使用 Dart 文件 API 操作文件。
常见目录用途如下:
| 目录类型 | 用途 | 是否适合保存用户数据 |
|---|---|---|
| Documents | 长期保存的应用文件 | 适合 |
| Temporary | 临时缓存文件 | 不保证长期存在 |
| Application Support | 应用内部配置数据 | 适合 |
如果数据需要随着应用运行持续存在,例如草稿、导入文件或本地缓存,可以选择持久化目录;如果只是临时计算结果,则可以使用临时目录。
使用 path_provider 获取目录
Flutter 默认没有直接提供跨平台文件路径,需要使用 path_provider 插件。
先添加依赖:
yaml
dependencies:
path_provider: ^2.1.4下面示例将 JSON 数据写入应用文档目录,并再次读取。
dart
import 'dart:convert';
import 'dart:io';
import 'package:path_provider/path_provider.dart';
Future<void> saveUserSettings() async {
final directory = await getApplicationDocumentsDirectory();
final file = File('${directory.path}/settings.json');
// 使用 JSON 保存结构化数据,便于后续扩展字段。
final data = {
'theme': 'dark',
'fontSize': 16,
};
await file.writeAsString(jsonEncode(data));
final content = await file.readAsString();
final settings = jsonDecode(content);
print(settings['theme']);
}预期结果
text
dark实际目录路径会根据 Android、iOS 或桌面平台环境变化,不应把绝对路径写死在代码中。
文件读写中的常见处理
文件操作属于异步 IO,通常需要使用 async 和 await 等待完成。如果直接读取不存在的文件,需要先判断文件状态,避免抛出异常。
dart
import 'dart:io';
Future<String?> readConfig(File file) async {
if (!await file.exists()) {
return null;
}
return file.readAsString();
}预期结果
text
文件存在时返回文本内容,不存在时返回 null对于复杂业务,例如用户账号、订单数据或大量列表数据,直接管理文件会变得困难,此时应考虑数据库或专用缓存方案。
什么时候使用文件存储
文件存储适合结构简单、访问频率较低的数据,例如:
- 应用设置
- 小型 JSON 配置
- 用户导出的文件
- 离线缓存快照
如果需要查询、排序、条件过滤大量数据,应使用 SQLite 等数据库方案,而不是把所有内容保存到单个文件中。
按自己的节奏,确认真正理解。