bug 修复,readme编写

This commit is contained in:
AriaLyy
2017-06-13 00:04:55 +08:00
parent 30605c6c01
commit 0bc96efaaf
15 changed files with 447 additions and 140 deletions

View File

@ -79,43 +79,49 @@ compile 'com.arialyy.aria:Aria:3.1.5'
### 下载状态获取
如果你希望读取下载进度或下载信息那么你需要创建事件类并在onResume(Activity、Fragment)或构造函数(Dialog、PopupWindow)将该事件类注册到Aria管理器。
* 创建事件类
* 将对象注册到Aria
` Aria.download(this).register();`或`Aria.upload(this).register();`
```java
@Override protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Aria.download(this).register();
}
```
* 使用'@Download'或'@Upload'注解你的函数
**注意:**
- 注解回掉采用Apt的方式实现所以你不需要担心这会影响你机器的性能
- 被注解的方法**不能被private修饰**
- 被注解的方法**只能有一个参数,并且参数类型必须是`DownloadTask`或`UploadTask`**
- 方法名可以为任意字符
```java
final static class MySchedulerListener extends Aria.DownloadSchedulerListener{
@Override public void onTaskPre(DownloadTask task) {
//通过下载地址可以判断任务是否是你指定的任务
if (task.getKey().equals(DOWNLOAD_URL)) {
mUpdateHandler.obtainMessage(DOWNLOAD_PRE, task.getDownloadEntity().getFileSize())
.sendToTarget();
}
}
@Download.onPre protected void onPre(DownloadTask task) {}
@Override public void onTaskStop(DownloadTask task) {
super.onTaskStop(task);
@Download.onTaskStart void taskStart(DownloadTask task) {
//通过下载地址可以判断任务是否是你指定的任务
if (task.getKey().equals(DOWNLOAD_URL)) {
}
@Override public void onTaskCancel(DownloadTask task) {
super.onTaskCancel(task);
}
@Override public void onTaskRunning(DownloadTask task) {
super.onTaskRunning(task);
}
...
}
@Download.onTaskRunning protected void running(DownloadTask task) {}
@Download.onTaskResume void taskResume(DownloadTask task) {}
@Download.onTaskStop void taskStop(DownloadTask task) {}
@Download.onTaskCancel void taskCancel(DownloadTask task) {}
@Download.onTaskFail void taskFail(DownloadTask task) {}
@Download.onTaskComplete void taskComplete(DownloadTask task) {}
@Download.onNoSupportBreakPoint public void onNoSupportBreakPoint(DownloadTask task) {}
```
* 将事件注册到Aria
```java
@Override protected void onResume() {
super.onResume();
Aria.whit(this).addSchedulerListener(new MySchedulerListener());
}
```
### 使用广播接收器接收Aria的任务下载状态
有的时候你可能希望在广播中接收Aria的下载事件那么你需要
* 在[配置文件](#配置文件设置参数)中把` <openBroadcast value="false"/>`中的value改为true
@ -134,7 +140,7 @@ compile 'com.arialyy.aria:Aria:3.1.5'
<!--设置下载线程,线程下载数改变后,新的下载任务才会生效-->
<threadNum value="4"/>
<!--是否打开下载广播默认为false-->
<!--是否打开下载广播默认为false不建议使用广播你可以使用Download注解来实现事件回调-->
<openBroadcast value="false"/>
<!--设置下载队列最大任务数, 默认为2-->
@ -144,7 +150,7 @@ compile 'com.arialyy.aria:Aria:3.1.5'
<reTryNum value="10"/>
<!--设置重试间隔单位为毫秒默认2000毫秒-->
<reTryInterval value="2000"/>
<reTryInterval value="5000"/>
<!--设置url连接超时时间单位为毫秒默认5000毫秒-->
<connectTimeOut value="5000"/>
@ -159,12 +165,15 @@ compile 'com.arialyy.aria:Aria:3.1.5'
<ca name="" path=""/>
<!--是否需要转换速度单位转换完成后为1b/s、1kb/s、1mb/s、1gb/s、1tb/s如果不需要将返回byte长度-->
<convertSpeed value="false"/>
<convertSpeed value="true"/>
<!--设置最大下载速度单位kb, 为0表示不限速-->
<maxSpeed value="0"/>
</download>
<upload>
<!--是否打开上传广播默认为false-->
<!--是否打开上传广播默认为false不建议使用广播你可以使用Upload注解来实现事件回调-->
<openBroadcast value="false"/>
<!--设置上传队列最大任务数, 默认为2-->