开始

导入类库

在app目录下的build.gradle文件中添加以下依赖

implementation 'com.arialyy.aria:core:3.8.5'

annotationProcessor 'com.arialyy.aria:compiler:3.8.5'

如果出现android support，请将 compile 'com.arialyy.aria:aria-core:'替换为

compile('com.arialyy.aria:aria-core:'){

exclude group: 'androidx.appcompat.app'

}

如果你使用的是kotlin，请使用kotlin官方提供的方法配置apt，kotlin kapt官方配置传送门

在AndroidManifest文件中添加相应权限

由于Aria涉及到文件和网络的操作，因此需要你在manifest文件中添加以下权限，如果你希望在6.0以上的系统中使用Aria，那么你需要动态向安卓系统申请文件系统读写权限，如何使用安卓系统权限

注册aria

在Activity的onCreate、fragment的onCreate、java的构造函数中使用Aria.download(this).register();便可以实现注册。

如在activity中：

protected void onCreate(Bundle savedInstanceState){

super.onCreate(savedInstanceState);

Aria.download(this).register();

}

创建任务

创建并启动一个下载任务，创建任务完成后，可获取到该任务的id。

long taskId = Aria.download(this)

.load(DOWNLOAD_URL) //读取下载地址

.setFilePath(DOWNLOAD_PATH) //设置文件保存的完整路径

.create(); //启动下载

停止\恢复任务

使用通过创建任务获取的任务id，可对任务进行停止、恢复等操作

Aria.download(this)

.load(taskId)

.stop();

//.resume();

接受任务回调

基于解耦合的考虑，Aria的下载功能是和状态获取相分离的，状态的获取并不会集成到链式代码中，但是Aria提供了另一种更简单更灵活的方案。

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

//在这里处理任务执行中的状态，如进度进度条的刷新

@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){

//在这里处理任务完成的状态

}

非android界面组件中使用

如果你希望在android的非组件类中使用Aria，可以任意类中使用

其它

注意事项

注解回掉采用Apt的方式实现(和butterknife原理一样)，所以，你不需要担心这会影响你机器的性能

被注解的方法不能被private修饰

被注解的方法除了onFail和DownloadGroupSubTask注解外，其它注解 只能有一个参数，并且参数类型必须是DownloadTask或UploadTask或DownloadGroupTask，如果是onFail注解或DownloadGroupSubTask注解，请查看相应的说明

方法名可以为任意字符串

Copyright © 2018 laoyuyu. | 蜀ICP备17031160号.            更新时间： 2020-01-17