跨平台开发 / 系统课时
把下载内容保存到本地
把下载内容保存到本地
本篇解决 Flutter 下载任务完成后的文件落盘问题。你将学习如何选择应用目录、将网络响应写入文件,并通过代码验证文件是否成功保存,为后续打开、分享或离线使用文件做好准备。
学习目标
- 理解 Flutter 应用中常见文件保存目录的选择方式。
- 使用路径工具和文件 API 将下载内容写入本地。
- 掌握保存文件时的验证与常见错误处理。
选择合适的本地保存位置
Flutter 应用不能随意写入设备任意路径,需要根据文件用途选择目录。临时文件适合缓存,应用文档目录适合长期保存用户数据,外部共享目录则需要结合平台能力处理。
下载的图片、报告、离线资源等通常需要保留到应用生命周期之外,因此更适合使用应用文档目录,而不是临时目录。
使用路径和文件 API 保存下载内容
Flutter 中可以通过 path_provider 获取系统提供的目录,再使用 Dart 的 File 写入二进制数据。下面示例模拟已经完成网络下载,拿到文件字节后保存到本地。
dart
import 'dart:io';
import 'package:path_provider/path_provider.dart';
Future<File> saveDownloadedFile(List<int> bytes) async {
final directory = await getApplicationDocumentsDirectory();
final file = File('${directory.path}/report.pdf');
// 写入二进制内容,适用于图片、PDF 等非文本文件。
await file.writeAsBytes(bytes, flush: true);
return file;
}
void main() async {
final file = await saveDownloadedFile([1, 2, 3, 4]);
print(file.path);
}预期结果
text
<APP_DOCUMENT_PATH>/report.pdf实际路径会根据 Android、iOS 设备和应用标识不同而变化。
验证文件是否保存成功
保存完成后,不要只依赖写入方法没有抛异常来判断成功。实际项目中通常还需要检查文件是否存在、大小是否符合预期。
dart
final exists = await file.exists();
final length = await file.length();
print('exists=$exists, size=$length');预期结果
text
exists=true, size=<FILE_SIZE>如果文件大小为 0,通常说明下载响应为空,或者保存流程提前结束。
处理保存失败的情况
文件保存失败常见原因包括目录权限问题、磁盘空间不足、下载内容不完整等。排查时应先确认下载响应是否成功,再确认目标路径是否可写。
对于大文件下载,还需要避免一次性把全部内容加载到内存中,应使用流式下载方式边接收边写入,降低内存压力。
选择保存目录时,核心原则是让文件生命周期匹配业务需求。临时缓存不要长期保存,用户需要访问的内容不要只放在临时目录。
按自己的节奏,确认真正理解。