Change log

October 11, 2019 · View on GitHub

Change log in english

Version 1.7.7

  • 修复: FileDownloadThreadPool 可能会抛出 ArrayIndexOutOfBoundsException 和 ClassCastException。 closes #1258
  • 修复: 从 1.6.x 升级到 1.7.x 后恢复之前的下载任务时出现 416 错误。
  • 修复: Demo 中下载通知示例无法显示通知。closes #1224
  • 修复: blockComplete 可能会在主线程中回调。closes #1069
  • 修复: NoDatabaseImpl 中 SparseArray 非线程安全问题。closes #1225

Version 1.7.6

2019-02-20

修复

  • 修复: 在Android O以及更高版本手机上，在所有任务结束后自动将前台服务关闭. closes #1096
  • 修复: 修复'Context.startForegroundService() did not then call Service.startForeground()'的问题. closes #1104
  • 修复: 确保在调用停止任务后，运行中的通知被关闭. closes #1136
  • 修复: 修复在重试时小概率NPE. closes #1100

Version 1.7.5

2018-08-03

修复

  • 修复: 修复在Android O的系统上，当应用不在前台，并且不在白名单的时候，由于下载服务无法通过JobScheduler来执行下载事务，只能通过startService，引起 "Not allowed to start service Intent..." 的问题。 closes #1078

