前言
OCLint是静态代码检查工具，用于检查代码质量
环境部署
网上太多类似教程，可参考OCLint在Xcode中的使用OCLint 实现 Code Review - 给你的代码提提质量
脚本
#!/bin/bash -il source ~/.bashrc myworkspace=OCLintProject.xcworkspace #填写workspace myscheme=OCLintProject #填写Target reportType=html #输出类型 reportFile=oclintReport.html #输出文件名 # clean cache # 清除上次编译数据 if [ -d ./compile_commands.json ]; then echo '-----清除上次编译数据-----' rm compile_commands.json; rm $reportFile; fi # clean -- build -- OCLint analyse echo '-----开始生成编译数据-----'; xcodebuild -workspace $myworkspace -scheme $myscheme clean&& xcodebuild -workspace $myworkspace -scheme $myscheme \ -configuration Debug -sdk iphoneos \ CLANG_ENABLE_MODULE_DEBUGGING=NO CODE_SIGNING_REQUIRED=NO ENABLE_BITCODE=NO COMPILER_INDEX_STORE_ENABLE=NO \ | xcpretty -r json-compilation-database -o compile_commands.json if [ -f ./compile_commands.json ] then echo '-----编译数据生成完毕-----' else echo "-----生成编译数据失败-----" return -1 fi oclint-json-compilation-database -e Pods -e QMUI -e Libraries -- \ -report-type $reportType \ -o $reportFile \ -rc LONG_LINE=300 \ -rc LONG_METHOD=200 \ -rc LONG_VARIABLE_NAME=40 \ -rc LONG_CLASS=3000 \ -max-priority-1=10000 \ -max-priority-2=30000 \ -max-priority-3=50000 \ if [ -f ./$reportFile ] then echo '-----分析完毕-----' else echo '-----分析失败-----' fi
- 首先需要用xcodebuild clean和build项目，并且添加COMPILER_INDEX_STORE_ENABLE=NO参数，不然可能会出现报错：oclint: error: one compiler command contains multiple jobs报错
xcodebuild -workspace $myworkspace -scheme $myscheme clean&&xcodebuild -workspace $myworkspace -scheme $myscheme
- 调用xcpretty命令分析日志信息。xcpretty是用来格式化xcodebuild输出的工具。
xcpretty -r json-compilation-database -o compile_commands.json
- 用oclint-json-compilation-database命令分析代码
- -e 需要忽略分析的文件，这些文件的警告不会出现在报告中
- -rc 需要覆盖的规则的阀值，这里可以自定义项目的阀值，默认阀值
- -enable-rule 支持的规则，默认是oclint提供的都支持，可以组合-disable-rule来过滤掉一些规则规则列表
- -disable-rule 需要忽略的规则，根据项目需求设置
- -report-type 分析的报告的类型，支持[text、html、xml、json、pmd]，差异可见对应Sample； 一般会选择可读性好的html或者pmd；这里我们选取
pmd类型，用于结合PMD analysis生成PMD warnings，能比较友好的在Jenkins的看板中展示出来。
- 分析规则
| 名称 | 描述 | 默认阈值 |
| CYCLOMATIC_COMPLEXITY | 方法的循环复杂性（圈负责度） | 10 |
| LONG_CLASS | C类或Objective-C接口，类别，协议和实现的行数 | 1000 |
| LONG_LINE | 一行代码的字符数 | 100 |
| LONG_METHOD | 方法或函数的行数 | 50 |
| LONG_VARIABLE_NAME | 变量名称的字符数 | 20 |
| MAXIMUM_IF_LENGTH | if语句的行数 | 15 |
| MINIMUM_CASES_IN_SWITCH | switch语句中的case数 | 3 |
| NPATH_COMPLEXITY | 方法的NPath复杂性 | 200 |
| NCSS_METHOD | 一个没有注释的方法语句数 | 30 |
| NESTED_BLOCK_DEPTH | 块或复合语句的深度 | 5 |
| SHORT_VARIABLE_NAME | 变量名称的字符数 | 3 |
| TOO_MANY_FIELDS | 类的字段数 | 20 |
| TOO_MANY_METHODS | 类的方法数 | 30 |
| TOO_MANY_PARAMETERS | 方法的参数数 | 10 |
| 更详细的默认规则可到这里查看 |
- 分析结果:
网络异常，图片无法展示
|
