|  |  |  | @ -27,8 +27,8 @@ Aria怎样使用? | 
			
		
	
		
			
				
					|  |  |  |  | [](https://bintray.com/arialyy/maven/AriaApi/_latestVersion) | 
			
		
	
		
			
				
					|  |  |  |  | [](https://bintray.com/arialyy/maven/AriaCompiler/_latestVersion) | 
			
		
	
		
			
				
					|  |  |  |  | ```java | 
			
		
	
		
			
				
					|  |  |  |  | compile 'com.arialyy.aria:Aria:3.1.8' | 
			
		
	
		
			
				
					|  |  |  |  | annotationProcessor 'com.arialyy.aria:aria-compiler:3.1.8' | 
			
		
	
		
			
				
					|  |  |  |  | compile 'com.arialyy.aria:Aria:3.1.9' | 
			
		
	
		
			
				
					|  |  |  |  | annotationProcessor 'com.arialyy.aria:aria-compiler:3.1.9' | 
			
		
	
		
			
				
					|  |  |  |  | ``` | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | ## 示例 | 
			
		
	
	
		
			
				
					|  |  |  | @ -83,18 +83,18 @@ annotationProcessor 'com.arialyy.aria:aria-compiler:3.1.8' | 
			
		
	
		
			
				
					|  |  |  |  | ### 下载状态获取 | 
			
		
	
		
			
				
					|  |  |  |  | 如果你希望读取下载进度或下载信息,那么你需要创建事件类,并在onResume(Activity、Fragment)或构造函数(Dialog、PopupWindow),将该事件类注册到Aria管理器。 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | * 将对象注册到Aria | 
			
		
	
		
			
				
					|  |  |  |  | 1. 将对象注册到Aria | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | ` Aria.download(this).register();`或`Aria.upload(this).register();` | 
			
		
	
		
			
				
					|  |  |  |  | ```java | 
			
		
	
		
			
				
					|  |  |  |  |  `Aria.download(this).register();`或`Aria.upload(this).register();` | 
			
		
	
		
			
				
					|  |  |  |  |  ```java | 
			
		
	
		
			
				
					|  |  |  |  |  @Override | 
			
		
	
		
			
				
					|  |  |  |  |  protected void onCreate(Bundle savedInstanceState) { | 
			
		
	
		
			
				
					|  |  |  |  |     super.onCreate(savedInstanceState); | 
			
		
	
		
			
				
					|  |  |  |  |     Aria.download(this).register(); | 
			
		
	
		
			
				
					|  |  |  |  |   } | 
			
		
	
		
			
				
					|  |  |  |  | ``` | 
			
		
	
		
			
				
					|  |  |  |  |  ``` | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | * 使用'@Download'或'@Upload'注解你的函数 | 
			
		
	
		
			
				
					|  |  |  |  | 2. 使用`@Download`或`@Upload`注解你的函数 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  |  **注意:** | 
			
		
	
		
			
				
					|  |  |  |  |  - 注解回掉采用Apt的方式实现,所以,你不需要担心这会影响你机器的性能 | 
			
		
	
	
		
			
				
					|  |  |  | @ -102,18 +102,14 @@ annotationProcessor 'com.arialyy.aria:aria-compiler:3.1.8' | 
			
		
	
		
			
				
					|  |  |  |  |  - 被注解的方法**只能有一个参数,并且参数类型必须是`DownloadTask`或`UploadTask`** | 
			
		
	
		
			
				
					|  |  |  |  |  - 方法名可以为任意字符串 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | * 除了在widget(Activity、Fragment、Dialog、Popupwindow)中使用注解方法外,你还可以在Service、Notification等组件中使用注解函数。 | 
			
		
	
		
			
				
					|  |  |  |  | 3. 除了在widget(Activity、Fragment、Dialog、Popupwindow)中使用注解方法外,你还可以在Service、Notification等组件中使用注解函数。 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  |   ```java | 
			
		
	
		
			
				
					|  |  |  |  |   @Download.onPre | 
			
		
	
		
			
				
					|  |  |  |  |   @Download.onPre(DOWNLOAD_URL) | 
			
		
	
		
			
				
					|  |  |  |  |   protected void onPre(DownloadTask task) {} | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  |   @Download.onTaskStart | 
			
		
	
		
			
				
					|  |  |  |  |   void taskStart(DownloadTask task) { | 
			
		
	
		
			
				
					|  |  |  |  |     //通过下载地址可以判断任务是否是你指定的任务 | 
			
		
	
		
			
				
					|  |  |  |  |     if (task.getKey().equals(DOWNLOAD_URL)) { | 
			
		
	
		
			
				
					|  |  |  |  |     } | 
			
		
	
		
			
				
					|  |  |  |  |   } | 
			
		
	
		
			
				
					|  |  |  |  |   void taskStart(DownloadTask task) {} | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  |   @Download.onTaskRunning | 
			
		
	
		
			
				
					|  |  |  |  |   protected void running(DownloadTask task) {} | 
			
		
	
	
		
			
				
					|  |  |  | @ -137,6 +133,19 @@ annotationProcessor 'com.arialyy.aria:aria-compiler:3.1.8' | 
			
		
	
		
			
				
					|  |  |  |  |   public void onNoSupportBreakPoint(DownloadTask task) {} | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  |   ``` | 
			
		
	
		
			
				
					|  |  |  |  | 4. 如果你希望对单个任务,或某一些特定任务设置监听器。 | 
			
		
	
		
			
				
					|  |  |  |  |  在注解中添加任务的下载地址,**则表示只有该任务才会触发被注解的方法**。 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  |  ```java | 
			
		
	
		
			
				
					|  |  |  |  |  @Download.onTaskRunning({ | 
			
		
	
		
			
				
					|  |  |  |  |       "https://test.xx.apk", | 
			
		
	
		
			
				
					|  |  |  |  |       "http://test.xx2.apk" | 
			
		
	
		
			
				
					|  |  |  |  |   }) void taskRunning(DownloadTask task) { | 
			
		
	
		
			
				
					|  |  |  |  |     mAdapter.setProgress(task.getDownloadEntity()); | 
			
		
	
		
			
				
					|  |  |  |  |   } | 
			
		
	
		
			
				
					|  |  |  |  |  ``` | 
			
		
	
		
			
				
					|  |  |  |  | 在上面的例子中,只有下载地址是`https://test.xx.apk`和`http://test.xx2.apk`才会触发 | 
			
		
	
		
			
				
					|  |  |  |  | `taskRunning(DownloadTask task)`方法。 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | ### Aria参数配置 | 
			
		
	
		
			
				
					|  |  |  |  | #### 配置文件设置参数 | 
			
		
	
	
		
			
				
					|  |  |  | @ -216,24 +225,33 @@ Aria.get(this).getDownloadConfig().setMaxTaskNum(3); | 
			
		
	
		
			
				
					|  |  |  |  | ### 常用接口 | 
			
		
	
		
			
				
					|  |  |  |  | * 停止所有任务 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | ```java | 
			
		
	
		
			
				
					|  |  |  |  | Aria.download(this).stopAllTask(); | 
			
		
	
		
			
				
					|  |  |  |  | ``` | 
			
		
	
		
			
				
					|  |  |  |  |  ```java | 
			
		
	
		
			
				
					|  |  |  |  |  Aria.download(this).stopAllTask(); | 
			
		
	
		
			
				
					|  |  |  |  |  ``` | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | * 恢复所有停止的任务 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  |  ```java | 
			
		
	
		
			
				
					|  |  |  |  | Aria.download(this).resumeAllTask(); | 
			
		
	
		
			
				
					|  |  |  |  |  ``` | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | * 删除所有任务 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | ```java | 
			
		
	
		
			
				
					|  |  |  |  | Aria.download(this).removeAllTask(); | 
			
		
	
		
			
				
					|  |  |  |  | ``` | 
			
		
	
		
			
				
					|  |  |  |  |  ```java | 
			
		
	
		
			
				
					|  |  |  |  |  Aria.download(this).removeAllTask(); | 
			
		
	
		
			
				
					|  |  |  |  |  ``` | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | * 获取当前任务的下载速度 | 
			
		
	
		
			
				
					|  |  |  |  | 速度参数有点特殊,需要[下载事件支持](#下载状态获取) | 
			
		
	
		
			
				
					|  |  |  |  | ``` java | 
			
		
	
		
			
				
					|  |  |  |  | @Override public void onTaskRunning(DownloadTask task) { | 
			
		
	
		
			
				
					|  |  |  |  |   //如果你打开了速度单位转换配置,将可以通过以下方法获取带单位的下载速度,如:1 m/s | 
			
		
	
		
			
				
					|  |  |  |  |   //如果你打开了速度单位转换配置,将可以通过以下方法获取带单位的下载速度,如:1 mb/s | 
			
		
	
		
			
				
					|  |  |  |  |   String convertSpeed = task.getConvertSpeed(); | 
			
		
	
		
			
				
					|  |  |  |  |   //如果你有自己的单位格式,可以通过以下方法获取原始byte长度 | 
			
		
	
		
			
				
					|  |  |  |  |   long speed = task.getSpeed(); | 
			
		
	
		
			
				
					|  |  |  |  | } | 
			
		
	
		
			
				
					|  |  |  |  | ``` | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | * 获取下载的文件大小、当前进度百分比 | 
			
		
	
		
			
				
					|  |  |  |  | 同样的,你也可以在DownloadTask对象中获取下载的文件大小 | 
			
		
	
		
			
				
					|  |  |  |  | ``` | 
			
		
	
	
		
			
				
					|  |  |  | @ -246,14 +264,13 @@ Aria.download(this).removeAllTask(); | 
			
		
	
		
			
				
					|  |  |  |  |   int percent = task.getPercent(); | 
			
		
	
		
			
				
					|  |  |  |  | } | 
			
		
	
		
			
				
					|  |  |  |  | ``` | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | * 设置高优先级任务 | 
			
		
	
		
			
				
					|  |  |  |  | 如果你希望优先下载某一个任务,你可以 | 
			
		
	
		
			
				
					|  |  |  |  | ``` java | 
			
		
	
		
			
				
					|  |  |  |  | Aria.download(this).load(DOWNLOAD_URL).setDownloadPath(PATH).setHighestPriority(); | 
			
		
	
		
			
				
					|  |  |  |  | ``` | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | **tips:为了防止内存泄露的情况,事件类需要使用staic进行修饰** | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | ## 上传 | 
			
		
	
		
			
				
					|  |  |  |  |  * 添加任务(只添加,不上传) | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
	
		
			
				
					|  |  |  | @ -304,6 +321,7 @@ Aria.download(this).load(DOWNLOAD_URL).setDownloadPath(PATH).setHighestPriority( | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | 
 | 
			
		
	
		
			
				
					|  |  |  |  | ## 开发日志 | 
			
		
	
		
			
				
					|  |  |  |  |   + v_3.1.9 修复stopAll队列没有任务时崩溃的问题,增加针对单个任务监听的功能 | 
			
		
	
		
			
				
					|  |  |  |  |   + v_3.1.7 修复某些文件下载不了的bug,增加apt注解方法,事件获取更加简单了 | 
			
		
	
		
			
				
					|  |  |  |  |   + v_3.1.6 取消任务时onTaskCancel回调两次的bug | 
			
		
	
		
			
				
					|  |  |  |  |   + v_3.1.5 优化代码结构,增加优先下载任务功能。 | 
			
		
	
	
		
			
				
					|  |  |  | 
 |