跨平台开发 / 系统课时

把下载内容保存到本地

把下载内容保存到本地

本篇解决 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,通常说明下载响应为空,或者保存流程提前结束。

处理保存失败的情况

文件保存失败常见原因包括目录权限问题、磁盘空间不足、下载内容不完整等。排查时应先确认下载响应是否成功,再确认目标路径是否可写。

对于大文件下载,还需要避免一次性把全部内容加载到内存中,应使用流式下载方式边接收边写入,降低内存压力。

选择保存目录时,核心原则是让文件生命周期匹配业务需求。临时缓存不要长期保存,用户需要访问的内容不要只放在临时目录。

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

目录与阅读设置

阅读设置

17

记录一个想法

把下载内容保存到本地

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

登录哪都通