扫描工具
====

#### 简介

扫描工具可用于分析检测应用安装包，根据不同的参数设定，扫描指定路径的HAP、HSP、App包内容并输出检测结果报告，为开发者优化包结构或排查问题提供数据支撑。目前扫描工具支持以下几种分析统计：

*   扫描重复文件。
*   扫描超出指定大小的文件。
*   统计分析各类型文件的总大小和占比。
    

工具扫描结果默认以JSON和HTML两种文件格式输出。

扫描工具app\_check\_tool.jar需要从SDK路径下的toolchains目录中获取。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a7/v3/jRXsJMfZR6amOSMYpuS6rw/zh-cn_image_0000002625108281.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=53A1118B7453F87C5FF55B03B1F3F8037E5584E10A1AF22C917DCACD50840942)

#### 约束与限制

*   扫描工具需运行在Java8及其以上环境。
*   扫描工具运行所在的目录需要有读写权限。

#### 扫描重复文件示例

**命令示例：**

java -jar app\_check\_tool.jar --input ./test.app --out-path ./test --stat-duplicate true

**表1 扫描重复文件指令参数说明**

| 指令 | 是否必选项 | 描述 |
| :-- | :-- | :-- |
| \--input | 是 | 指定传入的HAP、HSP、App包文件路径。 |
| \--out-path | 是 | 指定结果输出文件夹目录。 |
| \--stat-duplicate | 否 | 
是否扫描重复文件。默认为false。

true：启用。

false：不启用。

 |

**JSON统计结果：**

\[{
    "taskType":1,
    "taskDesc":"find the duplicated files",
    "param":"--stat-duplicate",
    "startTime":"2023-11-17 14:48:01:265",
    "stopTime":"2023-11-17 14:48:01:434",
    "result":\[{
        "md5":"975c41f5727b416b1ffefa5bb0f073b2",
        "size":1108880,
        "files":\[
            "/application-entry-default.hap/libs/armeabi-v7a/example.so",
            "/entry-default.hap/libs/armeabi-v7a/example.so"
        \]
    }\]
}\]

**表2 扫描重复文件字段信息**

| 字段 | 类型 | 描述 |
| :-- | :-- | :-- |
| taskType | int | 取值为1，表示扫描重复文件。 |
| taskDesc | String | 任务的详细描述。 |
| param | String | 扫描程序传入参数。 |
| startTime | String | 任务开始时间。 |
| stopTime | String | 任务结束时间。 |
| result | Struct | 重复文件统计结果字段信息，具体内容参考表3。 |

**表3 重复文件统计结果字段信息**

| 字段 | 类型 | 描述 |
| :-- | :-- | :-- |
| md5 | String | 相同文件的MD5值。 |
| size | int | 相同文件的大小。单位为Byte。 |
| files | Vector<String> | 相同文件名的对应路径。 |

#### 扫描超出指定大小的文件示例

**命令示例：**

java -jar app\_check\_tool.jar --input ./test.app --out-path ./test --stat-file-size 4

**表4 扫描超出指定大小的文件的指令参数说明**

| 指令 | 是否必选项 | 描述 |
| :-- | :-- | :-- |
| \--input | 是 | 指定传入的HAP、HSP、App包文件路径。 |
| \--out-path | 是 | 指定结果输出文件夹目录。 |
| \--stat-file-size | 否 | 
扫描超过设定大小的文件，单位KB。

范围为 0-4294967295 KB。

 |

**JSON统计结果：**

\[{
    "taskType":2,
    "taskDesc":"find files whose size exceed the limit size",
    "param":"--stat-file-size 4",
    "startTime":"2023-11-17 14:48:01:458",
    "stopTime":"2023-11-17 14:48:01:491",
    "result":\[{
            "file":"/application-entry-default.hap/libs/x86\_64/example.so",
            "size":1292840
    }\]
}\]

**表5 扫描超出指定大小的文件字段信息**

| 字段 | 类型 | 描述 |
| :-- | :-- | :-- |
| taskType | int | 取值为2，表示扫描超出指定大小文件。 |
| taskDesc | String | 任务的详细描述。 |
| param | String | 扫描程序传入参数。 |
| startTime | String | 任务开始时间。 |
| stopTime | String | 任务结束时间。 |
| result | Struct | 超出指定大小的文件统计结果字段信息，具体内容参考表6。 |

**表6 超出指定大小的文件统计结果字段信息**

| 字段 | 类型 | 描述 |
| :-- | :-- | :-- |
| file | String | 扫描的大文件的对应路径。 |
| size | int | 扫描的大文件的对应大小，单位为Byte。 |

#### 统计各类型文件大小占比示例

**命令示例：**

java -jar app\_check\_tool.jar --input ./test.app --out-path ./test --stat-suffix true

**表7 统计各类型文件大小占比指令参数说明**

| 指令 | 是否必选项 | 描述 |
| :-- | :-- | :-- |
| \--input | 是 | 指定传入的HAP、HSP、App包文件路径。 |
| \--out-path | 是 | 指定结果输出文件夹目录。 |
| \--stat-suffix | 否 | 
是否统计各类型文件大小及占比。默认为false。

true：启用。

false：不启用。

 |

**JSON统计结果：**

\[{
    "taskType":3,
    "taskDesc":"show files group by file type\[.suffix\]",
    "param":"--stat-suffix",
    "startTime":"2023-11-17 14:48:01:497",
    "stopTime":"2023-11-17 14:48:01:537",
    "pathList":\[
        "test.app/application-entry-default.hap",
        "test.app/entry-default.hap"
    \],
    "result":\[{
        "suffix":"so",
        "totalSize":1292840,
        "files":\[{
            "compress":"false",
            "file":"/application-entry-default.hap/libs/x86\_64/example.so",
            "size":1292840
        }\]
    },
    {
        "suffix":"abc",
        "totalSize":84852,
        "files":\[{
            "file":"/application-entry-default.hap/ets/modules.abc",
            "size":76304
        },
        {
            "file":"/entry-default.hap/ets/modules.abc",
            "size":8548
        }\]
    }\]
}\]

**表8 统计各类型文件大小占比字段信息**

| 字段 | 类型 | 描述 |
| :-- | :-- | :-- |
| taskType | int | 取值为3，表示统计各类型文件大小占比。 |
| taskDesc | String | 任务的详细描述。 |
| param | String | 扫描程序传入参数。 |
| startTime | String | 任务开始时间。 |
| stopTime | String | 任务结束时间。 |
| pathList | Vector<String> | 多个HAP、HSP包的路径。 |
| result | Struct | 各类型文件大小占比统计结果字段信息，具体内容参考表9。 |

**表9 各类型文件大小占比统计结果字段信息**

| 字段 | 类型 | 描述 |
| :-- | :-- | :-- |
| suffix | String | 同类型文件后缀名。 |
| totalSize | int | 扫描的同类型文件的总大小，单位为Byte。 |
| files | Struct | 同类型文件的对应路径和大小字段信息，具体内容参考表10。 |

**表10 同类型文件的对应路径和大小字段信息**

| 字段 | 类型 | 描述 |
| :-- | :-- | :-- |
| file | String | 文件路径。 |
| size | int | 文件的大小，单位为Byte。 |
| compress | bool | 
是否是压缩文件（仅so类型文件展示）。

true：是压缩文件。

false：不是压缩文件。

 |