Skip to content

一个简单的Android网络下载器,支持多任务下载、多界面管理、断点等常用操作

License

Notifications You must be signed in to change notification settings

Dpuntu/android-downloader

Repository files navigation

android-downloader

一个简单的支持多任务下载、多界面管理、可断点下载的网络下载器

最新版 v1.0.0

API Language: Kotlin License: GPL-3.0

1.下载器简介

这个下载器是我在写AppStore的时候自己搞的玩意,当时为了让多界面同步更新下载所做的东西,但是后来想想觉得应该可以单独拿出来封装,以后用到了就可以直接使用,不需要再做修改什么了,所以才有了这个项目,下载器是以okhttp为基础的,不懂okhttp也没关系,不过最好还是熟悉下,网上资源很多的 嗯,那么说下它目前的功能吧:

  • a.支持多任务下载,具体同时下载几个,最大添加几个任务都是自己可配的
  • b.支持多界面监听某个任务,比如像应用市场,多个界面都可以同步下载数据
  • c.支持断点下载,我只是实现下载的逻辑,具体怎么断点保存需要开发人员自己做

2.项目引入

在项目的 build.gradle 中加入
repositories{
...
maven {url 'https://jitpack.io' }

主模块 build.gradle 中引入
compile 'com.github.Dpuntu:android-downloader:v1.0.0'

3.使用下载器

下载器提供了三个比较重要的类DownloadManager、Downloader和Observer
其实很简单,我说下怎么用,大家就明白了
比如说,我现在要下载一个视频叫【韩国美女.mov】,下载的地址是【http://www.dpuntu.com/movie/hgmv.mov】

1.初始化下载器,一般在Application中初始化

    DownloadManager.initDownloader(this);

2.如果你的网络请求需要额外的配置,比如说请求头需要额外添加信息,你可以初始化OkHttpClient

    OkHttpClient client = new OkHttpClient.Builder()
                                            .addInterceptor(你的请求拦截器)
                                            .build();

当然如果你没有额外的要求,也可以不配置,这一步省略即可

3.配置Downloader

    Downloader mDownloader =new Downloader.Builder()
                        .client(client) //这就是第二部配置的OkHttpClient,你也可以不配置,下载器内部有个默认的OkHttpClient
                        .fileName("韩国美女.mov")  // 这是你下载的文件需要存储的磁盘上的名字,必须设置项
                        .filePath("xxx") // 设置文件存储的路径,可省略,默认为根目录下 Android/data/你的app applicationId/files
                        .loadedSize(mLoadedSize)  // 这是下砸文件已经下载的大小,可以不设置,默认是0,如果是断点的话就必须设置,否则无法断点
                        .totalSize(mTotalSize) // 这是下载文件的文件总大小,可以不设置,默认是0,如果是断点的话就必须设置,否则无法断点
                        .taskId(taskId) //下载文件的任务对应的id,用于标识单一任务,不可重复,必须设置
                        .url(“http://www.dpuntu.com/movie/hgmv.mov”) //下载文件的下载地址,必须配置
                        .build();

4.将第三步设置好的Downloader添加到任务列表中

    DownloadManager.addDownloader(mDownloader);

5.开始下载任务

    DownloadManager.start(taskId); // 这个taskId就是设置Downloader时候的taskId

6.如果你关心任务下载情况的话[一般都关心吧...],可设置监听器

    DownloadManager.subjectTask(taskId,mStartObserver);// 这个taskId就是设置Downloader时候的taskId ,  mStartObserver是对>应taskId的某一个Observer,下文具体分析Observer

从上文来看,建立任务到开始下载是一条链式结构,大概是4-6个步骤就完成了,而且DownloadManager、Downloader和Observer这三个都有使用到,DownloadManager、Downloader都好理解,大家应该都看得懂,下面讲解下Observer这个接口

4.Observer介绍

其实Observer就是观察者模式,也很简单,只是用起来要自己new一个而已,稍显复杂,但是当你在多界面监听莫一个任务的时候,你会发现Observer的好处,Observer一共有6个方法,下面逐一介绍[注意了 Observer的回掉均是在 子线程 中]

  • void onCreate (String taskId) 这个方法是在前面说到的第四步addDownloader的时候调用,但是请注意下,如果该任务是第一次创建,则不会触发该方法,所以如果有时候该方法没被调用,不必惊讶

  • void onReady (String taskId) 这个方法是当你执行上面的第五步的start时候调用

  • void onLoading (String taskId, String speed, long totalSize, long loadedSize) 正在下载过程中回掉
    说下参数
    taskId (下载任务的id,就是建立Downloader的时候配置的)
    speed (下载速度)
    totalSize (下载文件的总大小)
    loadedSize (下载文件已经下载的大小)
    返回totalSize和loadedSize是为了方便开发者做数据存储,方便以后断点,也可以用来配置下载的百分比

  • void onPause(String taskId, long totalSize, long loadedSize) 暂停时调用
    参数含义同onLoading方法

  • void onFinish(String taskId) 下载任务完成时调用

  • void onError(String taskId, String error, long totalSize, long loadedSize) 任务下载出现错误时候调用
    参数含义同onLoading
    参数 error 是错误的提示信息

5.DownloadManager方法说明

  • void initDownloader(Context context) // 初始化下载器
  • int getCorePoolSize() // 获取下载器最大同时下载的任务数量
  • void setCorePoolSize(int corePoolSize) // 设置下载器最大同时下载的任务数量
  • int getMaxPoolSize() // 获取下载器最多添加的任务数量
  • void setMaxPoolSize(int maxPoolSize) // 设置下载器最多添加的任务数量
  • long getKeepAliveTime() // 空闲任务的存活时间,单位毫秒
  • void setKeepAliveTime(int keepAliveTime)// 设置空闲任务的存活时间,单位毫秒
  • void addDownloader(T t) // 添加任务到任务队列 T只能是Downloader或者List类型
  • void remove(T t) // 移除任务队列中的某个任务或一群任务 ,T可以是任务的id, 也可以是任务id的List集合
  • void removeAll()// 移除任务队列中所有的任务
  • void pause(T t)// 暂停任务队列中的某个任务或一群任务,T可以是任务的id, 也可以是任务id的List集合
  • void pauseAll()// 暂停任务队列中所有的任务
  • void start(T t)// 开始任务队列中的某个任务或一群任务,T可以是任务的id, 也可以是任务id的List集合
  • void startAll()//开始任务队列中所有的任务
  • void subjectTask(String taskId,Observer observer) // 给某个任务绑定一个观察者
  • void removeTaskObserver(String taskId,Observer observer)// 移除某个任务的某个观察者
  • Downloader getDownloader(String taskId) // 获得某个任务的下载信息

最后非常重要的

不要忘记加网络以及读写权限

简书地址

实例

About

一个简单的Android网络下载器,支持多任务下载、多界面管理、断点等常用操作

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages