开始

导入aria

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

compile 'com.arialyy.aria:aria-core:3.5.2'
annotationProcessor 'com.arialyy.aria:aria-compiler:3.5.2'

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

compile('com.arialyy.aria:aria-core:<last-version>'){
   exclude group: 'com.android.support'
}

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

在AndroidManifest文件中添加相应权限

由于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.ACCESS_NETWORK_STATE"/>

注册aria

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

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

启动任务

  Aria.download(this)
      .load(DOWNLOAD_URL)     //读取下载地址
      .setFilePath(DOWNLOAD_PATH) //设置文件保存的完整路径
      .start();   //启动下载

接受任务回调

基于解耦合的考虑，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注解，请查看相应的说明
- 方法名可以为任意字符串
- 注解不生效解决：https://aria.laoyuyu.me/aria_doc/other/annotaion_invalid.html

1.1 开始

开始