前言
文件下载在很多类型的应用中会涉及,例如音乐、文档、包括图片(只是图片可以使用一些组件完成无感知的下载)。本篇介绍使用 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; // 取消下载的 token canceltoken _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
对象,否则取消一次后无法再次取消。
运行结果及代码
运行结果如下图所示:
屏幕录制2021-07-24 下午9.59.04.gif
总结
从示例可以看到,dio 的下载方法是简单易用的,而且提供了友好的下载反馈。同时,借助 canceltoken 也能取消或者暂停下载(暂停时设置deleteonerror=false,表示不删除文件,然后恢复到时候从已下载的偏移量开始,也可以按这种方式做断点续传,具体方式可以搜索或者自己完成)。dio 网络请求系列的详细介绍到这一篇结束,后续实际业务用到的时候再穿插介绍,接下来一篇将对 dio 系列文章做一个整体总结。
以上就是android基于flutter编写文件下载管理器的详细内容,更多关于android文件下载的资料请关注其它相关文章!