项目源于工作中遇到的一个文件下载管理的需求,当时被下载折磨的痛不欲生,从那时起便萌生了编写一个简单易用,稳当高效的下载框架,aria经历了1.0到3.0的开发,算是越来越接近当初所制定的目标了。
特点:
简单、方便
可以在Activity、Service、Fragment、Dialog、popupWindow、Notification等组件中使用
一行代码实现HTTPFTP断线续传、多任务自动调度
一行代码实现HTTP任务组FTP文件夹下载
一行代码实现HTTPFTP断点续传上传
支持https地址下载
在配置文件中很容易就可以设置CA证书的信息
支持300、301、302重定向下载链接下载
compile 'com.arialyy.aria:aria-core:3.2.26'
annotationProcessor 'com.arialyy.aria:aria-compiler:3.2.26'
使用
由于涉及到文件和网络的操作,因此需要你在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"/>
使用Aria
基本使用
例子为单任务下载,只需要很简单的代码,便可以实现下载功能
Aria.download(this)
.load(DOWNLOAD_URL) //读取下载地址
.setDownloadPath(DOWNLOAD_PATH) //设置文件保存的完整路径
.start(); //启动下载
任务状态的获取
基于解耦合的考虑,Aria的下载功能是和状态获取相分离的,状态的获取并不会集成到链式代码中,但是Aria提供了另一种更简单更灵活的方案。 通过注解,你可以很容易获取任务的所有状态。
将对象注册到Aria
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Aria.download(this).register();
}
通过注解获取任务执行状态 注意:
注解回掉采用Apt的方式实现,所以,你不需要担心这会影响你机器的性能
被注解的方法不能被private修饰
被注解的方法只能有一个参数,并且参数类型必须是DownloadTask或UploadTask或DownloadGroupTask
方法名可以为任意字符串
//在这里处理任务执行中的状态,如进度进度条的刷新
@Download.onTaskRunning(DOWNLOAD_URL) protected void running(DownloadTask task) {
int p = task.getPercent(); //任务进度百分比
String speed = task.getConvertSpeed(); //转换单位后的下载速度,单位转换需要在配置文件中打开
String speed1 = task.getSpeed(); //原始byte长度速度
}
@Download.onTaskComplete(DOWNLOAD_URL) void taskComplete(DownloadTask task) {
//在这里处理任务完成的状态
}
资源均来自第三方,谨慎下载,前往第三方网站下载