|
|
|
@ -27,8 +27,8 @@ Aria怎样使用? |
|
|
|
|
[![Download](https://api.bintray.com/packages/arialyy/maven/AriaApi/images/download.svg)](https://bintray.com/arialyy/maven/AriaApi/_latestVersion) |
|
|
|
|
[![Download](https://api.bintray.com/packages/arialyy/maven/AriaCompiler/images/download.svg)](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 优化代码结构,增加优先下载任务功能。 |
|
|
|
|