一文搞定 Flutter 文件下载和管理

2022 年 5 月 05 日
本文字数：3291 字
阅读完需：约 11 分钟

前言

文件下载在很多类型的应用中会涉及，例如音乐、文档、包括图片（只是图片可以使用一些组件完成无感知的下载）。本篇介绍使用 Dio 的下载方法完成文件的下载，涉及到的内容如下：

Dio 插件的 download 方法介绍；
使用 download 的回调方法监测下载进度；
使用 CancelToken 取消正在下载的任务；
删除已下载的文件；
path_provider 插件管理 App 文件目录；
下载文件调试过程中发现的一些问题；

Dio 的下载方法 download

Dio 的下载方法定义如下：

Future<Response> download(  String urlPath,  savePath, {  ProgressCallback? onReceiveProgress,  Map<String, dynamic>? queryParameters,  CancelToken? cancelToken,  bool deleteOnError = true,  String lengthHeader = Headers.contentLengthHeader,  data,  Options? options,});

复制代码

urlPath：网络资源的 url；
savePath：dynamic 类型，可以是下载后存储文件路径的字符串，也可以是一个返回字符串的回调方法（Dio 会把 headers 参数携带过去，方便针对下载返回内容构建文件路径）；
onReceiveProgress：文件接收进度，是一个void Function(int count, int total)回调函数，调用者可以通过该回调方法监测下载进度。
deleteOnError：发生错误时候是否删除已下载的文件，默认是 true。
lengthHeader：源文件的实际大小（未压缩前）。默认是 header 的content-length。如果文件压缩了，而没有指定该值的话，那进度回调里的total会是-1；如果使用自定义的 header 指定了文件的大小，那么total会是自定义的 header 对应的文件大小。
其他参数和普通的请求差不多，这里不再赘述。

为了不暴露下载的具体实现，我们在 http_util.dart 中封装一个自己的下载方法。

static Future download(  String url,  String savePath, {  Map<String, dynamic> queryParams,  CancelToken cancelToken,  dynamic data,  Options options,  void Function(int, int) onReceiveProgress,}) async {  try {    return await _dioInstance.download(      url,      savePath,      queryParameters: queryParams,      cancelToken: cancelToken,      onReceiveProgress: onReceiveProgress,    );  } on DioError catch (e) {    if (CancelToken.isCancel(e)) {      EasyLoading.showInfo('下载已取消！');    } else {      if (e.response != null) {        _handleErrorResponse(e.response);      } else {        EasyLoading.showError(e.message);      }    }  } on Exception catch (e) {    EasyLoading.showError(e.toString());  }}

复制代码

监测下载进度

我们新建一个文件下载页面 file_download.dart完成文件下载的示例。这里定义了几个属性来对文件下载过程进行反馈：

// 文件下载地址，这里是谷歌浏览器的下载地址（Mac 版本）String _downloadPath =      'https://dl.google.com/chrome/mac/stable/GGRO/googlechrome.dmg';// 下载进度比例，用于检测下载是否完成double _downloadRatio = 0.0;// 下载进度百分比String _downloadIndicator = '0.00%';// 下载文件的存储路径String _destPath;// 取消下载的 tokenCancelToken _token;// 指示当前是否处于下载中，以便做业务判断bool _downloading = false;

复制代码

然后我们定义一个下载方法，在下载过程中如果 total 不为-1就更新下载进度，否则提示错误（实际调试发现，如果涉及到需要验证的，下载后后端实际会返回网页，这样也能下载网页内容下来，但是不是想要的文件）。

void _downloadFile() {  _token = CancelToken();  _downloading = true;  HttpUtil.download(_downloadPath, _destPath, cancelToken: _token,      onReceiveProgress: (int received, int total) {    if (total != -1) {      if (!_token.isCancelled) {        setState(() {          _downloadRatio = (received / total);          if (_downloadRatio == 1) {            _downloading = false;          }          _downloadIndicator =              (_downloadRatio * 100).toStringAsFixed(2) + '%';        });      }    } else {      _downloading = false;      EasyLoading.showError('无法获取文件大小，下载失败!');    }  });}

复制代码

这里因为涉及到可能取消，因此只有在没有取消的情况下才更新下载状态，要不可能会出现取消的时候还处在下载接收字节的过程中，虽然取消了但是看到下载进度还在走的情况。

