很多人都会遇到下载相关的需求,如果是只下载一个文件那还好,可需求有时候并不会那么简单,领导一句话:下载要支持多任务并行下载,产品经理妹子再来一句:用户下载失败后,下次进来要能接着之前的继续下载,好像有个专业的名词,嗯,叫做断点续传。
这个时候你的压力就来了:mmp,又要多任务并行,又要断点续传,你行你来!
今天我给大家推荐个开源库,解决这一问题。这个开源库是我无意间看到的,觉得还不错,就想着分享给你们。
这个开源库的地址是:
https://github.com/AriaLyy/Aria
已经有2.9k star,它的特点是:
简单、方便
可以在Activity、Service、Fragment、Dialog、popupWindow、Notification等组件中使用
支持HTTP\FTP断点续传下载、多任务自动调度
支持多文件打包下载,多文件共享同一进度(如:视频 + 封面 + 字幕)
支持下载FTP文件夹
支持HTTP表单上传
扫描二维码关注公众号,回复: 8770612 查看本文章支持文件FTP断点续传上传
支持FTPS断点续传,see
支持https地址下载
支持多线程分块下载,能更有效的发挥机器IO性能
等等
看起来很牛逼,是不是?下面简单介绍下使用方式。
引入库
implementation 'com.arialyy.aria:core:3.7.8-pre-1'
annotationProcessor 'com.arialyy.aria:compiler:3.7.8-pre-1'
# 如果需要使用ftp,请增加该组件
implementation 'com.arialyy.aria:ftpComponent:3.7.8-pre-1'
# 如果需要使用m3u8下载功能,请增加该组件
implementation 'com.arialyy.aria:m3u8Component:3.7.8-pre-1'
如果出现android support依赖错误,请将
compile 'com.arialyy.aria:core:<last-version>'
替换为
api('com.arialyy.aria:core:<last-version>'){
exclude group: 'androidx.appcompat.app'
}
如果你使用的是kotlin,请使用kotlin官方提供的方法配置apt:
https://www.kotlincn.net/docs/reference/kapt.html
使用
由于Aria涉及到文件和网络的操作,因此需要你在manifest文件中添加以下权限,如果你希望在6.0以上的系统中使用Aria,那么你需要动态向安卓系统申请文件系统读写权限。
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
例子为单任务下载,只需要很简单的代码,便可以实现下载功能。
创建任务
long taskId = Aria.download(this)
.load(DOWNLOAD_URL) //读取下载地址
.setFilePath(DOWNLOAD_PATH) //设置文件保存的完整路径
.create(); //创建并启动下载
停止\恢复任务
Aria.download(this)
.load(taskId) //读取任务id
.stop(); // 停止任务
.resume(); // 恢复任务
任务状态的获取
基于解耦合的考虑,Aria的下载功能是和状态获取相分离的,状态的获取并不会集成到链式代码中,但是Aria提供了另一种更简单更灵活的方案。
通过注解,你可以很容易获取任务的所有状态。
将对象注册到Aria
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Aria.download(this).register();
}
通过注解获取任务执行状态
注意:
注解回掉采用Apt的方式实现,所以,你不需要担心这会影响你机器的性能
被注解的方法不能被private修饰
被注解的方法只能有一个参数,并且参数类型必须是
DownloadTask
或UploadTask
或DownloadGroupTask
方法名可以为任意字符串
//在这里处理任务执行中的状态,如进度进度条的刷新
@Download.onTaskRunning protected void running(DownloadTask task) {
if(task.getKey().eques(url)){
....
可以通过url判断是否是指定任务的回调
}
int p = task.getPercent(); //任务进度百分比
String speed = task.getConvertSpeed(); //转换单位后的下载速度,单位转换需要在配置文件中打开
String speed1 = task.getSpeed(); //原始byte长度速度
}
@Download.onTaskComplete void taskComplete(DownloadTask task) {
//在这里处理任务完成的状态
}
更详细的使用方式我就不介绍了,大家参考文档吧:
https://aria.laoyuyu.me/aria_doc
推荐阅读
二话不说,开干!
扒一扒编程语言排行榜
GitHub for mobile 来了,码农苦逼了
编程·思维·职场
欢迎扫码关注