如何调试OCLint自定义规则

oclint自定义规则的编写,一般我们会生成xcode工程,然后进行编码,build之后会输出dylib。如果我们要验证规则的正确性,只能把dylib拷贝到rules的目录中,然后在进行测试。这样实在是很麻烦,也只能通过log来输出信息,然而clang的方法那么多,单靠log方式也不便于调试。于是在想如何在XCode中进行调试。但搜了很多方法,一直没成功。

这里有一个方案:OCLint自定义规则的调试方法,但是不知道他的oclintexe是怎么写的,我自己尝试新建Command Line Tool的工程,然后用NSTask调起oclint的命令,还是没能断点到,可能是我的实现有问题。

后来又发现了一个答案,How to launch OCLint in xcode with debug model.,也是讨论如何在xcode中进行调试的。一开始没明白答案中步骤的意思,一直无果,突然有一天开窍了。
used the cmake tool, create xcode project with each module,看到了each module。然后就想到,在创建rule的时候,不也是通过以下cmake命令生成的xcode工程,LLVM_ROOT指向的是oclint-rules。

#! /bin/sh -e

cmake -G Xcode \
    -D CMAKE_CXX_COMPILER=../build/llvm-install/bin/clang++  \
    -D CMAKE_C_COMPILER=../build/llvm-install/bin/clang \
    -D OCLINT_BUILD_DIR=../build/oclint-core \
    -D OCLINT_SOURCE_DIR=../oclint-core \
    -D OCLINT_METRICS_SOURCE_DIR=../oclint-metrics \
    -D OCLINT_METRICS_BUILD_DIR=../build/oclint-metrics \
    -D LLVM_ROOT=../build/llvm-install/ ../oclint-rules

后来发现oclint目录下还有好几个文件夹,oclint-core,oclint-driver,oclint-metrics,oclint-reporters,countly等,是都可以生成xcode工程的。然后,按照步骤,一个个生成了xcode工程,然后进行编译。发现oclint-driver这个工程是可以直接跑起oclint的,大喜。

不过最终也不需要答案中的那么复杂,只需要生成oclint-driver的xcode工程编译即可。

下面来具体说下调试的步骤。

调试步骤

如果有不清楚oclint如何编写自定义规则的,请看这里:Code Review-OCLint系列开篇

写的比较详细,一步步操作下来就好。不过在编译源码之前,需要安装好所需的环境。两个命令就好。

brew install subversion git cmake lcov openssl
brew install ninja

(1) 首先生成oclint-xcoderules的xcode工程。按上面的教程来。
(2) 生成oclint-driver的xcode工程,只需把脚本改成LLVM_ROOT = oclint_drivers的目录。

cd oclint
mkdir oclint-xcodedriver
cd oclint-xcodedriver
touch create.sh
chmod +x create.sh

create.sh脚本内容如下:

#! /bin/sh -e

cmake -G Xcode \
    -D CMAKE_CXX_COMPILER=../build/llvm-install/bin/clang++  \
    -D CMAKE_C_COMPILER=../build/llvm-install/bin/clang \
    -D OCLINT_BUILD_DIR=../build/oclint-core \
    -D OCLINT_SOURCE_DIR=../oclint-core \
    -D OCLINT_METRICS_SOURCE_DIR=../oclint-metrics \
    -D OCLINT_METRICS_BUILD_DIR=../build/oclint-metrics \
    -D LLVM_ROOT=../build/llvm-install/ ../oclint_drivers

最后执行./create.sh,即可生成oclint-driver的xcode工程。

(3)但是在xcode中编译oclint-driver的时候,我这边出现了报错问题。如果你也碰到同样的问题,可以这样解决。

  • 在编译OCLintDriver.a库的时候,报错。<countly/Countly.h>找不到。是因为Header Search Paths没配置countly头文件的路径。

    切到OCLintDriver target的build settings--->Header Search Paths,添加/Users/liusilan/Documents/workspace/my/opensource/oclint/countly/include,这里改成自己的路径。

  • 在编译oclint-0.13的target时,出现-lcountly找不到的情况。这是因为Library path没有配置countly的路径。

    同样在build settings->Library Search Paths,添加lib路径。/Users/liusilan/Documents/workspace/my/opensource/oclint/build/countly/lib,这里改成自己的路径。

    然后build,就可以成功的跑起oclint了。

(4) 由于我们需要调试自定义规则,就需要在刚能跑起来的oclint中调起规则,oclint有个参数-R,表示rule所在文件夹路径。通过Arguments Passed On Lanunch的方式,可以添加参数。

自定义rule的dylib的输出路径是

/Users/liusilan/Documents/workspace/my/opensource/oclint/oclint-xcoderules/rules.dl/Debug

把这个参数传进去就可以。然后再添加需要检查的文件,输出格式,系统头文件路径等。

QQ20171209-1.png

总的参数如下:

-R=/Users/liusilan/Documents/workspace/my/opensource/oclint/oclint-xcoderules/rules.dl/Debug -report-type html -o /Users/liusilan/Documents/workspace/my/demo/Demo/reporter.html /Users/liusilan/Documents/workspace/my/demo/Demo/Demo/Test.m -- -x objective-c -isystem /Users/liusilan/Documents/workspace/my/opensource/oclint/build/oclint-release/lib/clang/5.0.0/include -iframework /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator.sdk/System/Library/Frameworks -isystem /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator.sdk/usr/include

注意:如果出现'stdarg.h' file not found的报错,则需要添加clang的头文件路径。

-isystem /Users/liusilan/Documents/workspace/my/opensource/oclint/build/oclint-release/lib/clang/5.0.0/include

(5)按照这种方式的话,需要把自定义的规则先生成好。但每次改动了,都要去oclint-rule的工程中去跑一遍,稍显麻烦。可以直接把oclint-rule的xcode工程作为oclint-driver的子工程,然后设置target依赖于你要调试的rule的target即可。这样,在跑oclint的时候,就会先编译好自定义的规则了。


QQ20171209-2.png

(6)一切都配置好之后,在自定义规则里打好断点,run起来,又出现了一个问题😯,cannot find dynamic library for report type:html。在工程中搜索了下,发现是在目录下找不到对应的libray。于是,断点在这。看reportDirPath是指向的哪个路径。

QQ20171209-3.png

结果是

"/Users/liusilan/Documents/workspace/my/opensource/oclint/oclint-xcode-driver/bin/Debug/../lib/oclint/reporters"

的确这个路径下是没有libHTMLReporter.dylib,为了方便,索性直接将整个reporters
/Users/liusilan/Documents/workspace/my/opensource/oclint/build/oclint-reporters/reporters.dl拷贝到了上面的路径。

最后,一切都顺利了,成功调试。


QQ20171209-4.png
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,460评论 25 707
  • 因为要结局swift3.0中引用snapKit的问题,看到一篇介绍Xcode8,swift3变化的文章,觉得很详细...
    uniapp阅读 4,385评论 0 12
  • 总有一些美好,是不会随着时间而被忘记的。——佚名 每年都有这样的日子,感觉自己成熟了,长大了,也是老了。 这一年真...
    夜神灭阅读 170评论 0 0
  • 运筹于手掌之间,那些筒子、条子、万子,张张都充满了未知。 这是四个人的游戏,乐此不疲地将那座方城...
    樱子四妹阅读 430评论 7 3
  • 10月的太原秋意盎然,几场秋雨过后,天气愈加寒冷。但太原的众多城市建设却如火如荼的进行着收尾工作,漪汾街下月竣工通...
    非常努力阅读 491评论 0 0