构建亲和

命令功能

对构建亲和进行检查。

命令格式

devkit advisor affi-check [-h | --help] {-i INPUT_PATH | --input INPUT_PATH} {-c COMMAND | --cmd COMMAND} [-o OUTPUT_PATH | --output OUTPUT_PATH] [-r {all,json,html,csv} | --report-type {all,json,html,csv}] [-l {0,1,2,3} | --log-level {0,1,2,3}] [--set-timeout TIMEOUT]

参数说明

表1 参数说明
参数	参数选项	参数说明
-h/--help	-	可选参数，获取帮助信息。
-i/--input	input_path	必选参数，对应的源码文件夹路径。
-c/--cmd	command	必选参数，源码构建命令。在服务器中正常执行的构建命令，若存在多个构建命令需使用英文分号分隔并用英文单/双引号包住；命令中如有空格，也需要用英文单/双引号包住。例如："mkdir build;cd build;cmake ..;make"。说明：命令行工具源码构建命令不支持设置变量和export环境变量。例如："CFLAGS='-O0 -g';make"或"export CFLAGS='-O0 -g';make"。
-o/--output	output_path	可选参数，扫描报告的存放路径，默认存放在当前执行路径下，报告名称为模块名称_时间戳。
--set-timeout	time	可选参数，任务超时时间，单位为分钟，若执行时间超过超时时间则退出执行。默认无超时时间，任务将持续执行直到结束。
-l/--log-level	0/1/2/3	可选参数，设置日志级别，默认为1。 0：日志级别为DEBUG。 1：日志级别为INFO。 2：日志级别为WARNING。 3：日志级别为ERROR。
-r/--report-type	all/json/html/csv	可选参数，扫描报告的格式，默认为all。 all：生成JSON、HTML、CSV三种格式报告。 json：生成JSON格式报告。 html：生成HTML格式报告。 csv：生成CSV格式报告。

使用示例

此处以扫描“/home/advisor/project”路径下源码，构建命令为make为例，请根据实际情况进行修改。

devkit advisor affi-check -i /home/advisor/project -o /home/output -c make

若在源码路径下进行构建亲和检查，分析完成后，执行ls时目录为空，这时需要返回到上一层目录，再重新进入到源码路径下执行ls命令，可以查看到相关文件。

返回信息如下，并输出报告。

Executing Build Affinity Analysis task, please wait...
Data initialization.
Current progress: ### [10%]
Compiling the project. It may take a long time. Please wait...
Current progress: #################### [60%]
Optimization suggestions for the matching acceleration library.
Current progress: ################################# [100%]
Build Affinity Affinity task has been executed.
Scanned time: 2025/04/08 11:45:51
Scan status: Succeed. Some items are recommended to be modified.

Configuration:
     Source code file path: /home/advisor/project
     Log level: info
     Report type: all
     Timeout interval setting: The timeout period is not set.

Summary:
      1 dependency files can be accelerated.

For the detailed information, please check:
    /home/output/affi-check_20250408114551_565e.json
    /home/output/affi-check_20250408114551_565e.html
    /home/output/affi-check_20250408114551_565e.csv

输出报告说明

表2 构建亲和输出报告参数说明
参数	说明
配置信息	显示软件源码文件存放路径。
需要修改的源码文件	显示存在构建亲和问题，并需要进行修改的源码文件路径等相关信息。

父主题： 亲和分析