Hua/Aria

Fork 0

Files

AriaLyy 0842e4df8f img

2017-03-21 11:25:13 +08:00

5.3 KiB

Raw Blame History

Aria

下载不应该是让人感到痛苦的功能，Aria，让下载更简单。

Aria有以下特点：

简单
可在Dialog、popupWindow等组件中使用
可自定义是否使用广播
支持多线程、多任务下载
支持任务自动切换
支持下载速度直接获取
支持https地址下载

Aria怎样使用？

如果你觉得Aria对你有帮助，您的star和issues将是对我最大支持.^_^

下载

compile 'com.arialyy.aria:Aria:2.4.4'

示例

性能

使用

一、添加权限

<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下载文件了

  Aria.whit(this)
        .load(DOWNLOAD_URL)		//下载地址，必填
        .setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk")	//文件保存路径，必填
        .setDownloadName("test.apk")	//文件名，必填
        .start();

三、为了能接收到Aria传递的数据，你需要把你的Activity或fragment注册到Aria管理器中，注册的方式很简单，在onResume

@Override protected void onResume() {
    super.onResume();
    Aria.whit(this).addSchedulerListener(new MySchedulerListener());
  }

四、通过下载链接，你还能使用Aria执行很多操作，如：

Aria支持https下载，如果你希望使用自己的ca证书，那么你需要进行Aria https证书配置

添加任务（不进行下载）

Aria.whit(this).load(DOWNLOAD_URL)
  .setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk")	//文件保存路径，必填
  .setDownloadName("test.apk")	//文件名，必填
  .add();

启动下载

Aria.whit(this).load(DOWNLOAD_URL).start();

暂停下载

Aria.whit(this).load(DOWNLOAD_URL).stop();

恢复下载

Aria.whit(this).load(DOWNLOAD_URL).resume();

取消下载

Aria.whit(this).load(DOWNLOAD_URL).cancel();

获取当前下载进度

Aria.whit(this).load(DOWNLOAD_URL).getCurrentProgress();

获取文件大小

Aria.whit(this).load(DOWNLOAD_URL).getFileSize();

五、关于Aria，你还需要知道的一些东西

设置下载任务数，Aria默认下载任务为2
```
Aria.get(getContext()).setMaxDownloadNum(num);
```
停止所有下载
```
Aria.get(this).stopAllTask();
```
设置失败重试次数，从事次数不能少于 1
```
Aria.get(this).setReTryNum(10);
```
设置失败重试间隔，重试间隔不能小于 5000ms
```
Aria.get(this).setReTryInterval(5000);
```
设置是否打开广播，如果你需要在Service后台获取下载完成情况，那么你需要打开Aria广播，Aria广播配置
```
Aria.get(this).openBroadcast(true);
```

https证书配置

将你的证书导入assets目录
调用以下代码配置ca证书相关信息

/**
 * 设置CA证书信息
 *
 * @param caAlias ca证书别名
 * @param caPath assets 文件夹下的ca证书完整路径
 */
Aria.get(this).setCAInfo("caAlias","caPath");

开发日志

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给我留言反馈。

License

Copyright 2016 AriaLyy(https://github.com/AriaLyy/Aria)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

5.3 KiB Raw Blame History Unescape Escape