推荐一个必备的开源项目 (附下载链接)

点击上方“阿拉奇学Java”，选择“置顶或者星标”

优质文章第一时间送达！

推荐阅读 | 大白话讲解技术专业用语

很多人都会遇到下载相关的需求，如果是只下载一个文件那还好，可需求有时候并不会那么简单，领导一句话：下载要支持多任务并行下载，产品经理妹子再来一句：用户下载失败后，下次进来要能接着之前的继续下载，好像有个专业的名词，嗯，叫做断点续传。

这个时候你的压力就来了：mmp，又要多任务并行，又要断点续传，你行你来！

今天我给大家推荐个开源库，解决这一问题。这个开源库是我无意间看到的，觉得还不错，就想着分享给你们。

这个开源库的地址是：https://github.com/AriaLyy/Aria

已经有2.9k star，它的特点是：

• 简单、方便

• 可以在Activity、Service、Fragment、Dialog、popupWindow、Notification等组件中使用

• 支持HTTP\FTP断点续传下载、多任务自动调度

• 支持多文件打包下载，多文件共享同一进度（如：视频 + 封面 + 字幕）

• 支持下载FTP文件夹

• 支持HTTP表单上传

• 支持文件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提供了另一种更简单更灵活的方案。

通过注解，你可以很容易获取任务的所有状态。

1. 将对象注册到Aria

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Aria.download(this).register();
}

1. 通过注解获取任务执行状态

   注意：

• 注解回掉采用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

看到这里啦，说明你对这篇文章感兴趣，帮忙转发一下或者点击文章右下角在看。感谢啦！关注公众号，回复「进群」即可进入无广告技术交流群。同时送上250本电子书+学习视频作为见面礼！
有你想看的精彩 
大白话讲解技术专业用语
看完知乎轮子哥的编程之路，我只想说，收下我的膝盖...
慌了，居然被问到怎么做高并发系统的限流
史上最易懂的 Kubernetes 儿童插图指南
程序员开发了一款软件，完成了舔狗的绝地反杀（代码开源）！
来，手撸一个简版Redis(附源码)
在服务器上排除问题的头 5 分钟