取消下载

取消下载其实很简单，当我们点击取消按钮的时候，调用 CancelToken 的cancel方法即可。这里我们做了一个判断，下载比例低于 1 才可以取消，因为下载完成再取消会抛异常。同时取消后重置下载比例和显示的下载百分比。

void _cancelDownload() {  if (_downloadRatio < 1.0) {    _token.cancel();    _downloading = false;    setState(() {      _downloadRatio = 0;      _downloadIndicator = '0.00%';    });  }}

复制代码

删除已经下载的文件

对于 App，没有别的入口管理文件，因此实际过程中我们需要提供下载入口共用户清理已下载的文件。实际已下载的文件，我们需要有下载文件管理功能供用户管理文件，这个时候会需要本地存储支撑，我们在后续的章节会介绍本地存储。

删除文件前需要判断文件是否存在，如果文件不存在删除可能抛出异常。文件的管理使用的是 dart:io 中的方法。

void _deleteFile() {  try {    File downloadedFile = File(_destPath);    if (downloadedFile.existsSync()) {      downloadedFile.delete();    } else {      EasyLoading.showError('文件不存在');    }  } catch (e) {    EasyLoading.showError(e.toString());  }}

复制代码

path_provider 文件目录管理

在 App 中没法直接知道应用的文件存储目录，因此需要借用 path_provider 插件来获取 App 的文件存储目录，path_provider 提供了如下方法：

getTemporaryDirectory：应用临时目录（可能被清除）
getApplicationDocumentsDirectory：应用文档目录（不会被系统清除，主要用户数据存储目录），对于安卓推荐使用外部存储 getExternalStorageDirectory。
getApplicationSupportDirectory：应用支持目录，一般放置与用户无关的数据。
getLibraryDirectory：指向应用可以持久存储数据的目录，不支持安卓平台。
getExternalStorageDirectory：获取外部存储目录，不支持 iOS 平台。
getExternalCacheDirectories：获取外部缓存目录，，不支持 iOS 平台。
getExternalStorageDirectories：获取外部可以的目录列表，不支持 iOS 平台。
getDownloadsDirectory：获取下载目录，用于 Web 端，不支持安卓和 iOS 平台。

通过 path_provider拿到Directory对象后，就可以通过 Directory的 path 属性获取到完整的目录路径。本例我们是在 initialState 里获取文件存储路径的，使用的是临时目录。

void initState() {  getTemporaryDirectory()      .then((tempDir) => {_destPath = tempDir.path + 'googlechrome.dmg'});
  super.initState();}

复制代码

调试过程中遇到的一些错误

OS Error: Read-only file system：安卓系统需要获取READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限。同时需要使用 path_provider获取应用的文件目录再往对应的目录读写文件和访问文件目录。
onReceivedProgress 中如果total=-1则表示该文件被压缩或者需要会话信息才可以下载（如后端开启了验证）。
删除文件的时候需要检查文件是否在下载过程中，如果在下载过程中删除会引起文件读写冲突，抛出异常。
CancelToken一个实例只能取消一次请求，因此每次发起请求的时候需要重新构建CancelToken对象，否则取消一次后无法再次取消。

运行结果及代码

运行结果如下图所示：

代码已提交至 gitee：Dio网络请求相关代码。

总结

从示例可以看到，Dio 的下载方法是简单易用的，而且提供了友好的下载反馈。同时，借助 CancelToken 也能取消或者暂停下载（暂停时设置 deleteOnError=false，表示不删除文件，然后恢复到时候从已下载的偏移量开始，也可以按这种方式做断点续传，具体方式可以搜索或者自己完成）。

发布于: 刚刚阅读数: 2

原文链接:【http://xie.infoq.cn/article/0aacb4cb78dd409a865623443】。文章转载请联系作者。

岛上码农

关注

用代码连接孤岛，公众号@岛上码农 2022.03.03 加入

从南漂到北，从北漂到南的业余码农

发布

暂无评论

创作场景

一文搞定 Flutter 文件下载和管理

前言

Dio 的下载方法 download

监测下载进度

取消下载

删除已经下载的文件

path_provider 文件目录管理

调试过程中遇到的一些错误

运行结果及代码

总结

岛上码农

评论