Jenkins中集成Gcov代碼覆蓋率報告


最近終於把gcov代碼覆蓋報告集成到jenkins中了,總算是完成工作,寫篇博客總結下。

我循序漸進地用了三個工具:gcov, lcov, gcovr

這三個工具原理(其實gcovr依賴於GNU的gcov的)都是收集你程序run之后所產生的*.gcda文件,總的來說,我個人覺得比較喜歡lcov,應為lcov的報告讀起來很不錯,可惜它不能集成到Jenkins。。。

從頭說起。。。

一開始我用的是GNU tool gcov,網上學習了下gcov,生成了xx.cpp.gcov報告,然后就可以查看了,gcov給我的感覺是比較基礎,最大的缺點是不能統計所有代碼的覆蓋信息(我是用cmake,有可能我的CMakeLists.txt中有好多target,比如,我寫了個CMakeLists.txt,這個文件中產生2個目標,一個叫hello_world,一個叫goodbye_world,這個hello_world里有2個源文件,然后這個goodbye_world里假設也有兩個文件,但是我想查看總的代碼覆蓋情況,也就是兩個目標run之后4個源文件的代碼覆蓋情況),而且生成的報告不是那么human-readable。

隨后,又開始研究,找到了一個叫lcov前端工具,將lcov和genhtml連起來用確實生成的HTML報告讀起來很棒,行覆蓋率、分支什么的都有,而且又能收集多個目標執行后的代碼覆蓋率,但是lcov生成的報告不能被Jenkins追蹤,也沒有覆蓋率趨勢。

於是,又再次研究,用Google搜到篇老外的文章,http://www.semipol.de/archives/320,里面講了用gcovr可以生成xml文件,這個xml文件是可以被Cobertura讀取解析,而這個Cobertura是Jenkins的一個現有java統計覆蓋率的插件,這下就找到方向了!

有了方向,我就開始做了,首先:在Jenkins上找到了Cobertura這個插件並安裝,然后,配置下你的編譯,我是直接執行了shell腳本,就是Jenkins的構建的Execute shell,比如,sh mybuild.sh,緊接着,在你的Jenkins工程中增加post-build action,見下圖,讓這個插件去讀這個coverage.xml文件,接下來就是怎么生成這個coverage.xml文件了。

隨后,我在網上下了個gcovr,是用gcovr -x -r "source_dir" --output "output_dir/coverage.xml"生成了上面插件需要的coverage.xml文件,你可以把它寫到上面的mybuild.sh中,其實mybuild.sh肯定還有其他shell命令,比如先運行你的程序,進入目錄什么的。

ok,如果編譯沒什么錯誤的話,最后你就能在Jenkins中看到gcov的報告了。

 至此,Jenkins集成Gcov報告就結束了,如果你用的是cmake的話,我強烈推薦下老外寫的CMake腳本,這些腳本很強大,可以集成到你的CMakeLists.txt中,使你不需要去寫gcovr -x -r "source_dir".....這些命令了,因為老外直接寫好了,額,open source就是強大啊!

Cmake coverage 腳本:https://code.cor-lab.de/projects/rsc/repository/revisions/master/entry/cmake/Modules/EnableCoverageReport.cmake

相關解析腳本: https://code.cor-lab.de/projects/rsc/repository/revisions/master/entry/cmake/Modules/ParseArguments.cmake

找lcov腳本: https://code.cor-lab.de/projects/rsc/repository/revisions/master/entry/cmake/Modules/FindLcov.cmake

找gcovr腳本:https://code.cor-lab.de/projects/rsc/repository/revisions/master/entry/cmake/Modules/Findgcovr.cmake

gcovr下載地址:https://pypi.python.org/pypi/gcovr/   解壓后,使用scripts/gcovr就可以了

下載完上述4個腳本和gcovr工具后,你就可以在你的CMakelists.txt中加入了,具體我不解釋了,自行查看,下面示范怎么使用:


set(CMAKE_MODULE_PATH "helloworld/cmake/modules" ${CMAKE_MODULE_PATH})  #我把這些腳本放到cmake/modlues目錄下

include(ConfigureCodeCoverage)

if(CODE_COVERAGE)
ENABLE_COVERAGE_REPORT(FILTER "/usr/include/*;/usr/lib/*")
endif(CODE_COVERAGE)

編譯:

先運行 cmake --build . --use-stderr

然后運行 cmake --build . --use-stderr -- target Coverage

運行完畢后,你就可以看到locv和gcovr生成的報告了,因為老外已經講lcov,gcovr集成進EnableCoverageReport.cmake這個腳本中了。

 

一些鏈接:

Gcovr user guide: http://gcovr.com/guide.html#gettingStarted

 

 

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM