merge v_3.0
This commit is contained in:
AriaLyy
115
README.md
115
README.md
@ -24,9 +24,15 @@ Aria怎样使用？
|
||||
如果你觉得Aria对你有帮助，您的star和issues将是对我最大支持.`^_^`
|
||||
|
||||
## 下载
|
||||
[](https://bintray.com/arialyy/maven/Aria/_latestVersion)</br>
|
||||
[](https://bintray.com/arialyy/maven/AriaApi/_latestVersion)
|
||||
[](https://bintray.com/arialyy/maven/AriaCompiler/_latestVersion)
|
||||
```java
|
||||
<<<<<<< HEAD
|
||||
compile 'com.arialyy.aria:Aria:3.1.6'
|
||||
=======
|
||||
compile 'com.arialyy.aria:Aria:3.1.7'
|
||||
annotationProcessor 'com.arialyy.aria:aria-compiler:3.1.7'
|
||||
>>>>>>> v_3.0
|
||||
```
|
||||
|
||||
## 示例
|
||||
@ -50,7 +56,7 @@ compile 'com.arialyy.aria:Aria:3.1.6'
|
||||
```java
|
||||
Aria.download(this)
|
||||
.load(DOWNLOAD_URL)
|
||||
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk") //文件保存路径
|
||||
.setDownloadPath(DOWNLOAD_PATH) //文件保存路径
|
||||
.add();
|
||||
```
|
||||
|
||||
@ -59,7 +65,7 @@ compile 'com.arialyy.aria:Aria:3.1.6'
|
||||
```java
|
||||
Aria.download(this)
|
||||
.load(DOWNLOAD_URL) //读取下载地址
|
||||
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk") //设置文件保存的完整路径
|
||||
.setDownloadPath(DOWNLOAD_PATH) //设置文件保存的完整路径
|
||||
.start(); //启动下载
|
||||
```
|
||||
* 暂停
|
||||
@ -80,47 +86,69 @@ compile 'com.arialyy.aria:Aria:3.1.6'
|
||||
|
||||
### 下载状态获取
|
||||
如果你希望读取下载进度或下载信息，那么你需要创建事件类，并在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`**
|
||||
- 方法名可以为任意字符串
|
||||
|
||||
* 除了在widget（Activity、Fragment、Dialog、Popupwindow）中使用注解方法外，你还可以在Service、Notification等组件中使用注解函数。
|
||||
|
||||
```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);
|
||||
}
|
||||
|
||||
...
|
||||
}
|
||||
```
|
||||
|
||||
* 将事件注册到Aria
|
||||
@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) {}
|
||||
|
||||
<<<<<<< HEAD
|
||||
```java
|
||||
@Override protected void onResume() {
|
||||
super.onResume();
|
||||
Aria.download(this).addSchedulerListener(new MySchedulerListener());
|
||||
}
|
||||
=======
|
||||
>>>>>>> v_3.0
|
||||
```
|
||||
|
||||
### 使用广播接收器接收Aria的任务下载状态
|
||||
有的时候，你可能希望在广播中接收Aria的下载事件，那么你需要
|
||||
* 在[配置文件](#配置文件设置参数)中把` <openBroadcast value="false"/>`中的value改为true
|
||||
* [点击该链接查看注册Aria广播的方式](https://github.com/AriaLyy/Aria/blob/master/BroadCast.md)
|
||||
|
||||
### Aria参数配置
|
||||
#### 配置文件设置参数
|
||||
@ -135,7 +163,7 @@ compile 'com.arialyy.aria:Aria:3.1.6'
|
||||
<!--设置下载线程，线程下载数改变后，新的下载任务才会生效-->
|
||||
<threadNum value="4"/>
|
||||
|
||||
<!--是否打开下载广播，默认为false-->
|
||||
<!--是否打开下载广播，默认为false，不建议使用广播，你可以使用Download注解来实现事件回调-->
|
||||
<openBroadcast value="false"/>
|
||||
|
||||
<!--设置下载队列最大任务数， 默认为2-->
|
||||
@ -145,7 +173,7 @@ compile 'com.arialyy.aria:Aria:3.1.6'
|
||||
<reTryNum value="10"/>
|
||||
|
||||
<!--设置重试间隔，单位为毫秒，默认2000毫秒-->
|
||||
<reTryInterval value="2000"/>
|
||||
<reTryInterval value="5000"/>
|
||||
|
||||
<!--设置url连接超时时间，单位为毫秒，默认5000毫秒-->
|
||||
<connectTimeOut value="5000"/>
|
||||
@ -160,12 +188,15 @@ compile 'com.arialyy.aria:Aria:3.1.6'
|
||||
<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-->
|
||||
@ -260,11 +291,18 @@ Aria.download(this).load(DOWNLOAD_URL).setDownloadPath(PATH).setHighestPriority(
|
||||
```java
|
||||
Aria.upload(this).load(filePath).cancel();
|
||||
```
|
||||
|
||||
|
||||
## 混淆配置
|
||||
```
|
||||
-dontwarn com.arialyy.aria.**
|
||||
-keep class com.arialyy.aria.**{*;}
|
||||
-keep class **$$DownloadListenerProxy{ *; }
|
||||
-keep class **$$UploadListenerProxy{ *; }
|
||||
-keepclasseswithmembernames class * {
|
||||
@Download.* <methods>;
|
||||
@Upload.* <methods>;
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
## 其他
|
||||
@ -278,7 +316,12 @@ Aria.download(this).load(DOWNLOAD_URL).setDownloadPath(PATH).setHighestPriority(
|
||||
|
||||
|
||||
## 开发日志
|
||||
<<<<<<< HEAD
|
||||
+ v_3.1.6 [取消任务时onTaskCancel回调两次的bug](https://github.com/AriaLyy/Aria/issues/33)
|
||||
=======
|
||||
+ v_3.1.7 修复某些文件下载不了的bug，增加apt注解方法，事件获取更加简单了
|
||||
+ v_3.1.6 取消任务时onTaskCancel回调两次的bug
|
||||
>>>>>>> v_3.0
|
||||
+ v_3.1.5 优化代码结构，增加优先下载任务功能。
|
||||
+ v_3.1.4 修复快速切换，暂停、恢复功能时，概率性出现的重新下载问题，添加onPre()回调，onPre()用于请求地址之前执行界面UI更新操作。
|
||||
+ v_3.1.0 添加Aria配置文件，优化代码
|
||||
|
||||
Reference in New Issue
Block a user