多任务并行下载，断点续传，要做起来其实还是很麻烦的，所以推荐一个开源库，这个开源库叫 Aria，刚好是我前一久搞断点续传时发现的，仔细了解后发现，真香！！！
它简单易用，是个稳当高效的下载框架，不仅可以断点续传，还支持多任务自动调度，更加灵活的事件监听器，让你能更容易的监听暂停、恢复、完成、失败、取消下载等状态。
开源库地址是：https://github.com/AriaLyy/Aria
目前已经有3.2k star，Aria有以下特点：
- 简单、方便
- 可以在Activity、Service、Fragment、Dialog、popupWindow、Notification等组件中使用
- 支持HTTP\FTP断点续传下载、多任务自动调度
- 支持多文件打包下载，多文件共享同一进度（如：视频 + 封面 + 字幕）
- 支持下载FTP文件夹
- 支持HTTP表单上传
- 支持文件FTP断点续传上传
- 支持FTPS断点续传
- 支持https地址下载
- 支持多线程分块下载，能更有效的发挥机器IO性能
- 支持300、301、302重定向下载链接下载
- 支持m3u8协议的文件下载
- 支持m3u8边下边看的下载支持
- 下载支持文件长度动态增加，文件下载初始化时将不再占用过多的内存空间
它的使用很简单，下面就简单介绍一下：
引入库
implementation 'com.arialyy.aria:core:3.7.9'
annotationProcessor 'com.arialyy.aria:compiler:3.7.9'
# 如果需要使用ftp，请增加该组件
implementation 'com.arialyy.aria:ftpComponent:3.7.9'
# 如果需要使用m3u8下载功能，请增加该组件
implementation 'com.arialyy.aria:m3u8Component:3.7.9'
如果出现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
注：3.7 以上版本已经适配了AndroidX，如果是使用support库的，可使用老版本
使用
由于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) {
//在这里处理任务完成的状态
}
混淆配置
-dontwarn com.arialyy.aria.**
-keep class com.arialyy.aria.**{*;}
-keep class **$$DownloadListenerProxy{ *; }
-keep class **$$UploadListenerProxy{ *; }
-keep class **$$DownloadGroupListenerProxy{ *; }
-keepclasseswithmembernames class * {
@Download.* <methods>;
@Upload.* <methods>;
@DownloadGroup.* <methods>;
}
更多的使用方式可参考文档：https://aria.laoyuyu.me/aria_doc/
网友评论