upgrade version code(6->7) name(0.1.3 -> 0.1.4)

Author: Jacksgong

CHANGELOG-ZH.md

@@ -1,5 +1,27 @@
 # Change log
 
+### Version 0.1.4
+
+#### 新接口
+
+- `FileDownloader#unBindServiceIfIdle(void)`: 如果目前下载进程没有任务正在执行，则关停下载进程
+- `FileDownloader#getStatus(downloadId)`: 获取下载Id为downloadId的状态(可参考[任务管理demo](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/TasksManagerDemoActivity.java))
+- `FileDownloader#isServiceConnected(void)`: 是否已经启动并且连接上下载进程(可参考[任务管理demo](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/TasksManagerDemoActivity.java))
+
+#### 性能与提高
+
+- 支持[Chunked transfer encoding](https://en.wikipedia.org/wiki/Chunked_transfer_encoding) 数据下载(建议看一眼[Single Task Test](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/SingleTaskTestActivity.java)).
+- 提高性能: 减少 IPC。
+- 提高性能: 减少线程锁。
+- 提高性能: 在`:filedownloader`进程启动时，对数据库中的数据进行第一级别维护。
+- 提高性能: 忽略数据库中的`callbackProgressTimes`字段。
+
+#### 修复
+
+- 修复: 在低内存情况下，ui进程处于后台进程的情况下被回收，而下载进程(服务进程)还在, 并且还存在在下载中的任务，此时重新启动ui进程`FileDownloader#pauseAll`无法暂停已经在下载进程启动的任务的bug。
+- 修复: 主动调用`FileDownloader#unBinderService`，没有释放连接相关资源的bug。
+- 修复: ui进程被干掉，下载进程健还有活跃的并行任务正在下载，ui进程启动以后启动相同的队列列表，无法收到进度只收到warn的bug。
+
 ### Version 0.1.3
 
 - 不再受到1.99G限制;如果是大于1.99G的文件，请使用`FileDownloadLargeFileListener`作为监听器，使用对应的`getLargeFileSoFarBytes()`与`getLargeFileTotalBytes()`接口
@@ -29,4 +51,4 @@
 
 ### Version 0.0.8
 
-- initial release
+- initial release

CHANGELOG.md

@@ -2,6 +2,29 @@
 
 > [中文迭代日志](https://github.com/lingochamp/FileDownloader/blob/master/CHANGELOG-ZH.md)
 
+### Version 0.1.4
+
+#### New Interfaces
+
+- `FileDownloader#unBindServiceIfIdle(void)`: If there is no active task in the `:filedownloader` progress currently , then unbind & stop `:filedownloader` process
+- `FileDownloader#getStatus(downloadId)`: Get download status by the downloadId(ps: Please refer to [Tasks Manager demo](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/TasksManagerDemoActivity.java)
+- `FileDownloader#isServiceConnected(void)`: Whether started and connected to the `:filedownloader` progress(ps: Please refer to [Tasks Manager demo](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/TasksManagerDemoActivity.java))
+
+#### Enhancement
+
+- Supported [Chunked transfer encoding](https://en.wikipedia.org/wiki/Chunked_transfer_encoding) data download(Recommend to glance at demo on [Single Task Test](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/SingleTaskTestActivity.java)).
+- Improve Performance: Reduce IPC.
+- Improve Performance: Reduce lock.
+- Improve Performance: Delete invalid datas in db with the `:filedownloader` progress start.
+- Improve Performance: Ignore the `callbackProgressTimes` column in db.
+
+#### Fix
+
+- Fix `FileDownloader#pauseAll` not effect in case of low memory and ui progress is Background Progress situation and the `:filedownloader` progress(Service Progress) alive and still have running tasks in the `filedownloader` progress but ui progress has died and relived.
+- Fix not release connect resources when invoke `FileDownloader#unBinderService` manually.
+- Handle case of ui progress be killed by sys and download progress not be killed, and ui progress relives and reexecutes same tasks queue.
+
+
 ### Version 0.1.3
 
 - Enhancement: no longer subject to the upper bound of 1.99G, add `FileDownloadLargeFileListener`, `getLargeFileSoFarBytes()`,`getLargeFileTotalBytes()`.
@@ -31,4 +54,4 @@
 
 ### Version 0.0.8
 
-- initial release
+- initial release

README-zh.md

@@ -43,7 +43,7 @@ Android 文件下载引擎，稳定、高效、简单易用
 在项目中引用:
 
 ```
-compile 'com.liulishuo.filedownloader:library:0.1.3'
+compile 'com.liulishuo.filedownloader:library:0.1.4'
 ```
 
 #### 全局初始化在`Application.onCreate`中
@@ -150,6 +150,7 @@ final FileDownloadListener queueTarget = new FileDownloadListener() {
 for (String url : URLS) {
     FileDownloader.getImpl().create(url)
             .setListener(queueTarget)
+            .setCallbackProgressTimes(0) // 由于是队列任务, 这里是我们假设了现在不需要每个任务都回调`FileDownloadListener#progress`, 所以这里这样设置可以很有效的减少ipc.
             .ready();
 }
 
@@ -180,7 +181,10 @@ if(parallel){
 | getSoFar(downloadId) | 获得下载Id为downloadId的soFarBytes
 | getTotal(downloadId) | 获得下载Id为downloadId的totalBytes
 | bindService(void) | 主动启动下载进程(可事先调用该方法(可以不调用)，保证第一次下载的时候没有启动进程的速度消耗)
-| unBindService(void) | 主动停止下载进程(如果不调用该方法，进程闲置一段时间以后，系统调度会自动将其回收)
+| unBindService(void) | 主动关停下载进程
+| unBindServiceIfIdle(void) | 如果目前下载进程没有任务正在执行，则关停下载进程
+| isServiceConnected(void) | 是否已经启动并且连接上下载进程(可参考任务管理demo中的使用)
+| getStatus(downloadId) | 获取下载Id为downloadId的状态(可参考任务管理demo中的使用)
 
 #### Task接口说明
 
@@ -250,7 +254,33 @@ blockComplete -> completed
 
 ![][file_download_listener_callback_flow_png]
 
-## III. LICENSE
+## III. 低内存情况
+
+### 非下载进程(一般是UI进程):
+
+> 这边的数据并不多，只是一些队列数据，用不了多少内存。
+
+#### [前台进程](http://developer.android.com/intl/zh-cn/guide/components/processes-and-threads.html)数据被回收:
+
+如果在前台的时候这个数据都被回收了, 你的应用应该也挂了。极低概率事件。
+
+#### [后台进程](http://developer.android.com/intl/zh-cn/guide/components/processes-and-threads.html)数据被回收:
+
+一般事件, 如果是你的下载是UI进程启动的，如果你的UI进程处于`后台进程`(可以理解为应用被退到后台)状态，在内存不足的情况下会被回收(回收优先级高于`服务进程`)，此时分两种情况:
+
+1. 是串行队列任务，在回收掉UI进程内存以后，下载进程会继续下载完已经pending到下载进程的那个任务，而还未pending到下载进程的任务会中断下载(由于任务驱动线性执行的是在UI进程); 有损体验: 下次进入应用重启启动整个队列，会继续上次的下载。
+
+2. 是并行队列任务，在回收掉UI进程内存以后，下载进程会继续下载所有任务(所有已经pending到下载进程的任务，由于这里的pending速度是很快的，因此几乎是点击并行下载，所有任务在很短的时间内都已经pending到下载进程了)，而UI进程由于被回收，将不会收到所有的监听; 有损体验: 下次进入应用重新启动整个队列，就会和正常的下载启动一致，收到所有情况的监听。
+
+### 下载进程:
+
+> 对内存有一定的占用，但是并不多，每次启动进程会根据数据的有效性进行清理冗余数据，被回收是低概率事件
+
+由于下载不断有不同的buffer占用内存，但是由于在下载时，是活跃的`服务进程`，因此被回收是低概率事件(会先回收完所有`空进程`、`后台进程`(后台应用)以后，如果内存还不够，才会回收该进程)。
+
+即使被回收，也不会有任何问题。由于我们使用的是`START_STICKY`(如果不希望被重启可主动调用`FileDownloader#unBindService`/`FileDownloader#unBindServiceIfIdle`)，因此在内存足够的时候，下载进程会尝试重启(系统调度)，非下载进程(一般是UI进程) 接收到下载进程的连接，会继续下载与继续接收回调，下载进程也会断点续传没有下载完的所有任务(无论并行与串行)，不会影响体验。
+
+## IV. LICENSE
 
 ```
 Copyright (c) 2015 LingoChamp Inc.

README.md

@@ -24,7 +24,7 @@ FileDownloader is installed by adding the following dependency to your build.gra
 
 ```
 dependencies {
-    compile 'com.liulishuo.filedownloader:library:0.1.3'
+    compile 'com.liulishuo.filedownloader:library:0.1.4'
 }
 ```
 
@@ -139,6 +139,7 @@ final FileDownloadListener queueTarget = new FileDownloadListener() {
 
 for (String url : URLS) {
     FileDownloader.getImpl().create(url)
+            .setCallbackProgressTimes(0) // why do this? in here i assume do not need callback each task's `FileDownloadListener#progress`, so in this way reduce ipc will be effective optimization
             .setListener(queueTarget)
             .ready();
 }
@@ -167,14 +168,17 @@ if(parallel){
 | --- | ---
 | init(Application) |  Just cache ApplicationContext
 | create(url:String) | Create a download task
-| start(listener:FileDownloadListener, isSerial:boolean) | Start the download queue by the same listener
+| start(listener:FileDownloadListener, isSerial:boolean) | Start the download queue by the same listener(maybe do not need callback each task's `FileDownloadListener#progress` in this case, then set `setCallbackProgressTimes(0)` is effective optimization)
 | pause(listener:FileDownloadListener) | Pause the download queue by the same listener
 | pauseAll(void) | Pause all task
 | pause(downloadId) | Pause the download task by the downloadId
 | getSoFar(downloadId) | Get downloaded so far bytes by the downloadId
 | getTotal(downloadId) | Get file total bytes by the downloadId
 | bindService(void) | Bind & start `:filedownloader` process manually(Do not need, will bind & start automatically by Download Engine if real need)
-| unBindService(void) | Unbind & stop `:filedownloader` process manually(Do not need, will unbind & stop automatically by System if leave unused period)
+| unBindService(void) | Unbind & stop `:filedownloader` process manually
+| unBindServiceIfIdle(void) | If there is no active task in the `:filedownloader` progress currently , then unbind & stop `:filedownloader` process
+| isServiceConnected(void) | Whether started and connected to the `:filedownloader` progress(ps: Please refer to [Tasks Manager demo](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/TasksManagerDemoActivity.java))
+| getStatus(downloadId) | Get download status by the downloadId(ps: Please refer to [Tasks Manager demo](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/TasksManagerDemoActivity.java))
 
 #### `FileDownloadTask`
 
@@ -250,6 +254,14 @@ blockComplete -> completed
 - Default by okhttp: retryOnConnectionFailure: Unreachable IP addresses/Stale pooled connections/Unreachable proxy servers
 - Default by okhttp: connection/read/write time out 10s
 
+#### Low Memory?
+
+We covered all low memory cases follow [Processes and Threads](http://developer.android.com/guide/components/processes-and-threads.html), just feel free to use the FileDownloader, it will be follow your expect.
+
+
+#### Chunked transfer encoding data?
+
+Has supported, just use as normal task, but recommend to glance at demo on [Single Task Test](https://github.com/lingochamp/FileDownloader/blob/master/demo/src/main/java/com/liulishuo/filedownloader/demo/SingleTaskTestActivity.java).
 
 ## LICENSE
 

gradle.properties

@@ -1,5 +1,5 @@
-VERSION_NAME=0.1.3
-VERSION_CODE=6
+VERSION_NAME=0.1.4
+VERSION_CODE=7
 BUILD_TOOLS_VERSION=23.0.1
 COMPILE_SDK_VERSION=23