1.更新 DevApp、DevJava 版本信息、API 文档

Former-commit-id: f8e75ff Former-commit-id: b7745dd
afkT · Oct 11, 2020 · 146c5dd · 146c5dd
1 parent 8c85554
commit 146c5dd
Show file tree

Hide file tree

Showing 6 changed files with 65 additions and 12 deletions.
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 
 [![GitHub](https://img.shields.io/badge/GitHub-afkT-blue.svg)](https://github.com/afkT)
 [![GitHub license](https://img.shields.io/github/license/afkT/DevUtils.svg)](https://github.com/afkT/DevUtils/blob/master/LICENSE)
-[![Bintray](https://img.shields.io/badge/DevUtils-2.0.5-brightgreen.svg)](https://bintray.com/afkt/maven/DevAppX)
+[![Bintray](https://img.shields.io/badge/DevUtils-2.0.6-brightgreen.svg)](https://bintray.com/afkt/maven/DevAppX)
 [![API](https://img.shields.io/badge/API-14%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=14)
 [![Utils](https://img.shields.io/badge/utils-160+-ff69b4.svg)](https://github.com/afkT/DevUtils/blob/master/lib/DevApp/README.md)
 
@@ -71,7 +71,7 @@
 ```java
 
 // DevApp Android 工具类库
-implementation 'com.afkt:DevAppX:2.0.5'
+implementation 'com.afkt:DevAppX:2.0.6'
 
 // DevAssist 快捷功能辅助类库
 implementation 'com.afkt:DevAssist:1.0.4'
@@ -80,7 +80,7 @@ implementation 'com.afkt:DevAssist:1.0.4'
 implementation 'com.afkt:DevBase:1.0.0'
 
 // DevJava Java 工具类库 ( 不依赖 android api )
-implementation 'com.afkt:DevJava:1.1.8' // 用于纯 Java 开发，如果依赖了 DevApp 则不需要依赖 DevJava
+implementation 'com.afkt:DevJava:1.1.9' // 用于纯 Java 开发，如果依赖了 DevApp 则不需要依赖 DevJava
 
 // DevWidget 自定义 View UI 库
 implementation 'com.afkt:DevWidgetX:1.0.4'

diff --git a/file/gradle/config.gradle b/file/gradle/config.gradle
@@ -44,9 +44,9 @@ ext {
             // ===========
 
             // 版本号
-            dev_app_versionCode                     : 205,
+            dev_app_versionCode                     : 206,
             // 版本名
-            dev_app_versionName                     : '2.0.5',
+            dev_app_versionName                     : '2.0.6',
 
             // 版本号
             dev_assist_versionCode                  : 104,
@@ -59,9 +59,9 @@ ext {
             dev_base_versionName                    : '1.0.0',
 
             // 版本号
-            dev_java_versionCode                    : 118,
+            dev_java_versionCode                    : 119,
             // 版本名
-            dev_java_version                        : '1.1.8',
+            dev_java_version                        : '1.1.9',
 
             // 版本号
             dev_widget_versionCode                  : 104,

diff --git a/lib/DevApp/CHANGELOG.md b/lib/DevApp/CHANGELOG.md
@@ -1,7 +1,7 @@
 Change Log
 ==========
 
-Version 2.0.6 *(2020-10-XX)*
+Version 2.0.6 *(2020-10-12)*
 ----------------------------
 
 * `[Add]` ScreenshotUtils 截图监听工具类

diff --git a/lib/DevApp/README.md.REMOVED.git-id b/lib/DevApp/README.md.REMOVED.git-id
@@ -1 +1 @@
-5258d26a198e0262e1dc66898d6d45ac7441f2aa
+c64de82f9f093d0ec0bab24c938933784d7ee707
diff --git a/lib/DevJava/CHANGELOG.md b/lib/DevJava/CHANGELOG.md
@@ -1,7 +1,7 @@
 Change Log
 ==========
 
-Version 1.1.9 *(2020-10-XX)*
+Version 1.1.9 *(2020-10-12)*
 ----------------------------
 
 * `[Add]` FilePartUtils 文件分片工具类

diff --git a/lib/DevJava/README.md b/lib/DevJava/README.md
@@ -2,7 +2,7 @@
 ## Gradle
 
 ```java
-implementation 'com.afkt:DevJava:1.1.8'
+implementation 'com.afkt:DevJava:1.1.9'
 ```
 
 ## 目录结构
@@ -14,6 +14,7 @@ implementation 'com.afkt:DevJava:1.1.8'
          - search                                     | 搜索相关 ( 文件搜索等 )
       - cipher                                        | 编 / 解码工具类
       - encrypt                                       | 加密工具类
+      - file                                          | 文件分片相关
       - random                                        | 随机概率算法工具类
       - thread                                        | 线程相关
       - validator                                     | 数据校验工具类
@@ -47,6 +48,7 @@ JCLogUtils.setPrint(new JCLogUtils.Print() {});
          - [search](#devutilscommonassistsearch)      | 搜索相关 ( 文件搜索等 )
       - [cipher](#devutilscommoncipher)               | 编 / 解码工具类
       - [encrypt](#devutilscommonencrypt)             | 加密工具类
+      - [file](#devutilscommonfile)                   | 文件分片相关
       - [random](#devutilscommonrandom)               | 随机概率算法工具类
       - [thread](#devutilscommonthread)               | 线程相关
       - [validator](#devutilscommonvalidator)         | 数据校验工具类
@@ -182,6 +184,10 @@ JCLogUtils.setPrint(new JCLogUtils.Print() {});
 | :- | :- |
 | closeIO | 关闭 IO |
 | closeIOQuietly | 安静关闭 IO |
+| flush | 将缓冲区数据输出 |
+| flushQuietly | 安静将缓冲区数据输出 |
+| flushCloseIO | 将缓冲区数据输出并关闭流 |
+| flushCloseIOQuietly | 安静将缓冲区数据输出并关闭流 |
 
 
 * **集合工具类 ( Collection - List、Set、Queue ) 等 ->** [CollectionUtils.java](https://github.com/afkT/DevUtils/blob/master/lib/DevJava/src/main/java/dev/utils/common/CollectionUtils.java)
@@ -516,6 +522,8 @@ JCLogUtils.setPrint(new JCLogUtils.Print() {});
 | createOrExistsDir | 判断目录是否存在, 不存在则判断是否创建成功 |
 | createOrExistsFile | 判断文件是否存在, 不存在则判断是否创建成功 |
 | createFileByDeleteOldFile | 判断文件是否存在, 存在则在创建之前删除 |
+| convertFiles | Path List 转 File List |
+| convertPaths | File List 转 Path List |
 | getPath | 获取文件路径 |
 | getAbsolutePath | 获取文件绝对路径 |
 | getName | 获取文件名 |
@@ -543,7 +551,7 @@ JCLogUtils.setPrint(new JCLogUtils.Print() {});
 | getDirName | 获取路径中的最长目录地址 |
 | rename | 重命名文件 ( 同个目录下, 修改文件名 ) |
 | formatFileSize | 传入文件路径, 返回对应的文件大小 |
-| formatByteMemorySize | 字节数转合适内存大小 保留 3 位小数 (%.位数f) |
+| formatByteMemorySize | 字节数转合适内存大小 保留 3 位小数 |
 | deleteFile | 删除文件 |
 | deleteFiles | 删除多个文件 |
 | deleteFolder | 删除文件夹 |
@@ -1150,6 +1158,51 @@ JCLogUtils.setPrint(new JCLogUtils.Print() {});
 | decrypt | 解密 ( 非固定 Key 方式 ) |
 
 
+## <span id="devutilscommonfile">**`dev.utils.common.file`**</span>
+
+
+* **文件分片辅助类 ->** [FilePartAssist.java](https://github.com/afkT/DevUtils/blob/master/lib/DevJava/src/main/java/dev/utils/common/file/FilePartAssist.java)
+
+| 方法 | 注释 |
+| :- | :- |
+| getFile | 获取文件 |
+| getFileName | 获取文件名 |
+| getFilePartItems | 获取文件分片信息集合 |
+| getFilePartItem | 获取指定索引文件分片信息 |
+| getPartCount | 获取分片总数 |
+| existsPart | 是否存在分片 |
+| isOnlyOne | 是否只有一个分片 |
+| getPartName | 获取分片文件名 ( 后缀索引拼接 ) |
+
+
+* **文件分片信息 Item ->** [FilePartItem.java](https://github.com/afkT/DevUtils/blob/master/lib/DevJava/src/main/java/dev/utils/common/file/FilePartItem.java)
+
+| 方法 | 注释 |
+| :- | :- |
+| isFirstItem | 判断是否 First Item |
+| isLastItem | 判断是否 Last Item |
+| existsPart | 是否存在分片 |
+| isOnlyOne | 是否只有一个分片 |
+| getPartName | 获取分片文件名 ( 后缀索引拼接 ) |
+
+
+* **文件分片工具类 ->** [FilePartUtils.java](https://github.com/afkT/DevUtils/blob/master/lib/DevJava/src/main/java/dev/utils/common/file/FilePartUtils.java)
+
+| 方法 | 注释 |
+| :- | :- |
+| getPartName | 获取分片文件名 ( 后缀索引拼接 ) |
+| getFilePartAssist | 获取文件分片辅助类 |
+| isFilePart | 是否符合文件分片条件 |
+| fileSplit | 文件拆分 |
+| fileSplitSave | 文件拆分并存储 |
+| fileSplitSaves | 文件拆分并存储 |
+| fileSplitDelete | 删除拆分文件 |
+| fileSplitDeletes | 删除拆分文件 |
+| fileSplitMergePaths | 分片合并 |
+| fileSplitMergeFiles | 分片合并 |
+| fileSplitMerge | 分片合并 |
+
+
 ## <span id="devutilscommonrandom">**`dev.utils.common.random`**</span>
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		5258d26a198e0262e1dc66898d6d45ac7441f2aa
		c64de82f9f093d0ec0bab24c938933784d7ee707