readme 修改

pull/2/head
AriaLyy 8 years ago
parent 98db25f832
commit 2a0348e61b
  1. 40
      BroadCast.md
  2. 53
      README.md

@ -6,32 +6,32 @@ private BroadcastReceiver mReceiver = new BroadcastReceiver() {
@Override public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
//可以通过intent获取到下载实体,下载实体中包含了各种下载状态
DownloadEntity entity = intent.getParcelableExtra(DownloadManager.ENTITY);
DownloadEntity entity = intent.getParcelableExtra(Aria.ENTITY);
switch (action) {
case DownloadManager.ACTION_PRE: //预处理
case Aria.ACTION_PRE: //预处理
break;
case DownloadManager.ACTION_POST_PRE: //预处理完成
case Aria.ACTION_POST_PRE: //预处理完成
//预处理完成,便可以获取文件的下载长度了
len = entity.getFileSize();
break;
case DownloadManager.ACTION_START: //开始下载
case Aria.ACTION_START: //开始下载
L.d(TAG, "download start");
break;
case DownloadManager.ACTION_RESUME: //恢复下载
case Aria.ACTION_RESUME: //恢复下载
L.d(TAG, "download resume");
long location = intent.getLongExtra(DownloadManager.CURRENT_LOCATION, 1);
break;
case DownloadManager.ACTION_RUNNING: //下载中
case Aria.ACTION_RUNNING: //下载中
long current = intent.getLongExtra(DownloadManager.CURRENT_LOCATION, 0);
break;
case DownloadManager.ACTION_STOP: //停止下载
case Aria.ACTION_STOP: //停止下载
L.d(TAG, "download stop");
break;
case DownloadManager.ACTION_COMPLETE: //下载完成
case Aria.ACTION_COMPLETE: //下载完成
break;
case DownloadManager.ACTION_CANCEL: //取消下载
case Aria.ACTION_CANCEL: //取消下载
break;
case DownloadManager.ACTION_FAIL: // 下载失败
case Aria.ACTION_FAIL: // 下载失败
break;
}
}
@ -44,15 +44,15 @@ private BroadcastReceiver mReceiver = new BroadcastReceiver() {
super.onResume();
IntentFilter filter = new IntentFilter();
filter.addDataScheme(getPackageName());
filter.addAction(DownloadManager.ACTION_PRE);
filter.addAction(DownloadManager.ACTION_POST_PRE);
filter.addAction(DownloadManager.ACTION_RESUME);
filter.addAction(DownloadManager.ACTION_START);
filter.addAction(DownloadManager.ACTION_RUNNING);
filter.addAction(DownloadManager.ACTION_STOP);
filter.addAction(DownloadManager.ACTION_CANCEL);
filter.addAction(DownloadManager.ACTION_COMPLETE);
filter.addAction(DownloadManager.ACTION_FAIL);
filter.addAction(Aria.ACTION_PRE);
filter.addAction(Aria.ACTION_POST_PRE);
filter.addAction(Aria.ACTION_RESUME);
filter.addAction(Aria.ACTION_START);
filter.addAction(Aria.ACTION_RUNNING);
filter.addAction(Aria.ACTION_STOP);
filter.addAction(Aria.ACTION_CANCEL);
filter.addAction(Aria.ACTION_COMPLETE);
filter.addAction(Aria.ACTION_FAIL);
registerReceiver(mReceiver, filter);
}
```
```

@ -15,7 +15,7 @@ Aria,致力于让下载傻瓜化</br>
## 下载
[![Download](https://api.bintray.com/packages/arialyy/maven/Aria/images/download.svg)](https://bintray.com/arialyy/maven/Aria/_latestVersion)</br>
```java
compile 'com.arialyy.aria:Aria:2.3.2'
compile 'com.arialyy.aria:Aria:2.3.3'
```
@ -29,12 +29,13 @@ compile 'com.arialyy.aria:Aria:2.3.2'
***
## 使用
### 一、Aria 是实体驱动型的工具,所以,第一步,你需要创建一个下载实体
### 一、只需要以下参数,你便能很简单的使用Aria下载文件了
```java
DownloadEntity mEntity = new DownloadEntity();
mEntity.setFileName(fileName); //设置文件名
mEntity.setDownloadUrl(downloadUrl); //设置下载链接
mEntity.setDownloadPath(downloadPath); //设置存放路径
Aria.whit(this)
.load(DOWNLOAD_URL) //下载地址,必填
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk") //文件保存路径,必填
.setDownloadName("test.apk") //文件名,必填
.start();
```
### 二、为了能接收到Aria传递的数据,你需要把你的Activity或fragment注册到Aria管理器中,注册的方式很简单,在onResume
```java
@ -43,26 +44,44 @@ compile 'com.arialyy.aria:Aria:2.3.2'
Aria.whit(this).addSchedulerListener(new MySchedulerListener());
}
```
### 三、还记得上面的DownloadEntity吗?现在是时候使用它进行下载了
### 三、通过下载链接,你还能使用Aria执行很多操作,如:
- 添加任务(不进行下载)
```java
Aria.whit(this).load(DOWNLOAD_URL)
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() + "/test.apk") //文件保存路径,必填
.setDownloadName("test.apk") //文件名,必填
.add();
```
- 启动下载
```java
Aria.whit(this).load(mEntity).start();
Aria.whit(this).load(DOWNLOAD_URL).start();
```
- 暂停下载
```java
Aria.whit(this).load(mEntity).stop();
Aria.whit(this).load(DOWNLOAD_URL).stop();
```
- 恢复下载
```java
Aria.whit(this).load(mEntity).resume();
Aria.whit(this).load(DOWNLOAD_URL).resume();
```
- 取消下载
```java
Aria.whit(this).load(mEntity).cancel();
Aria.whit(this).load(DOWNLOAD_URL).cancel();
```
- 获取当前下载进度
```java
Aria.whit(this).load(DOWNLOAD_URL).getCurrentProgress();
```
- 获取文件大小
```java
Aria.whit(this).load(DOWNLOAD_URL).getFileSize();
```
### 四、关于Aria,你还需要知道的一些东西
@ -86,7 +105,7 @@ compile 'com.arialyy.aria:Aria:2.3.2'
```java
Aria.get(this).setReTryInterval(5000);
```
- 设置是否打开广播,如果你需要在Service后台获取下载完成情况,那么你需要打开Aria广播,[Aria广播配置](https://github.com/AriaLyy/Aria/blob/v_2.0/BroadCast.md)
- 设置是否打开广播,如果你需要在Service后台获取下载完成情况,那么你需要打开Aria广播,[Aria广播配置](https://github.com/AriaLyy/Aria/blob/v_2.0/BroadCast.md)
```java
Aria.get(this).openBroadcast(true);
@ -94,9 +113,13 @@ compile 'com.arialyy.aria:Aria:2.3.2'
***
## 开发日志
+ v_2.1.0 修复大量bug
+ v_2.1.1 增加,选择最大下载任务数接口
+ v_2.3.3
- 添加断点支持
- 修改下载逻辑,让使用更加简单
- 修复一个内存泄露的bug
+ v_2.3.1 重命名为Aria,下载流程简化
+ v_2.1.1 增加,选择最大下载任务数接口
+ v_2.1.0 修复大量bug
License
-------
@ -113,4 +136,4 @@ License
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.
limitations under the License.

Loading…
Cancel
Save