Android 文件下载引擎，稳定、高效、简单易用：FileDownloader

Android 文件下载引擎，稳定、高效、简单易用

特点

• 简单易用
• 高并发
• 独立进程
• 自动断点续传

需要注意

• 为了绝大多数使用性能考虑，目前下载引擎目前受限于int可表示的范围，而我们的回调total与so far以byte为单位回调，因此最大只能表示到2^31-1=2_147_483_647 = 1.99GB(ps: 如果有更大的文件下载需求，提issue，我们会进行一些巧妙的优化，利用负值区间？根据大小走特殊通道传输?)
• 暂停: paused, 恢复: 直接调用start，默认就是断点续传

使用okHttp并使用其中的一些默认属性

• retryOnConnectionFailure: Unreachable IP addresses/Stale pooled connections/Unreachable proxy servers
• connection/read/write time out 10s

I. 效果

II. 使用

在项目中引用:

compile 'com.liulishuo.filedownloader:library:0.1.2'

全局初始化在Application.onCreate中

public XXApplication extends Application{        ...      @Override      public void onCreate() {          // 不耗时，做一些简单初始化准备工作，不会启动下载进程          FileDownloader.init(this);      }        ...  }

启动单任务下载

FileDownloader.getImpl().create(url)          .setPath(path)          .setListener(new FileDownloadListener() {              @Override              protected void pending(BaseDownloadTask task, int soFarBytes, int totalBytes) {              }                @Override              protected void connected(BaseDownloadTask task, String etag, boolean isContinue, int soFarBytes, int totalBytes) {              }                @Override              protected void progress(BaseDownloadTask task, int soFarBytes, int totalBytes) {              }                @Override              protected void blockComplete(BaseDownloadTask task) {              }                @Override              protected void retry(final BaseDownloadTask task, final Throwable ex, final int retryingTimes, final int soFarBytes) {              }                @Override              protected void completed(BaseDownloadTask task) {              }                @Override              protected void paused(BaseDownloadTask task, int soFarBytes, int totalBytes) {              }                @Override              protected void error(BaseDownloadTask task, Throwable e) {              }                @Override              protected void warn(BaseDownloadTask task) {              }          }).start();

启动多任务下载

final FileDownloadListener queueTarget = new FileDownloadListener() {              @Override              protected void pending(BaseDownloadTask task, int soFarBytes, int totalBytes) {              }                @Override              protected void connected(BaseDownloadTask task, String etag, boolean isContinue, int soFarBytes, int totalBytes) {              }                @Override              protected void progress(BaseDownloadTask task, int soFarBytes, int totalBytes) {              }                @Override              protected void blockComplete(BaseDownloadTask task) {              }                @Override              protected void retry(final BaseDownloadTask task, final Throwable ex, final int retryingTimes, final int soFarBytes) {              }                @Override              protected void completed(BaseDownloadTask task) {              }                @Override              protected void paused(BaseDownloadTask task, int soFarBytes, int totalBytes) {              }                @Override              protected void error(BaseDownloadTask task, Throwable e) {              }                @Override              protected void warn(BaseDownloadTask task) {              }          };    for (String url : URLS) {      FileDownloader.getImpl().create(url)              .setListener(queueTarget)              .ready();  }    if(serial){      // 串行执行该队列      FileDownloader.getImpl().start(queueTarget, true);  }    if(parallel){      // 并行执行该队列      FileDownloader.getImpl().start(queueTarget, false);  }

全局接口说明(FileDownloader.)

所有的暂停，就是停止，会释放所有资源并且停到所有相关线程，下次启动的时候默认会断点续传

Task接口说明

监听器(FileDownloadListener)说明

一般的下载回调流程:

pending -> connected -> (progress <->progress) -> [retry] -> blockComplete -> completed

可能会遇到以下回调而直接终止整个下载过程:

paused / completed / error / warn

如果检测存在已经下载完成的文件(可以通过isReusedOldFile进行决策是否是该情况)(也可以通过setForceReDownload(true)来避免该情况):

blockComplete -> completed

方法说明

官方网站：http://www.open-open.com/lib/view/home/1451397722511