Enhance

  • 提升实用性: 支持Content-Disposition中的非UTF-8编码。 closes #1057
  • 提高实用性: 处理了阿里云服务错误反馈416的情况`。 closes #1050

Version 1.7.4

2018-05-19

修复

  • 修复: 修复在Android 8或更高版本上，当应用在后台时，并且此时正在下载，但是下载服务的链接断开，此时尝试重新绑定的时候发生'IllegalStateException'的问题。closes #1017
  • 修复: 修复响应头带回来的文件名可能存在安全隐患的问题. closes #1028

Version 1.7.3

2018-04-20

修复

修复: 修复由于在下载结束时fd没有被主动释放，导致当有大量的任务被不断的发起执行时有可能引发的OOM问题。

Version 1.7.2

2018-03-14

修复

  • 修复: 将原本所需要下载的文件大小为0的时候，回调错误，修改为直接回调完成。closes #789
  • 修复: 修复当存在另外一个正在下载的相同临时文件路径的任务时，数据库中存在数据未被删除的问题。closes #953
  • 修复: 修复在重试后重试之前下载的进度丢失的问题。closes #949
  • 修复: 修复当试探连接没有提供Content-Range字段，但是提供Content-Length字段时，计算出的总长度始终是1的问题。

性能与提高

  • 提高实用性: 当在响应头中不存在Content-Length字段时，使用隐藏在Content-Range中的内容大小数据。 closes #967

Version 1.7.1

2018-02-05

修复

  • 修复: 修复当后端不支持HEAD方法的时候，返回405响应状态导致下载失败的问题。 close #942

Version 1.7.0

2018-02-01

修复

  • 修复: 通过同步处理暂停操作与状态的更新来修复状态不是一个正确向前的流的问题。 close #889
  • 修复: 修复在pending状态回调时带回来已经被弃用的sofar-bytes。 close #884
  • 修复: 修复当filename没有用"包裹时，无法通过content-dispostion获取文件名的问题。 close #908
  • 修复: 修正setCallbackProgressTimes设置的次数不能正常生效的问题。 close #901
  • 修复: 修复由于试探连接采用0-infinite的Range导致下载了无用内容到tcp-window的问题。close #933
  • 修复: 在连接ending的时候再次主动关闭输入流，防止输入流泄漏特别是对于试探连接来说。

性能与提高

  • 提高实用性: 当临时文件重命名为目标文件成功时，不再做一次移除临时文件的操作，防止一些文件系统报错的问题。close #912
  • 提高实用性: 当确定本地提供的Range是正确的，但是后端却返回416时，将完全弃用Range请求头。close #921
  • 提高性能: 为试探连接使用HEAD的请求替代GET方法，提高试探通信效率。 ref #933

其他

如果你正在使用filedownloader-okhttp3-connection，请将其更新到1.1.0版本来适配1.7.0版本。

Version 1.6.9

2017-12-16

修复

  • 修复(serial-queue): 修复在FileDownloadSerialQueue遇到的死锁。 closes #858
  • 修复: 不再在非单元测试环境使用j-unit，避免在一些小米手机上发生no-static-method-found的问题。 closes #867
  • 修复: 修复每次重试减少两次重试机会的问题。 closes #838
  • 修复: 修复在pending的时候暂停任务，而后获取到该任务都是pending的状态的问题。 closes #855

性能与提高

  • 提高实用性: 开放SqliteDatabaseImpl、RemitDatabase、NoDatabaseImpl，便于上层覆盖他们。
  • 提高实用性: 支持从更高的版本降级到该版本。
  • 提高实用性: 当上层没有主动添加User-Agent的时候，内部添加默认的User-Agent。 closes #848
  • 提高性能: 修改所有的线程池中线程的存活时间(从5s修改为15s)，避免在高频下载中，各池子频繁的释放与创建线程
  • 提高性能: 使用RemitDatabase作为默认的数据库，在很多小任务很快的结束下载(2s内)，其数据库操作将会变得十分冗余，而这部分的数据库操作将被取消

RemitDatabase

FileDownloader中大多数数据库长尾问题，是由于有很多很小的任务同时执行：

  • 由于很小的任务每次启动、等待、连接、下载进度、结束都会促发入库
  • 一旦任务很小网速很快的时候，一个小任务实际下载耗时可能在1-2s完成
  • 因此整个引擎不得不为该1-2s完成的任务完成一连串的数据库入库、更新到从数据库删除的操作
  • 也就是说单个类似的任务在1-2s内促发了至少5次数据库操作，期间包含入库与最后的删除
  • 一个任务还好，当这样的任务数上升到几百个的层面，这样高频持续的数据库操作，就很容易暴露各种数据库问题（包含文件系统问题）
  • 而现有体系在上层推任务大量任务到下载服务的时候， 会高频持续的3个并行对这些任务做入库处理，在这个点上数据库问题也容易发生（包含文件系统问题）

而相比之下写入数据库是为了断点续传，这个短期的频繁数据库操作，实质的作用甚微，早期的提供外接接口来控制下载进度间的入库频率显然无法覆盖该问题。

因此，还是为FileDownloader推出新的RemitDatabase用于解决该问题，除去期间的多线程安全问题的处理，核心思想如下:

  • 如果某一个任务的整体数据更新与结束在2s(该值可定制)内，则不再有数据库操作，全程只存内存
  • 如果某一个任务的数据更新与结束操过2s，则分为两部分，2s前只存内存，2s开始同时存内存与数据库
  • 如果某一个任务最终的结束是暂停或错误，则在最后的状态更新中，同时存内存与数据库

Version 1.6.8

2017-10-13

修复

  • 修复: 修复断点续传失败, 由于Network线程中的isAlive不可靠导致的问题。 this closes #793
  • 修复: 修复断点续传失败，由于多个线程频繁的更新status并且DownloadStatusCallback的sendMessage无法保证有序性，导致下一次启动时最终状态是process无法断点续传(具体原因参看这里)。 this refs #793, #764, #721, #769, #763, #761, #716
  • 修复: 不再由于任务已经结束依然存在需要派发的信息而让用户程序奔溃，因为这个对用户并不会照成影响。 this closes #562
  • 修复: 修复当用户频繁调用pause时，有可能出现it can't take a snapshot for the task xxx错误的问题。
  • 修复: 修复由于内部存储的任务对象大小存在问题，导致这样的对象任务每一次启动都必然会416的问题。

Version 1.6.7

2017-10-12

修复

  • 修复: 避免error与pause的状态被运行中的状态覆盖导致下次断点续传失败。 closes #769, closes #764, closes #761, closes #763, closes #721, closes #716
  • 修复: 感谢 @hongbiangoal 对问题的定位，修复了当某一个分块的断点进度大于1.99G时，请求的范围出现负数的情况。 closes #791

Version 1.6.6

2017-09-29

修复

  • 修复(文件完整性): 只有在确保缓存已经完全固化到本地文件了才更新数据库的进度，防止在该次暂停时固化失败，然后数据库更新了进度，导致下一次断点续传的时候(使用预分配策略的情况下)，本地已经下载的文件的进度与数据库记录的进度实际不一致，导致最后下载完成了文件不完整的问题。 Closes #745
  • 修复(清理): 修复调用FileDownloader#clearAllTaskData并没有清理连接表的问题。 Closes #754

性能与提高

  • 提高性能: 使用BufferedOutputStream来优化默认输出流，现在虚拟机内的缓存大小为8192字节。

Version 1.6.5

2017-09-11

修复

  • 修复(crash): 修复因为使用%d格式化AtomicLong导致IllegalFormatConversionException的问题。 Closes #743

Version 1.6.4

2017-08-21

新接口

  • 新增 NoDatabaseImpl: 为了有些用户需要一个没有数据库的FileDownloader的用户。 Refs #727

性能与提高

  • 提高性能: 使用AtomicLong代替锁的方式，使得下载进度递增性能更好。

修复

  • 修复(分块下载): 修复在断点续传时之前已经下载了分块下载的最后一块，可是在继续下载时重新请求了最后一块给了错误的Range导致416的错误。 Closes #737
  • 修复(npe): 修复极小概率当事件监听已经被其他线程移除时还在分发事件导致NPE的问题。 Closes #723

Version 1.6.3

2017-07-29

修复

  • 修复: 修复当正在处理回调结束任务的事务时，调用了pause极小概率出现NPE的问题。 Closes #680
  • 修复: 修复当暂停或恢复FileDownloaderSerialQueue的时候，其已经完成了该操作，出现MissingFormatArgumentException的问题。 Closes #699

Version 1.6.2

2017-07-16

修复

  • 修复: 修复当FileDownloader下载文件有一个分块从大于1.99G的地方开始下载，就会发生'offset < 0'异常的问题。 Closes #669

Version 1.6.1

2017-07-13

性能与提高

  • 提高实用性: 当返回的content-length不等于通过Range计算出来的content-length时直接抛回GiveUpException而不继续下载。 Closes #636

修复

  • 修复: 修复下载出现错误或暂停下载时强制多sync了一次的问题。
  • 修复: 修复当从断点中恢复chuncked任务后下载文件被损坏的问题。

Version 1.6.0

2017-07-07

修复

  • 修复(no-response): 修复当多线程分块下载同时完成时，有可能会由于线程安全问题导致completed无法得到回调的问题，具体情况参看这里。 Closes #631

Version 1.5.9

2017-07-04

修复

  • 修复(duplicate-permission): 修复在Android 5.0或更高版本系统的手机中已经有一个应用引用了1.5.7或更新版本的FileDownloader后，再安装引用1.5.7或更新版本的FileDownloader的应用会报INSTALL_FAILED_DUPLICATE_PERMISSION的问题，这个问题是因为在1.5.7版本中我们申明了一个接收结束广播的权限导致，现在我们移除了这个权限申明来修复这个问题。Closes #641

Version 1.5.8

2017-06-28

修复

  • 修复(无响应): 修复非常快速的对相同任务启动、暂停来回切换会使得任务到后面没有响应的问题。Closes #625

Version 1.5.7

2017-06-25

新接口

  • 支持在filedownloader.properties中配置broadcast.completed: 决定是否需要在任务下载完成后发送一个完成的广播。 Closes #605
  • 支持接收201的http返回状态码。 Closes #545
  • 为FileDownloadSerialQueue支持暂停与继续功能. Closes #547
  • 在FileDownloader内部处理了各类重定向的情况(300、301、302、303、307、308)。 Closes #611
  • 弃用了FileDownloader#init取而代之的是FileDownloader#setup，现在如果你不需要定制组件，就只需要在使用FileDownloader之前的任意使用调用这个方法就行。 Closes #500
  • 如果你使用broadcast.completed并且接收任务完成的广播,你需要在AndroidManifest中注册Action为filedownloader.intent.action.completed的广播并且使用FileDownloadBroadcastHandler来处理接收到的Intent。
  • 现在, 不再使用FileDownloader#init, 取而代之的，如果你需要注册你的定制组件，你需要在Application#onCreate中调用FileDownloader.setupOnApplicationOnCreate(application):InitCustomMaker, 否则你只需要在使用FileDownloader之前的任意时候调用FileDownloader.setup(Context)即可。

修复

  • 修复: 修复来FileDownloadQueueSet无法处理使wifi-required失效的操作。 感谢 @qtstc
  • 修复(output-stream): 修复当提供的output-stream不支持seek时，FileDownloader无法使用的问题。 Closes #622

性能与提高

  • 提高实用性: 覆盖使用不同的Url来复用下载进度的情况（结合idGenerator一起使用)。 Closes #617

Version 1.5.6

2017-06-18

修复

  • 修复(crash): 修复当调用findRunningTaskIdBySameTempPath的同时请求了暂停可能导致NPE奔溃的问题。 Closes #613
  • 修复(crash): 修复返回状态是206并且它的ETAG发生变化时导致IllegalArgumentException错误奔溃的问题。 Closes #612
  • 修复(crash): 修复当用户请求下载需要Wifi并当前不是Wifi环境时，出现FileDownloadNetworkPolicyException未处理导致奔溃的问题。 感谢 @qtstc
  • 修复(crash): 修复当用户直接从v1.4.3升级到v1.5.2并且在一些其他综合因素下（具体可以参见 #610 ) 初始化数据库时出现IllegalStateException错误奔溃的问题。Closes #610
  • 修复(crash): 修复当回调流已经结束当时与此同时刚好出现错误或下载完成或暂停，小概率会出现IllegalStateException奔溃的问题。
  • 修复(no-response): 修复在接收到connected回调之后，多线程下载建立连接，此时在检验连接与数据获取连接期间服务端数据发生错误或变更导致启动下载后没有响应的问题。

性能与提高

  • 提高实用性: 当父级目录创建失败时直接回调error。 Closes #542
  • 提高实用性: 处理了返回状态是416的情况。 Refs #612

Version 1.5.5

2017-06-12

修复

  • 修复(max-network-thread-count): 修复当任务都是多线程下载时，download.max-network-thread-count参数没起作用，并同时下载任务无上限的问题。 Closes #607

Version 1.5.4

2017-06-11

新接口

  • 通过IdGenerator支持了定制下载任务id生成器。 Closes #224

性能与提高

  • 提高实用性: 将FileDownloadModel的维护从FileDownloadDatabase中解藕，让FileDownloadDatabase只关心数据库相关操作。
  • 提高实用性: 将数据库初始化的维护工作从默认的数据库实现中解藕出来，让定制的数据库也能够被采用相同机制维护到。

Version 1.5.3

2017-06-08

修复

  • 修复(crash): 修复在计算平均速度的过程中connected与completed几乎同时回调时发生divide by zero异常的问题。 Refs #601
  • 修复(crash): 修复触发暂停的同时，FetchDataTask已经被创建并请求执行，但是还没有来得及被执行，导致NPE奔溃的问题。 Closes #601

Version 1.5.2

2017-06-07

修复

  • 修复(crash): 修复当任务需要回调error或者被暂停时，刚好该任务的某个或几个链接完成下载，此时遇到NPE或者是ConcurrentModificationException的异常。Closes #598
  • 修复(crash): 修复当任务被暂停时，任务从开始到被暂停还没来得及同步一次数据到文件系统或者数据库，此时遇到NPE的异常。Refs #598
  • 修复(crash): 修复当采用多链接下载一个任务时，非首次建链失败或者是创建FetchDataTast失败，此时遇到NPE的异常。Refs #598
  • 修复(speed-calculate): 修复忽略整个下载进度回调，并且只使用FinishListener时，此时下载速度始终是0的问题。
  • 修复(finish-listener): 修复对于之前已经下载好的任务，并且只监听来FinishListener，此时FinishListener的over方法不会被回调到的问题。

性能与提高

  • 提升性能: 开启了默认数据库的WAL，使得读与写可并行操作来提高性能，因为我们的绝大多数场景读写是会在不同线程中同时执行的，开启这个以后会导致内存的增加，但是在大多数情况下极大的提高了数据库的写入速度，并且更加稳定（更少的使用fsync())。

Version 1.5.1

2017-06-05

修复

  • 修复(crash): 修复在FileDownloader.init中，当没有提供InitCustomMaker时出现的NPE奔溃。 Closes #592
  • 修复(callback): 修复当之前有多个链接服务于该任务并且正在从端点恢复时，在pending中没有带回其正确的sofarBytes的问题。
  • 修复(speed-monitor): 矫正IDownloadSpeed.Monitor在断点续传下总平均速度不准确的问题。

性能与提高

  • 提高稳定性: 当触发暂停时，主动同步FetchTask中的进度确保其进度得到固化到文件系统。
  • 提高稳定性: 当在FileDownloader.init中提供的context为空时，抛IllegalArgumentException以更早的暴露问题。

Version 1.5.0

2017-06-05

新接口

  • 支持对单个任务多连接(多线程)下载。 Closes #102
  • 支持通过ConnectionCountAdapter定制对每个任务使用连接(线程)数据的定制(可以通过FileDownloader#init设置进去)

性能与提高

  • 提高性能: 重构整个下载的逻辑与原始回调逻辑，并删除了1000行左右的FileDownloadRunnable。

对于每个任务默认的连接(线程)数目策略，你可以通过ConnectionCountAdapter来定制自己的策略:

  • 1个连接(线程): 文件大小 [0, 1MB)
  • 2个连接(线程): 文件大小 [1MB, 5MB)
  • 3个连接(线程): 文件大小 [5MB, 50MB)
  • 4个连接(线程): 文件大小 [50MB, 100MB)
  • 5个连接(线程): 文件大小 [100MB, -)

Version 1.4.3

2017-05-07

修复

  • 修复: 移除重复的被弃用的方法: FileDownloader#init(Application), 因为Application是 Context的实现。

Version 1.4.2

2017-03-15

修复

  • 修复(Same File Path): 避免多个问题同时对相同的文件写入，一旦存在另外一个正在运行中的任务与当前任务的文件存储路径一致，当前任务将会收到PathConflictException来拒绝启动。 Closes #471

New Interfaces

  • 新增 FileDownloadSerialQueue#getWaitingTaskCount: 获取动态串行队列中正在等待启动的任务个数。Refs #345

Version 1.4.1

2017-02-03

修复

  • 修复(高并发): 修复由于Messenger在已经收到结束的信息将Task对象赋值为Null以后依然收到其他消息，导致NPE的问题。 Closes #462
  • 修复(FileDownloadHttpException): 修复由于在建立连接后无法取到请求头以至于遇到FileDownloadHttpException时发生IllegalStateException的问题。 Closes #458

Version 1.4.0

2017-01-11

性能与提高

  • 提高性能: 优化FileDownloader#init中的逻辑, 使其更加的轻量(仅仅做了赋值context与maker的操作)

修复

  • 修复(pause): 修复高并发情况下，当在启动一个任务的时候，很短的时间间隔内去暂停一个任务，可能无法暂停下来任务的问题。 Closes #402
  • 修复(init FileDownloader): 修复在很低概率下在FileDownloadService所在进程初始化FileDownloader时出现Crash的问题。 Closes #420
  • 修复(FileDownloadHttpException): 修复在遇到FileDownloadHttpException类型Crash时，由于字符串的formatter无法匹配导致Crash的问题 Closes #438

Version 1.3.9

2016-12-18

核心:

  • 这个版本开始，你可以定制自己的网络连接组件: FileDownloadConnection，默认情况下我们使用这个。
  • 这个版本开始，我们不再默认依赖okhttp，你可以根据自己的需求进行定制。(如果你依然想要使用okhttp，可以考虑集成下这个仓库)

如果你依然需要配置timeout、proxy，请不用担心，我已经对默认的网络连接组件实现了这几个接口: DemoApplication，如果有需要可以看看。

新接口

  • 新增 FileDownloadQueueSet#reuseAndStart: 添加 '复用并启动'接口，主要用于在启动队列任务之前，先对任务队列中的所有任务进行尽可能的复用。 Ref #383
  • 新增 FileDownloadConnection: 支持定制化网络连接组件，不再默认依赖okhttp。 Closes #158

Version 1.3.0

2016-10-31

新接口

  • 新增 FileDownloadSerialQueue: 便于动态管理串行执行的队列。 Closes #345.
  • 移除 FileDownloadListener类中的callback方法, 并且新增FileDownloadListener#isInvalid方法，用于告知FileDownloader该监听器是否已经无效，不再接收任何消息。
  • 新增 FileDownloader#clearAllTaskData: 清空filedownloader数据库中的所有数据。 Closes #361.

性能与提高

  • 提高实用性(FileDownloadListener#blackCompleted): 确保blockCompleted回调可以接收任何的Exception。 Closes #369.
  • 提高实用性(service-not-connected): 在service-not-connected-helper中输出提示与原因, 这样当你调用有些需要确保下载服务已经连接上的方式，但下载服务没有连接上时，不但在Logcat中可以收到原因，还能收到提示。

修复

  • 修复(reuse): 修复调用BaseDownloadTask#pause之后短时间内调用BaseDownloadTask#reuse方法，可能会抛出异常的问题。 Closes #329.

Version 1.2.2

2016-10-15

修复

  • 修复(fatal-crash): 修复当任务没有FileDownloadListener时，也不能收到该任务FileDownloadMonitor.IMonitor#onTaskOver的回调的问题。 Closes #348.

Version 1.2.1

2016-10-09

修复

  • 修复(fatal-crash): 修复当任务没有FileDownloadListener时，也不能收到该任务FileDownloadMonitor.IMonitor#onTaskOver的回调的问题。 Closes #348. 十分的抱歉这个问题在1.2.1版本中依然存在，最终在1.2.2中验证修复。

Version 1.2.0

2016-10-04

新接口

  • 新增 FileDownloader#insureServiceBind(): 便于阻塞当前线程，并且启动下载服务，服务启动之后再执行需要服务的请求。 Refs #324.
  • 新增 FileDownloader#insureServiceBindAsync(): 便于启动下载服务，并且在服务启动之后，执行需要下载服务的请求。 Refs #324.
  • 新增 FileDownloader#bindService(runnable:Runnable): 便于启动下载服务，并且在服务启动之后，执行 runnable。 Refs #324.
  • 新增 FileDownloader#init(Context,InitCustomMaker): 便于初始化下载引擎的时候可以传入更多的定制化组件。 Refs #157.

Enhancement

  • 提高实用性(InitCustomMaker#database): 支持定制化数据库组件(FileDownloadDatabase)，并且实现默认的数据库组件： DefaultDatabaseImpl。 Closes #157.
  • 提高实用性(InitCustomMaker#outputStreamCreator): 支持定制化输出流组件(FileDownloadOutputStream)，并且实现默认的输出流组件： FileDownloadRandomAccessFile，与一些可替代的组件： FileDownloadBufferedOutputStream、FileDownloadOkio。Closes #301.

Version 1.1.5

2016-09-29

新接口

  • 支持在filedownloader.properties中配置file.non-pre-allocation: 是否不需要在开始下载的时候，预申请整个文件的大小(content-length), 默认值是false。Closes #313 .

修复

  • 修复(fatal-crash): 修复由于ThreadPoolExecutor#getActiveCount()是一个大概的值，导致在其反回的不是正确值时，thread-pool库中存在StackOverflowErrorCrash的问题。Closes #321 .
  • 修复(minor-crash): 修复在一些小概率情况下出现Crash Message是'No reused downloaded file in this message'的IllegalStateException的问题。 Closes #316 .
  • 修复(minor-crash): 修复当在下载服务还没有连接上时，同时有几个串行队列任务需要执行，在一些小概率的情况下，一些相同的任务会被启动两次导致crash的问题。 Refs #282 .

其他

  • 依赖: 取消对thread-pool库的依赖。 Refs #321 .
  • MinSDKVersion: 升级minSdkVersion : 8->9。 Refs #321 .

Version 1.1.0

2016-09-13

新接口

  • 新增 BaseDownloadTask#setWifiRequired: 设置任务是否只允许在Wifi网络环境下进行下载。 默认值 false。 Closes #281 .

性能与提高

  • 提高性能: 替换所有的线程池为exceed-wait-pool(更多详情参见: FileDownloadExecutors) 并且所有线程池中的线程将会在闲置五秒后自动结束。 Refs #303 .
  • 提高实用性: 当有异常从FileDownloadListener#blockComplete抛出时，将会被catch并且回调到FileDownloadListener#error中而非回调FileDownloadListener#completed。 Closes #305 .

修复

  • 修复(lost-connect): 避免等待服务连接的列表中在一些小概率情况下存在重复任务的问题。

Version 1.0.2

2016-09-06

修复

  • 修复: 服务还没有连接上时，启动的'队列任务'被放在等待队列，当服务连接上以后，FileDownloader尝试重启这些等待队列中的任务，但是抛了IllegalStateException的Bug。 Closes #307 .

Version 1.0.1

2016-09-05

新接口

如果你之前有使用现在已经被申明弃用的方法BaseDownloadTask#ready(), 只需要简单的将它迁移为:BaseDownloadTask#asInQueueTask():InQueueTask并且调用InQueueTask#enqueue()。

  • 添加BaseDownloadTask#asInQueueTask():InQueueTask并申明弃用BaseDownloadTask#ready(): 申明当前任务是队列任务，并且可以通过InQueueTask#enqueue()将当前任务放入全局队列以便于启动队列任务的时候，能被队列收编执行。InQueueTask#enqueue()中的操作与BaseDownloadTask#ready()相同, 我们通过这个方式封装ready()是为了让你更加清晰的了解: 只有当前任务是队列任务，才需要调用该方法；如果当前任务不是队列任务，而却调用了这个方法，你将会收到一个异常(具体异常的原因可以移步到DownloadTask#start报的异常信息进行了解)。

修复

  • 修复: 当有使用相同listener对象的多个孤立任务与队列任务在不同的线程中同时被启动时(后)，有可能会遇到IllegalStateException异常的问题。 Closes #282 .

Version 1.0.0

2016-08-21

新接口

  • 添加 BaseDownloadTask#cancel: 这个方法是为了说明为什么pause的操作也可以达到cancel的作用。

性能与提高

  • 提高性能: 持有isDownloaderProcess的结果，防止多次判断。
  • 提高实用性: 重构代码的可见层。Closes #283
  • 提高实用性: 完善Java Doc。Closes #284
  • 提高实用性: 提供Java Doc 站点: http://fd.dreamtobe.cn 。Closes #284

Version 0.3.5

2016-08-16

性能与提高

  • 提高实用性: 为FileDownloader中的所有线程添加线程名。
  • 提高性能: 调整block-completed-thread-pool中的核心线程数: 5->2，减少资源的浪费。

修复

  • 修复(SQLiteFullException): 覆盖了在整个下载过程中可能遇到SQLiteFullException的错误，就捕获相关错误并回调回 FileDownloadListener#error 。 Closes #243
  • 修复(提供目录的情况): 修复若是提供的是文件夹，并且对应的任务已经下载完成，再次启动的时候，在直接回调FileDownloadListener#completed时，获取的targetFilePath可能为null的问题。 Closes #237

Version 0.3.4

2016-07-31

新接口

  • 添加 FileDownloader#clear: 用于强制根据任务ID清理其在filedownloader中的数据。Closes #218

性能与提高

  • 提高实用性: 为 FileDownloader#start(FileDownloader, boolean) 添加返回值: 是否成功启动任务下载。Closes #215
  • 提高实用性: FileDownloader#pause 暂停任务时，不再仅仅是暂停一个任务，而是暂停掉所有ID为指定ID的运行中的任务。

修复

  • 修复(初始化-CRASH): 修复初始化FileDownloader时，从ActivityManager获取到运行中进程信息为空时发生CRASH。Closes #210
  • 修复(小概率-CRASH): 修复当FileDownloadService已经onDestroy后，还接收到snapshot-message时发生CRASH的情况。 Closes #213
  • 修复(消息流准确性): 在真正启动下载时删除目标文件，以此保证当有相同任务正在下载时，获取下载状态，不会获取到已经下载完成的错误的状态。Closes #220
  • 修复(启动线性下载): 收集未绑定的任务进行启动而非只是根据FileDownloadListener去收集任务，修复无法启动两个相同FileDownloadListener的队列。Closes #233
  • 修复(清理Messenger): 在回调 结束的消息 的回调之前进行清理任务的Messenger，而非在回调之后清理，以此确保在回调方法中可以调用BaseDownloadTask#reuse。Closes #229

其他

  • 所依赖的okhttp从3.3.1升到3.4.1。

Version 0.3.3

2016-07-10

新接口

  • 添加 FileDownloadUtils#getTempPath: 获取用于存储还未下载完成文件的临时存储路径: filename.temp。 Refs #172.
  • 添加 FileDownloadUtils#isFilenameConverted(context:Context): 判断是否所有数据库中下载中的任务的文件名都已经从filename(在旧架构中)转为filename.temp。
  • 添加 FileDownloader#getStatusIgnoreCompleted(id:int): 获取不包含已完成状态的下载状态(如果任务已经下载完成，将收到INVALID)。
  • 添加 FileDownloader#getStatus(id:int, path:String): 获取下载状态。
  • 添加 FileDownloader#getStatus(url:String, path:String): 获取下载状态
  • 添加 FileDownloadUtils#generateId(url:String, path:String, pathAsDirectory:boolean): 生成可以被FileDownloader识别的Download Id。
  • 添加 BaseDownloadTask#setPath(path:String, pathAsDirectory:boolean): 如果pathAsDirectory是true,path就是存储下载文件的文件目录(而不是路径)，此时默认情况下文件名filename将会默认从response#header中的contentDisposition中获得。
  • 添加 BaseDownloadTask#isPathAsDirectory: 判断BaseDownloadTask#getPath()返回的路径是文件存储目录(directory)，还是文件存储路径(directory/filename)。
  • 添加 BaseDownloadTask#getTargetFilePath: 获取目标文件的存储路径。
  • 添加 FileDownloadQueueSet#setDirectory: 设置队列中所有任务文件存储的目录。

性能与提高

  • 提高实用性: 支持将path作为目录来存储文件，在这个情况下，文件名默认将从response#header中的contentDisposition中获得。 Refs #200.
  • 提高实用性: 将还未下载完成的文件存储在临时文件中(filename.temp)。 Refs #172.
  • 提高性能: FileDownloader不再将已经完成下载的任务存储在数据库中，判定任务是否已经下载完成，直接通过判断目标文件是否存在。 Refs #176, #172.
  • 提高稳定性: 选用状态是INVALID或progress优先接收completed消息, 以此确保connected状态的任务能够留下来接收progress状态的消息。 Refs #123
  • 提高稳定性: 扩张 任务同步锁 到 获取相同ID任务队列 的外面，以此修复由于有些状态在 获取相同ID任务队列 与 等待任务同步锁 的过程中已经被改变导致有些消息不能被消耗的问题。

修复

  • 修复(DB-维护): 保留状态是pending并且已经下载的字节数大于0的Model，因为这些Model可以用于恢复断点续传。 Closes #176.
  • 修复(crash-NPE): FileDownloader 可能遇到NPE当下载监听器被移除，但是对应任务还在FileDownloader中运行。 Closes #171.

Version 0.3.2

2016-06-12

新接口

  • 添加 BaseDownloadTask#setCallbackProgressMinInterval: 用于设置每个'progress'方法回调的间隔。 Closes #167 .
  • 添加 FileDownloader#setMaxNetworkThreadCount: 用于设置最大同时下载的数目（最大同时运行的网络线程）。 Closes #168.
  • 添加 FileDownloader#init(Context,OkHttpClientCustomMaker,int): 在下载服务初始化的时候接受设置最大同时下载数目（最大同时运行的网络线程）。 Closes #168.

性能与提高

  • 提高稳定性: 确保每个'progress'回调方法之间的最小间隔是5ms，防止对于一个任务而言'progress'回调太频繁导致'防掉帧队列'极速膨胀导致各类Action响应都延时。 Closes #167.
  • 提高实用性: 在请求的操作需要在下载服务中完成，但是还未连接上下载服务时，输出对应的'warn'级别的日志。
  • 提高性能: 使用SparseArray代替HashMap用于索引所有的FileDownloadModel。

修复

  • 修复(crash): 修复在某个下载任务开始下载时，发现任务的状态不正确的情况下，输出日志中提供了错误的参数类型导致的Crash。
  • 修复(强制重新下载): 修复错误逻辑导致设置BaseDownloadTask#setForceReDownload(true)并且任务已经下载完成会促发'warn'的回调，却没有进行强制重新下载的Bug。
  • 修复(class-type): 保持SocketTimeOutException的Class类型，不再关心Throwable的message是否为空。

其他

  • 所依赖的okhttp从3.2.0升到3.3.1。

Version 0.3.1

2016-05-19

性能与提高

  • 提高稳定性: 在结束下载时确保缓存中的数据都写入文件。

Version 0.3.0

2016-05-13

修复

为什么FileDownload服务可以运行在UI进程? 参考 filedownloader.properties.

  • 修复(下载服务共享UI进程时): 修复在下载服务不是运行在独立进程的情况下（非默认情况），附加的header没有带上请求的bug。Closes #149.

Version 0.2.9

2016-05-10

新接口

  • 添加 BaseDownloadTask#isUsing():boolean: 用于判断当前的Task对象是否在引擎中启动过. Closes #137 。

修复

  • 修复(高并发情况下的npe): 当任务的状态是一个未预期的状态是，提供一个默认的错误快照，避免出现npe 。
  • 修复(返回错误码-416): 覆盖返回错误码是416或者当出现已下载大小大于等于文件总大小的时候依然断点续传的bug。

Version 0.2.8

2016-05-02

新接口

  • 添加 BaseDownloadTask#getId():int: 弃用(没有删除该接口) getDownloadId(), 建议使用 getId() 代替 。

性能与提高

  • 提高稳定性: 重构任务启动器，使得启动任务更加可维护，以及标记任务过期更加可靠。
  • 提高稳定性: 重构将事件派发给FileDownloadListener的体系，新的体系就如同，派件员与快递驿站的关系，每次都会对事件进行快照，打包为一个消息快件，派发到驿站，转包给 FileDownloadListener。
  • 提高稳定性: 覆盖所有的有关暂停的高并发情况，删掉一些符合预期的警告性日志。
  • 提高性能: 减少FileDownloader database I/O 。
  • 提高性能: 减少创建对象(更少的内存分配请求，对于GC友好)对于每次回调, 对于一个下载状态的更新，只创建一个快照，整个通讯架构使用。

修复

  • 修复: 提供明确的locale用于格式化字符串，避免一些默认locale是非预期的情况发生。Closes #127

Version 0.2.7

2016-04-22

新接口

  • 添加 FileDownloader#setTaskCompleted(taskAtomList:List<FileDownloadTaskAtom>): 用于告诉FileDownloader引擎，指定的一系列的任务都已经通过其他方式(非FileDownloader)下载完成。

性能与提高

  • 提高稳定性: 假如在下载进程调用 bindService 直接抛异常，防止用户在使用过程中，错误的在下载进程绑定服务，而没有暴露这个根本问题，引发其他一系列的异常。Closes #119。

Version 0.2.6

2016-04-20

新接口

  • 调整: 将原本需要在根目录创建的 filedownloader.properties ，改为到 模块的 assets 目录下， 如 /demo/src/main/assets/filedownloader.properties。

修复

  • 修复 filedownloader.properties 中的参数不起作用的bug。 Closes #117.

Version 0.2.5

2016-04-19

新接口

  • 添加 FileDownloader#setTaskCompleted: 用于告诉FileDownloader引擎，以指定Url与Path的任务已经通过其他方式(非FileDownloader)下载完成。
  • 支持 新的配置参数download.max-network-thread-count 在 filedownloader.properties: 同时下载的最大网络线程数，默认值是3。 Closes #116.

Version 0.2.4

2016-04-18

新接口

  • 添加 BaseDownloadTask#getSpeed 以及 BaseDownloadTask#setMinIntervalUpdateSpeed: 获取任务的下载速度, 下载过程中为实时速度，下载结束状态为平均速度。 Closes #95 。
  • 添加 FileDownloader#startForeground 以及 FileDownloader#stopForeground 用于支持 前台模式([Service#startForeground](http://developer.android.com/intl/zh-cn/reference/android/app/Service.html#startForeground(int, android.app.Notification)))，保证用户从最近应用列表移除应用以后下载服务被杀。 Closes #110 。
  • 支持 新的配置参数 download.min-progress-step 以及 download.min-progress-time: 最小缓冲大小以及最小缓冲时间，用于判定是否是时候将缓冲区中进度同步到数据库，以及是否是时候要确保下缓存区的数据都已经写文件。这两个值越小，更新会越频繁，下载速度会越慢，但是应对进程被无法预料的情况杀死时会更加安全。默认值是与 com.android.providers.downloads.Constants中的一致 65536(最小缓冲大小) 以及 2000(最小缓冲时间)。
  • 支持 新的配置参数 process.non-separate 在 filedownloader.properties 中 : FileDownloadService 默认是运行在独立进程 :filedownloader 上的, 如果你想要FileDownloadService共享并运行在主进程上，以减少不必要的消耗(如IPC的I/O，维护进程的CPU的消耗等), 添加将该配置参数值设置为 true。 Closes #106 。

性能与提高

  • 提高性能: 提高了下载速度, 优化了同步缓冲区的数据到本地文件以及数据库的架构，很大程度的提高了下载速度。 Closes #112 。

修复

  • 修复: 无法重新启动一个已经暂停但是依然存在下载线程池中在pending中的任务。 Closes #111 。

Version 0.2.3

2016-04-11

新接口

  • 添加 FileDownloadOutOfSpaceException, 当将要下载的文件大小大于剩余磁盘大小时，会抛出这个异常。
  • 在 FileDownloadListener 新增 started 回调方法: 在结束 pending 开始运行当前任务的线程时，回调该方法。
  • 在 FileDownloadMonitor.IMonitor 新增 onTaskStarted 回调方法，用于监控在结束 pending 开始运行当前任务的线程时，回调该方法。这样就可以在监控中通过 onTaskBegin到onTaskStarted计算出pending的时间，在onTaskStarted到onTaskOver计算出真正消耗在下载的时间(Connection、Fetching)。

性能与提高

  • 提高实用性: 为 FinishListener 的 over 方法提供所指向的Task，为了有些时候我们为多个任务添加相同的 FinishListener 时，需要这个参数来判断当前是哪个任务的回调。 Closes #69 。
  • 提高稳定性: 如果调用一个正在运行中的Task对象的 start 方法，直接抛异常；并且为已经结束的Task对象提供 BaseDownloadTask#reuse 进行复用。 Closes #91 。
  • 提高性能: 在进入事件队列之前，拦截掉一些原本就没有监听器进行监听的事件。

修复

  • 修复: 在一些极端情况下，非结束的回调回调次数不符合预期的情况。
  • 修复: progress 方法的回调中包含了对完成( sofarBytes==totalBytes )的回调，导致回调间隔不达预期的bug。
  • 修复: 在 warn 回调带回 total-bytes，为了覆盖在 主进程被杀，下载进程存在的情况下，主进程重新重启并启动相同任务，total-bytes为0的bug。 Closes #90 。
  • 修复: 如果连续出现失败，连续回调 retry 时，retry 只被回调一次，其他的次数的 retry 都不被回调的bug。 Refs: #91 。
  • 修复: 在无网络状态下，启动下载，如果存在重试的机会，下载的进度被覆盖，导致下次无法断点续传的bug。 Closes #92 。
  • 修复: 有可能在'检测是否可以复用'到'检测是否在下载队列'的这段时间内已经下载完成但是任务还在队列中的极端情况。
  • 修复: 线性任务，在下载进程被杀重新启动被转为并行任务的bug。

Version 0.2.2

2016-04-06

新接口

  • 添加 FileDownloadHttpException 与 FileDownloadGiveUpRetryException, 优化异常回调处理机制. Closes #67 。
  • 初始化 FileDownloader 传入参数由原来需要 Application 改为 需要 Context( FileDownloader#init(Context) ), 优化接口，并且便于单元测试。 Closes #54 。

性能与提高

  • 提高稳定性: 在开始获取数据之前，先检查是否有足够的空间用于存储下载文件，如果不够直接抛异常，如果足够将锁定对应空间用于正常存储正在下载的文件。 Closes #46 。
  • 提高实用性: 断点续传支持，不再强制要求Etag存在；支持不需要Etag，只要后台支持 Range 头部参数就可以支持断点续传。 Close #35 , #66 。

修复

  • 修复: 在 FileDownloadLog.NEED_LOG 为 true 时，并且事件无效的情况下，EventPool 出现 IllegalFormatConversionException 异常的问题。 Closes #30 。
  • 修复: 在 Filedownloader进程被杀以后， 在 IFileDownloadIPCService 出现异常。Closes #38 。
  • 修复: 修复 response-body 可能存在的泄漏: 'WARNING: A connection to https://... was leaked. Did you forget to close a response body?' Closes #68 。
  • 修复: 使用 internal-string 作为同步的对象，而非直接用 String对象。
  • 修复: 在一些情况下如果存在重复任务，在高并发下进行中的回调次数可能不对的bug。

其他

  • 所依赖的okhttp从3.1.2升到3.2.0。

Version 0.2.0

2016-02-15

新接口

  • filedownloader.properties-http.lenient: 添加http.lenient用于配置下载引擎中是否需要忽略一些http规范性的错误(如: 忽略 can't know the size of the download file, and its Transfer-Encoding is not Chunked), 默认值false。
  • FileDownloadNotificationHelper: 用于支持在通知栏中的通知对下载引擎中任务下载状态同步的快速集成。
  • FileDownloader#init(Application,OkHttpClientCustomMaker): 用于为下载引擎提供定制的OkHttpClient。

修复

  • 修复: 需要重新启动的列表(FileDownloadTask.NEED_RESTART_LIST)不为空并且下载服务断开时出现Concurrent Modification Exception的异常。
  • 修复: 下载引擎连接丢失以后，重连任务的回调失效的bug。
  • 修复: 在一些高并发下载情况下，对队列进行暂停，部分暂停不生效的bug。

Version 0.1.9

2016-01-23

引擎默认会打开 避免掉帧的处理(使得一次回调(FileDownloadListener)不至于太频繁导致手机显示掉帧), 如果你希望关闭这个功能（关闭以后，所有回调会与之前版本一样，所有的回调会立马抛一个消息ui线程(Handler)）: FileDownloader.getImpl().disableAvoidDropFrame().

新接口

  • FileDownloadMonitor: 现在你可以通过这个来添加一个全局的监听器，方便调试或打点
  • FileDownloader#enableAvoidDropFrame(void): 开启 避免掉帧, 原理最多10ms抛一个消息到ui线程，每次在ui线程每次处理5个回调(FileDownloadListener), 默认: 开启。
  • FileDownloader#disableAvoidDropFrame(void): 关闭 避免掉帧，会和之前的版本一样，每个回调(FileDownloadListener)都抛一个消息到ui线程，如果频率非常高（如高并发的文件检测）可以导致ui线程被DDOS。
  • FileDownloader#isEnabledAvoidDropFrame(void): 是否是 开启了避免掉帧，目前如果没有设置默认是开启的。
  • FileDownloader#setGlobalPost2UIInterval(intervalMillisecond:int): 设置最多intervalMillisecond毫秒抛一个消息到ui线程，是 避免掉帧的具体设置。默认: 10ms，如果设置为小于0的数值，会 关闭 避免掉帧。
  • FileDownloader#setGlobalHandleSubPackageSize(packageSize:int): 设置每次在ui线程每次处理packageSize个回调，如果已经关闭了 避免掉帧，那么这个值将没有任何意义，默认: 5个。
  • BaseDownloadTask#setSyncCallback(syncCallback:boolean): 是否同步回调该task中的所有的回调(FileDownloadListener), 如果设为true, 该task的所有回调会直接在下载线程直接回调，不会抛到ui线程, 默认: false。
  • BaseDownloadTask#isSyncCallback(void):boolean: 该task是否设置了所有回调(FileDownloadListener)同步调用(直接在下载线程直接调用，而非抛到ui线程)。
  • FileDownloadUtils#setDefaultSaveRootPath: 设置全局默认的存储路径(Root Path)，在task没有指定对应的存储路径的时候，会存储在该目录下。
  • FileDownloadQueueSet: 用于更方便的指定几个task为一个队列，进行并行/串行下载，并且可以很方便的对整个队列中的所有任务进行统一设置。

性能与提高

  • 提高可调试性: 提供了一个全局监听器(FileDownloadMonitor)，更方便与调试或打点。
  • 提高性能: 优化内部EventPool的锁机制，不再处理listener的priority。
  • 提高性能: 所有FileDownloadListener中的回调将会直接调用，而不再过一层EventPool。

修复

  • 修复: EventPool中的listener存储器无限制的bug.

Version 0.1.5

2016-01-17

新接口

  • BaseDownloadTask#setTag(key:int, tag:Object): 用于存储任意的变量方便回调中使用，以key作为索引。
  • BaseDownloadTask#getTag(key:int): 根据key获取存储在task中的变量。
  • BaseDownloadTask#addHeader(name:String, value:String): 添加自定义的请求头参数，需要注意的是内部为了断点续传，在判断断点续传有效时会自动添加上(If-Match与Range参数)，请勿重复添加导致400或其他错误。
  • BaseDownloadTask#addHeader(line:String): 添加自定义的请求头参数，需要注意的是内部为了断点续传，在判断断点续传有效时会自动添加上(If-Match与Range参数)，请勿重复添加导致400或其他错误。
  • BaseDownloadTask#removeAllHeaders(name:String): 删除由自定义添加上去请求参数为{name}的所有键对。

性能与提高

  • 提高性能: 在未打开Log的情况下，屏蔽了所有Log生成的代码。
  • 提高可调试性: 重新过滤所有的日志级别，减少高级别日志输出，并且默认将会打出Warn、Error、Assert级别的log以便于用户在未打开日志的情况下也可以定位到基本的组件异常。

修复

  • 修复: 在一些高并发的情况下，有可能内部队列存在残留任务的bug，此bug可能可能引发回调被旧的任务吞掉的问题。
  • 修复: 出现网络错误，或者其他错误，重新下载无法自动断点续传的bug。

其他

  • 所依赖的okhttp从2.7.1升到3.0.1。

Version 0.1.4

2016-01-13

新接口

  • FileDownloader#unBindServiceIfIdle(void): 如果目前下载进程没有任务正在执行，则关停下载进程
  • FileDownloader#getStatus(downloadId): 获取下载Id为downloadId的状态(可参考任务管理demo)
  • FileDownloader#isServiceConnected(void): 是否已经启动并且连接上下载进程(可参考任务管理demo)

性能与提高

  • 支持Chunked transfer encoding 数据下载(建议看一眼Single Task Test).
  • 提高性能: 减少 IPC。
  • 提高性能: 减少线程锁。
  • 提高性能: 在:filedownloader进程启动时，对数据库中的数据进行第一级别维护。
  • 提高性能: 忽略数据库中的callbackProgressTimes字段。

修复

  • 修复: 在低内存情况下，ui进程处于后台进程的情况下被回收，而下载进程(服务进程)还在, 并且还存在在下载中的任务，此时重新启动ui进程FileDownloader#pauseAll无法暂停已经在下载进程启动的任务的bug。
  • 修复: 主动调用FileDownloader#unBinderService，没有释放连接相关资源的bug。
  • 修复: ui进程被干掉，下载进程健还有活跃的并行任务正在下载，ui进程启动以后启动相同的队列列表，无法收到进度只收到warn的bug。

Version 0.1.3

2016-01-04

  • 不再受到1.99G限制;如果是大于1.99G的文件，请使用FileDownloadLargeFileListener作为监听器，使用对应的getLargeFileSoFarBytes()与getLargeFileTotalBytes()接口
  • 性能优化: 部分接口跨进程通信不受binder thread 阻塞。
  • 依赖okhttp，从2.7.0升到2.7.1

Version 0.1.2

2015-12-27

  • 优化线程消化能力
  • 修复大队列任务暂停可能部分无效的问题
  • 修复大队列并行下载时一定概率下载已经完成回调囤积延后回调的问题

Version 0.1.1

2015-12-25

  • event线程区分敏捷线程池与其他线程池，减少资源冗余强制、内部稳定性以及消化能力与性能，
  • 添加自动重试接口，新增用户指定如果失败自动重试的次数

Version 0.1.0

2015-12-24

  • FileDownloadStatus 由int改为byte，该参数会频繁的在IPC时被拷贝
  • 优化串行or并行任务时，筛选task在准备数据时就筛选好，减少冗余操作，更加安全
  • 优化串行任务执行保证使用更可靠的方式

Version 0.0.9

2015-12-23

  • 将调用start(启动任务)抛独立线程处理，其中的线程是通过共享非下载进程EventPool中的线程池(可并行8个线程)

Version 0.0.8

2015-12-22

  • initial release