起源
本文主要介绍开源项目Aria的使用。
Aria项目源于15年工作中遇到的一个文件下载管理的需求&＃xff0c;当时被下载折磨的痛不欲生&＃xff0c;从那时起便萌生了编写一个简单易用&＃xff0c;稳当高效的下载框架&＃xff0c;aria经历了1.0到3.0的开发&＃xff0c;算是越来越接近当初所制定的目标了。
以下为Aria的使用示例&＃xff0c;使用Aria开发图片中的所有功能&＃xff0c;只需要很短的时间&＃xff0c;很少的代码。
Aria示例
编写布局文件
android:layout_width&＃61;"match_parent">
android:id&＃61;"&＃64;&＃43;id/progressBar"
android:layout_width&＃61;"wrap_content"
android:layout_height&＃61;"20dp"
android:layout_alignParentLeft&＃61;"true"
android:layout_alignParentStart&＃61;"true"
android:layout_alignParentTop&＃61;"true"
android:layout_margin&＃61;"16dp"
android:layout_toLeftOf&＃61;"&＃64;&＃43;id/size"
android:max&＃61;"100"
style&＃61;"?android:attr/progressBarStyleHorizontal"/>
android:id&＃61;"&＃64;&＃43;id/size"
android:layout_width&＃61;"wrap_content"
android:layout_height&＃61;"wrap_content"
android:layout_alignParentRight&＃61;"true"
android:layout_alignTop&＃61;"&＃64;&＃43;id/progressBar"
android:layout_marginRight&＃61;"16dp"
android:text&＃61;"0mb"
android:textSize&＃61;"16sp"/>
android:id&＃61;"&＃64;&＃43;id/handle_bar"
android:layout_width&＃61;"match_parent"
android:layout_height&＃61;"wrap_content"
android:layout_below&＃61;"&＃64;&＃43;id/progressBar"
android:orientation&＃61;"horizontal">
android:id&＃61;"&＃64;&＃43;id/speed"
android:layout_width&＃61;"wrap_content"
android:layout_height&＃61;"wrap_content"
android:layout_marginLeft&＃61;"16dp"
android:text&＃61;"0kb/s"
android:textColor&＃61;"&＃64;android:color/black"/>
android:id&＃61;"&＃64;&＃43;id/start"
android:layout_width&＃61;"0dp"
android:layout_height&＃61;"wrap_content"
android:layout_weight&＃61;"1"
android:onClick&＃61;"onClick"
android:text&＃61;"开始"
style&＃61;"?buttonBarButtonStyle"/>
android:id&＃61;"&＃64;&＃43;id/stop"
android:layout_width&＃61;"0dp"
android:layout_height&＃61;"wrap_content"
android:layout_weight&＃61;"1"
android:onClick&＃61;"onClick"
android:text&＃61;"暂停"
style&＃61;"?buttonBarButtonStyle"/>
android:id&＃61;"&＃64;&＃43;id/cancel"
android:layout_width&＃61;"0dp"
android:layout_height&＃61;"wrap_content"
android:layout_weight&＃61;"1"
android:onClick&＃61;"onClick"
android:text&＃61;"删除任务"
style&＃61;"?buttonBarButtonStyle"/>
调用Aria的api进行下载
&＃64;OnClick({ R.id.start, R.id.stop, R.id.cancel }) public void onClick(View view) {
switch (view.getId()) {
case R.id.start:
Aria.download(this)
.load(DOWNLOAD_URL)
.setDownloadPath(Environment.getExternalStorageDirectory().getPath() &＃43; "/test.apk")
.start();
break;
case R.id.stop:
Aria.download(this).load(DOWNLOAD_URL).pause();
break;
case R.id.cancel:
Aria.download(this).load(DOWNLOAD_URL).cancel();
break;
}
}
在Aria的下载模块中&＃xff0c;下载链接为下载任务的唯一标识符&＃xff0c;控制一个任务的开始、暂停、恢复、取消下载等操作都需要DOWNLOAD_URL支持。
另外&＃xff0c;在Aira中&＃xff0c;可以调用start()方法开始下载或恢复下载。
为了方便起见&＃xff0c;你也可以调用Aria.download(this).load(DOWNLOAD_URL).resume();实现恢复下载。
Aria 提供了大量的API&＃xff0c;除了以上几个常用的API外&＃xff0c;你还可以Aria Api;
下载事件的获取
在上文中&＃xff0c;我们已经实现在android中下载文件的操作&＃xff0c;是的&＃xff0c;使用Aria&＃xff0c;一行代码你就能实现复杂的断点续传功能。
除了正常的文件需求外&＃xff0c;有的时候&＃xff0c;我们还需要获取文件的下载状态用来更新界面的显示。
在Aria中&＃xff0c;使用Aria的事件监听器&＃xff0c;你能很容易的获取到你想要的很多事件&＃xff0c;如&＃xff1a;
暂停、恢复、完成、失败、取消下载等状态
一句代码获取当前任务的下载速度
一句代码获取当前任务的进度的百分比
一句代码获取当前任务的的文件大小
使用注解实现事件监听
...
&＃64;Download.onPre(DOWNLOAD_URL) protected void onPre(DownloadTask task) {
mUpdateHandler.obtainMessage(DOWNLOAD_PRE, task.getDownloadEntity().getFileSize())
.sendToTarget();
}
&＃64;Download.onTaskStart(DOWNLOAD_URL) void taskStart(DownloadTask task) {
mUpdateHandler.obtainMessage(DOWNLOAD_START, task.getDownloadEntity().getFileSize())
.sendToTarget();
}
&＃64;Download.onTaskRunning(DOWNLOAD_URL) protected void running(DownloadTask task) {
mUpdateHandler.obtainMessage(DOWNLOAD_RUNNING, task).sendToTarget();
}
&＃64;Download.onTaskResume(DOWNLOAD_URL) void taskResume(DownloadTask task) {
mUpdateHandler.obtainMessage(DOWNLOAD_START, task.getFileSize()).sendToTarget();
}
&＃64;Download.onTaskStop(DOWNLOAD_URL) void taskStop(DownloadTask task) {
L.d(TAG, "task__stop");
}
&＃64;Download.onTaskComplete(DOWNLOAD_URL) void taskComplete(DownloadTask task) {
mUpdateHandler.sendEmptyMessage(DOWNLOAD_COMPLETE);
}
上文只列出了常见的下载事件&＃xff0c;更多的下载状态事件见Aria下载事件监听器说明
在Aria中注册新创建的事件监听器
上文中&＃xff0c;已经创建完了事件监听器&＃xff0c;这时&＃xff0c;事件监听器还没能生效&＃xff0c;你还需要将事件监听器注册到Aria中
&＃64;Override protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Aria.download(this).register();
}
最终效果
最终效果
final
以上&＃xff0c;便是使用Aria进行文件下载的所有代码了&＃xff0c;总的来说&＃xff0c;Aria真的很简单。
很少的代码&＃xff0c;你就能实现复杂的文件多线程断点续传功能&＃xff0c;除此之外&＃xff0c;Aria还支持多线程的配置&＃xff0c;使用多少线程下载一个文件&＃xff0c;由你决定&＃xff0c;具体见多线程配置。
Aria默认支持任务自动调度&＃xff0c;从此&＃xff0c;你再也不需要关心任务的暂停、恢复、完成、失败、取消等状态的调度。
京公网安备 11010802041100号