嵌入式平台组件白盒测试gcov、lcov和genhtml 使用指导

在嵌入式平台上使用了gtest白盒测试工具，覆盖了被测函数，但是不知道自己测试的效果如何，测试行覆盖率、函数覆盖率，分支覆盖率的数据。

便开始研究gcov这个代码覆盖率工具能否使用，来检查白盒测试的效果，以及指引测试改进的方向。经过多次尝试和研究，

在嵌入式平台上可以使用gcov这个工具，不过操作稍微复杂点。

 

环境要求：

1、有被测组件的源代码

2、对应平台的交叉编译器必须包含gcov功能

3、安装好lcov工具

4、相应的嵌入式设备

 

使用gcov/lcov测试代码覆盖率，总共分为四步：

1、在组件编译中添加gcov编译参数，然后编译debug版本，同时生成gcno文件

2、在gtest编译中使用添加编译参数的组件

3、执行生成的程序，生成代码覆盖文件gcda

4、使用lcov工具解析gcno和gcda文件，生成html报表文件

 

下面详细说明四个步骤如何操作：

 

1、在组件编译中添加编译参数

我们测试的是组件，文件形式是静态库（.a）或者动态库（.so）。为了统计测试的代码覆盖率，我们需要在编译的时候添加如下参数。

需要添加的编译参数为：-fprofile-arcs -ftest-coverage；同时添加参数对应的库lgcov

 

添加完成后，进行编译。然后查找，找到生成的后缀名为gcno文件的话，则说明成功。

 

重要：gcno文件生成的路径，这个一般是根据Makefile脚本指定的不同路径来确定的，有的时候与源代码在一起，有的时候与中间文件在一起。

           但是不管gcno的路径在哪里，要记住这个路径。后续有用的。

 

2、在gtest编译中使用带gcov的组件

A、修改编译脚本，添加-lgcov 编译参数

B、把使用的库文件替换为添加gcov编译参数的组件

（如何在嵌入式平台中使用gtest，请参考 http://www.cnblogs.com/StitchSun/p/4430362.html）

3、执行gtest测试程序

   把编译好的测试程序在对应的设备上执行测试，执行没有错误后，然后查看嵌入式设备的目录，到与生成gcno路径一致的目录下，查找gcda文件

   gcda文件生成路径为编译时生成gcno的路径，不过gcno是在编译服务器上，gcda是在程序运行的嵌入式设备上。

 

4、使用lcov解析gcda和gcno文件

   把设备的gcda文件下载到编译服务器，同时把编译时生成的gcno文件也复制到同一个目录。

   对于前面名称相同的文件，gcda和gcno文件必须在同一目录下。    

 

   要使用lcov工具，可以在http://ltp.sourceforge.net/coverage/lcov.php 下载最新的版本。

   但是这个工具无法直接解析嵌入式平台产生的gcno和gcda格式的文件，需要修改一个地方。

   即这个工具默认的是使用linux系统自带的gcov，需要修改为使用交叉编译器的gcov工具。

   修改的文件为：bin/geninfo 的，把原来的gcov修改为交叉编译的gcov。

 

 

修改完成，保存退出。

以使用的isi3518 交叉编译器为例，执行下面的命令：

     a   /opt/lcov_test/hisi3518/lcov-1.9/bin/lcov -d . -t 'test' -o 'test.info' -b . -c

 

     b   /opt/lcov_test/hisi3518/lcov-1.9/bin/genhtml -o result test.info

       

        

      看到上面的提示，说明执行成功了。把result文件夹下载到windows上，打开里面的index，就可以看到结果了。

     

常见问题：

1、geninfo: ERROR: …: reached unexpected end of file

 注意，lcov 最好使用 1.9 及以上版本，否则可能遇到如下错误：

geninfo: ERROR: …: reached unexpected end of file

 

2、 gcov解决stamp mismatch with graph file

使用 hexdump -e '"%x\n"' -s8 -n4 命令分别解析 XXX.gcno和XXX.gcda文件

如果生成的码不一致，则说明gcno和gcda不是一次编译生成的，需要重新编译。

命令使用如下：

hexdump -e '"%x\n"' -s8 -n4 dns_shell.gcno 

 

3、找不到源代码

在解析gcno和gcda时，要和源代码在一个服务器上，并且源代码的路径在生成gcno和gcda后

没有变动过。不然会提示找不到源代码。

 

参考：

在研究中，下面的链接有很大的帮助。表示感谢。

http://blog.sina.com.cn/s/blog_7e4ac8b501018b27.html

 这个参考中的第三步  gcov产生报告信息： test.c.gcov  不用执行