跨平台开发 / 系统课时
获取应用可写目录
获取应用可写目录
Flutter 应用不应把运行时文件写进源码目录,也不应自行拼接系统路径。本节使用 path_provider 获取文档、支持文件和临时缓存目录,并通过一个可运行示例打印真实路径,让后续文件读写建立在系统提供的安全目录上。
学习目标
- 使用 path_provider 获取常用应用目录
- 根据文件用途选择文档目录、支持目录或临时目录
- 避免硬编码不同平台的文件系统路径
为什么要通过系统查询目录
Android、iOS、macOS 等平台的应用沙盒结构不同,同一类目录在不同设备上的实际路径也可能变化。如果把 /data/...、/Users/... 一类路径直接写入代码,应用换平台、重新安装或运行环境变化后就可能失效。
path_provider 的作用是把平台目录查询封装成 Dart API。业务代码只说明“我要应用文档目录”或“我要临时目录”,具体物理路径由平台决定。
获取三种常用目录
在 Flutter 项目已经添加 path_provider 依赖的前提下,可以直接运行下面的程序。示例在应用初始化完成后依次获取文档目录、应用支持目录和临时目录。
import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart';
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
// 文档目录适合保存用户或应用需要长期保留的文件。
final documents = await getApplicationDocumentsDirectory();
final support = await getApplicationSupportDirectory();
final temporary = await getTemporaryDirectory();
print('documents: ${documents.path}');
print('support: ${support.path}');
print('temporary: ${temporary.path}');
}预期输出
documents: <PATH>
support: <PATH>
temporary: <PATH><PATH> 代表系统在当前设备上返回的真实目录,具体值会因平台、模拟器、设备和应用标识而不同。验证重点是三个调用都成功返回可用路径,而不是路径必须与某台设备完全一致。
根据文件生命周期选择目录
三个目录都能提供应用可访问的位置,但用途并不相同。
| 目录 API | 适合保存 | 使用要点 |
|---|---|---|
getApplicationDocumentsDirectory() |
用户生成或应用需要长期保留的文档 | 不应把可随时重新下载的缓存大量堆在这里 |
getApplicationSupportDirectory() |
应用内部长期使用的支持文件 | 更适合用户通常不直接管理的内部数据 |
getTemporaryDirectory() |
临时下载、处理中间文件、可重建缓存 | 系统可能清理,不能依赖其永久存在 |
例如,用户编辑后尚未上传的草稿更适合长期目录,而一次图片解码产生的中间文件可以放入临时目录。判断标准不是文件扩展名,而是“丢失以后能不能安全重建”。
不要保存和复用绝对路径
目录查询结果应该在应用需要时重新获取,不要把某次获得的绝对路径永久写进配置,再假设下次启动仍然有效。应用容器的位置可能改变,而 path_provider 的 API 可以重新解析当前环境下正确的目录。
后续创建文件时,应以返回的 Directory.path 为基础再拼接文件名,而不是自己猜测系统目录结构。这样业务代码只管理文件的相对位置和用途,平台差异继续交给 Flutter 插件处理。
拿到正确目录只是本地文件读写的第一步。只要坚持由 path_provider 获取目录、按生命周期选择位置,并避免硬编码绝对路径,后续使用 File 创建、读取和删除文件时就能保持跨平台行为一致。