合并 v_3.0代码
This commit is contained in:
AriaLyy
217
README.md
217
README.md
@ -1,153 +1,158 @@
|
||||
# Aria
|
||||
</br>
|
||||
下载不应该是让人感到痛苦的功能，Aria，让下载更简单。</br>
|
||||
Aria，让上传、下载更容易实现</br>
|
||||
+ Aria有以下特点：
|
||||
- 简单
|
||||
- 可在Dialog、popupWindow等组件中使用
|
||||
- 可自定义是否使用广播
|
||||
- 支持多线程、多任务下载
|
||||
- 支持任务自动切换
|
||||
- 支持下载速度直接获取
|
||||
- 支持多任务自动调度
|
||||
- 可以直接获取速度
|
||||
- 支持https地址下载
|
||||
- 支持上传操作
|
||||
|
||||
[Aria怎样使用？](#使用)
|
||||
Aria怎样使用？
|
||||
* [下载](#使用)
|
||||
* [上传](#上传)
|
||||
|
||||
如果你觉得Aria对你有帮助，您的star和issues将是对我最大支持.`^_^`
|
||||
|
||||
## 下载
|
||||
[](https://bintray.com/arialyy/maven/Aria/_latestVersion)</br>
|
||||
```java
|
||||
compile 'com.arialyy.aria:Aria:2.4.4'
|
||||
compile 'com.arialyy.aria:Aria:3.0.0'
|
||||
```
|
||||
|
||||
## 示例
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 性能
|
||||
|
||||
|
||||
***
|
||||
## 使用
|
||||
### 一、添加权限
|
||||
由于Aria涉及到文件和网络的操作，因此需要你在manifest文件中添加以下权限
|
||||
```xml
|
||||
<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"/>
|
||||
```
|
||||
### 二、只需要以下参数，你便能很简单的使用Aria下载文件了
|
||||
```java
|
||||
Aria.whit(this)
|
||||
.load(DOWNLOAD_URL) //下载地址，必填
|
||||
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk") //文件保存路径，必填
|
||||
.setDownloadName("test.apk") //文件名，必填
|
||||
.start();
|
||||
```
|
||||
### 三、为了能接收到Aria传递的数据，你需要把你的Activity或fragment注册到Aria管理器中，注册的方式很简单，在onResume
|
||||
```java
|
||||
@Override protected void onResume() {
|
||||
|
||||
## 使用Aria进行下载
|
||||
* 添加任务（不进行下载），当其他下载任务完成时，将自动下载等待中的任务
|
||||
```java
|
||||
Aria.download(this)
|
||||
.load(DOWNLOAD_URL)
|
||||
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk") //文件保存路径
|
||||
.add();
|
||||
```
|
||||
|
||||
* 下载
|
||||
|
||||
```java
|
||||
Aria.download(this)
|
||||
.load(DOWNLOAD_URL) //读取下载地址
|
||||
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk") //设置文件保存的完整路径
|
||||
.start(); //启动下载
|
||||
```
|
||||
* 暂停
|
||||
|
||||
```java
|
||||
Aria.download(this).load(DOWNLOAD_URL).pause();
|
||||
```
|
||||
* 恢复下载
|
||||
|
||||
```java
|
||||
Aria.download(this).load(DOWNLOAD_URL).resume();
|
||||
```
|
||||
* 取消下载
|
||||
|
||||
```java
|
||||
Aria.download(this).load(DOWNLOAD_URL).cancel();
|
||||
```
|
||||
|
||||
### 二、如果你希望读取下载进度或下载信息，那么你需要创建事件类，并在onResume(Activity、Fragment)或构造函数(Dialog、PopupWindow)，将该事件类注册到Aria管理器。
|
||||
* 创建事件类
|
||||
|
||||
```java
|
||||
final static class MySchedulerListener extends Aria.DownloadSchedulerListener{
|
||||
@Override public void onTaskPre(DownloadTask task) {
|
||||
super.onTaskPre(task);
|
||||
}
|
||||
|
||||
@Override public void onTaskStop(DownloadTask task) {
|
||||
super.onTaskStop(task);
|
||||
}
|
||||
|
||||
@Override public void onTaskCancel(DownloadTask task) {
|
||||
super.onTaskCancel(task);
|
||||
}
|
||||
|
||||
@Override public void onTaskRunning(DownloadTask task) {
|
||||
super.onTaskRunning(task);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
* 将事件注册到Aria
|
||||
|
||||
```java
|
||||
@Override protected void onResume() {
|
||||
super.onResume();
|
||||
Aria.whit(this).addSchedulerListener(new MySchedulerListener());
|
||||
}
|
||||
```
|
||||
### 四、通过下载链接，你还能使用Aria执行很多操作，如：
|
||||
Aria支持https下载，如果你希望使用自己的ca证书，那么你需要进行[Aria https证书配置](#https证书配置)
|
||||
- 添加任务（不进行下载）
|
||||
|
||||
```java
|
||||
Aria.whit(this).load(DOWNLOAD_URL)
|
||||
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk") //文件保存路径，必填
|
||||
.setDownloadName("test.apk") //文件名，必填
|
||||
.add();
|
||||
```
|
||||
- 启动下载
|
||||
|
||||
```java
|
||||
Aria.whit(this).load(DOWNLOAD_URL).start();
|
||||
```
|
||||
- 暂停下载
|
||||
|
||||
```java
|
||||
Aria.whit(this).load(DOWNLOAD_URL).stop();
|
||||
```
|
||||
- 恢复下载
|
||||
|
||||
```java
|
||||
Aria.whit(this).load(DOWNLOAD_URL).resume();
|
||||
```
|
||||
- 取消下载
|
||||
|
||||
```java
|
||||
Aria.whit(this).load(DOWNLOAD_URL).cancel();
|
||||
```
|
||||
- 获取当前下载进度
|
||||
|
||||
```java
|
||||
Aria.whit(this).load(DOWNLOAD_URL).getCurrentProgress();
|
||||
```
|
||||
- 获取文件大小
|
||||
|
||||
```java
|
||||
Aria.whit(this).load(DOWNLOAD_URL).getFileSize();
|
||||
```
|
||||
|
||||
### 五、关于Aria，你还需要知道的一些东西
|
||||
- 设置下载任务数，Aria默认下载任务为**2**
|
||||
### 关于下载的其它api
|
||||
[Download API](https://github.com/AriaLyy/Aria/blob/master/DownloadApi.md)
|
||||
|
||||
```java
|
||||
Aria.get(getContext()).setMaxDownloadNum(num);
|
||||
```
|
||||
- 停止所有下载
|
||||
**tips:为了防止内存泄露的情况，事件类需要使用staic进行修饰**
|
||||
|
||||
```java
|
||||
Aria.get(this).stopAllTask();
|
||||
```
|
||||
- 设置失败重试次数，从事次数不能少于 1
|
||||
## 上传
|
||||
* 添加任务(只添加，不上传)
|
||||
|
||||
```java
|
||||
Aria.get(this).setReTryNum(10);
|
||||
```
|
||||
- 设置失败重试间隔，重试间隔不能小于 5000ms
|
||||
```java
|
||||
Aria.upload(this)
|
||||
.load(filePath) //文件路径
|
||||
.setUploadUrl(uploadUrl) //上传路径
|
||||
.setAttachment(fileKey) //服务器读取文件的key
|
||||
.add();
|
||||
```
|
||||
|
||||
```java
|
||||
Aria.get(this).setReTryInterval(5000);
|
||||
```
|
||||
- 设置是否打开广播，如果你需要在Service后台获取下载完成情况，那么你需要打开Aria广播，[Aria广播配置](https://github.com/AriaLyy/Aria/blob/v_2.0/BroadCast.md)
|
||||
* 上传
|
||||
|
||||
```java
|
||||
Aria.get(this).openBroadcast(true);
|
||||
```
|
||||
```java
|
||||
Aria.upload(this)
|
||||
.load(filePath) //文件路径
|
||||
.setUploadUrl(uploadUrl) //上传路径
|
||||
.setAttachment(fileKey) //服务器读取文件的key
|
||||
.start();
|
||||
```
|
||||
* 取消上传
|
||||
|
||||
### https证书配置
|
||||
+ 将你的证书导入`assets`目录
|
||||
+ 调用以下代码配置ca证书相关信息
|
||||
```java
|
||||
Aria.upload(this)
|
||||
.load(filePath)
|
||||
.cancel();
|
||||
```
|
||||
|
||||
```java
|
||||
/**
|
||||
* 设置CA证书信息
|
||||
*
|
||||
* @param caAlias ca证书别名
|
||||
* @param caPath assets 文件夹下的ca证书完整路径
|
||||
*/
|
||||
Aria.get(this).setCAInfo("caAlias","caPath");
|
||||
```
|
||||
## 其他
|
||||
有任何问题，可以在[issues](https://github.com/AriaLyy/Aria/issues)给我留言反馈。
|
||||
|
||||
***
|
||||
|
||||
## 开发日志
|
||||
+ v_2.4.4 修复不支持断点的下载链接拿不到文件大小的问题
|
||||
+ v_2.4.3 修复404链接卡顿的问题
|
||||
+ v_2.4.2 修复失败重试无效的bug
|
||||
+ v_2.4.1 修复下载慢的问题，修复application、service 不能使用的问题
|
||||
+ v_2.4.0 支持https链接下载
|
||||
+ v_2.3.8 修复数据错乱的bug、添加fragment支持
|
||||
+ v_2.3.6 添加dialog、popupWindow支持
|
||||
+ v_2.3.3 添加断点支持、修改下载逻辑，让使用更加简单、修复一个内存泄露的bug
|
||||
+ v_2.3.1 重命名为Aria，下载流程简化
|
||||
+ v_2.1.1 增加，选择最大下载任务数接口
|
||||
|
||||
## 其他
|
||||
有任何问题，可以在[issues](https://github.com/AriaLyy/Aria/issues)给我留言反馈。
|
||||
+ v_3.0.0 添加上传任务支持，修复一些已发现的bug
|
||||
+ v_2.4.4 修复不支持断点的下载链接拿不到文件大小的问题
|
||||
+ v_2.4.3 修复404链接卡顿的问题
|
||||
+ v_2.4.2 修复失败重试无效的bug
|
||||
+ v_2.4.1 修复下载慢的问题，修复application、service 不能使用的问题
|
||||
+ v_2.4.0 支持https链接下载
|
||||
+ v_2.3.8 修复数据错乱的bug、添加fragment支持
|
||||
+ v_2.3.6 添加dialog、popupWindow支持
|
||||
+ v_2.3.3 添加断点支持、修改下载逻辑，让使用更加简单、修复一个内存泄露的bug
|
||||
+ v_2.3.1 重命名为Aria，下载流程简化
|
||||
+ v_2.1.1 增加，选择最大下载任务数接口
|
||||
|
||||
License
|
||||
-------
|
||||
|
||||
Reference in New Issue
Block a user