让XCode自动CodeReview你的代码-OCLint使用

前言

OCLint 是一个静态分析代码的工具，支持自定义规则，能够很好地帮助咱们规范代码，这篇文章主要介绍经过OCLint让XCode来帮你Code Review，规范代码。
OCLint相关的详细内容也能够到OCLint官网上查看。

安装OCLint 和 xcpretty

这里须要安装OCLint 和 xcpretty 工具

一、 安装xcpretty

用gem安装xcpretty

sudo gem install xcpretty复制代码

用sudo是防止一些权限出现问题

二、安装OCLint

安装OCLint有两种经常使用的方法：

1）经过安装包：

从oclint的github项目连接中下载安装包oclint-0.10.3-x86_64-darwin-15.5.0.tar.gz.
解压后在当前用户的.bashrc中配置环境变量

OCLINT_HOME=/pathexport PATH=$PATH:OCLINT_HOME/bin复制代码

而后source .bashrc便可

2）经过Homebrew

brew tap oclint/formulae
brew install oclint复制代码

3）确认安装成功

运行oclint确认环境配置正确

$ oclint复制代码

若是展现如下内容即为安装成功：

oclint: Not enough positional command line arguments specified!Must specify at least 1 positional arguments: See: oclint -help复制代码

OCLint 的使用

这里介绍一些简单经常使用的用法，足够应对不少场景，其余详细用法能够到OCLint Manual上查看。

OCLint 有三个指令： oclint、 oclint-json-compilation-database、 oclint-xcodebuild。

一、oclint：常规核心指令。
二、oclint-json-compilation-database：从编译好的compile_commands.json 文件中读取配置信息并执行 oclint。
三、oclint-xcodebuild：主要用于生成compile_commands.json文件，如今已经不进行维护了，咱们能够用xcpretty替代，来生成json文件。

oclint指令

使用语法

oclint [options] <source> -- [compiler flags]复制代码

[options]为一些参数选项，能够是规则加载选项、报告形式选项等：

一、 -R <路径> ： 检测所用的规则的路径，默认路径$(/path/to/bin/oclint)/../lib/oclint/rules
二、-disable-rule <规则名>： 让相对应的规则失效（OCLint 规则列表）。
三、-rc <参数>=<值> ：修改阈值
四、-report-type <报告类型>，有"text"、“html”、“json”、“pmd”、“xcode”几个类型
五、-o <路径> 报告生成路径。

eg:

oclint  -R  /path/to/rules   -disable-rule ObjCAssignIvarOutsideAccessors -report-type xcode复制代码

oclint-json-compilation-database 指令

这是咱们主要用到的指令，它是oclint 指令的升级版，使用起来相对 oclint 指令简单方便。
能够经过 -- 的方式在指令的最后加上oclint 选项。

oclint-json-compilation-database 指令有过滤文件选项
-i ：包含进某些文件
-e ： 过滤掉某些文件
eg:

# 排除Pods 里的文件
oclint-json-compilation-database -e Pods 
# 包含进Pods里的文件
oclint-json-compilation-database -i Pods复制代码

oclint-xcodebuild 指令。

由于oclint-xcodebuild 指令已经再也不维护，实际应用中用xcpretty代替，因此这里就不进行介绍。

其余命令工具：xcodebuild 和 xcpretty

xcodebuild

xcodebuild是苹果发布自动构建的工具，能够经过命令行脚本的方式编译、打包Xcode 工程。
能够在终端输入man xcodebuild来查询相关用法

xcpretty

用xcpretty生成OClint 解析用的json 文件
这里用xcpretty是由于oclint-xcodebuild再也不维护了，在XCode 8以后采用xcpretty来生成。

用XCode检测代码

首先在targets点添加按钮：

在Cross-platform选项中，选“Aggregate”,而后命名为"OCLint":

接着选中OCLint Target，进入Build Phases选项，点左上角的加号，选择“New Run Script Phase”

而后输入脚本便可：

示例脚本：

source ~/.bash_profile
cd ${SRCROOT}
xcodebuild clean
xcodebuild  -workspace demo.xcworkspace -scheme demo | xcpretty -r json-compilation-database --output compile_commands.json
oclint-json-compilation-database -v \
-e Pods \
-e MGLivenessDetection \
-e MGBaseKit \
-e MGIDCard \
oclint_args -- -report-type xcode \
-disable-rule ObjCAssignIvarOutsideAccessors \
-disable-rule ShortVariableName \
-rc=MINIMUM_CASES_IN_SWITCH=3 \
-rc=CYCLOMATIC_COMPLEXITY=10 \
-rc=LONG_CLASS=700 \
-rc=LONG_LINE=200 \
-rc=NCSS_METHOD=40 \
-rc=NESTED_BLOCK_DEPTH=5 \
-rc=TOO_MANY_FIELDS=20 \
-rc=TOO_MANY_METHODS=30 \
-rc=TOO_MANY_PARAMETERS=6
exit复制代码

接着选择OCLint Scheme，Command+B就能够执行了
在执行前最好删除drivedata里面的数据缓存，以保证不会解析到旧的编译内容。
编译成功后Xcode上会在不符合规则的代码上显示Warning:

参考连接：

iOS 工程自动化 - OCLint 使用详解
用OCLint给iOS代码作静态分析