在Eclipse中使用测试覆盖率工具Clover.docx

1、在Eclipse中使用测试覆盖率工具CloverClover 分析和使用报告2003-12-9作者：丰伟目录1 前言 31.1 本文档的目的与背景 31.2 适用范围（读者） 31.3 Clover简介 32 使用方法 42.1 安装Clover Eclipse Plugin (版本 1.1.3 ) 42.1.1 介绍 42.1.2 注意事项 42.1.3 安装 Eclipse Plugin 52.2 如何在你的Eclipse项目中使用Clover Plugin 52.3 查看和分析Clover数据 82.4 配置选项 103 分析 133.1 培训时间成本 133.2 使用成本 133.3

2、对原开发过程的影响 134 建议 131 前言1.1 本文档的目的与背景针对日方提出：如何解决测试的覆盖率问题？对Clover进行使用研究。1.2 适用范围（读者）PG，Test Team，集成人员1.3 Clover简介Clover 是商业工具，但它可以免费用于开放源码项目。Clover 是一个测试代码覆盖率分析工具, 在软件测试过程中,他帮助查找有哪些没有被充分执行的方法、语句和判断条件，Clover 会把覆盖率分析结果以HTML、PDF等格式进行报告。Clover 分两阶段进行工作。首先，它在编译时向代码中插入Clover执行记录语句。然后，在测试时Clover执行记录语句会将有关测试的

3、运行路径信息写到用来生成报告的分析数据库中。分析数据库是一个你可以指定其位置的一个文件。Clover对许多开发工具提供集成的Plugin，下面的我会讲述如何在我们使用的开发环境Eclipse中使用Clover。当然，我们也可以使用Clover提供的Ant特性在集成测试下使用Clover，Clover的用户手册中对Ant任务有详细的描述，我们会在集成测试时提供一个Ant文件。2 使用方法2.1 安装Clover Eclipse Plugin (版本 1.1.3 )注意: 这个plugin可以在Eclipse 2.1, 2.1.1, 2.1.2 和 3.0M4上使用; 用于 JDKs 1.3.x

4、和 1.4.x. 2.1.1 介绍这个Clover Eclipse Plugin 让你可以在Eclipse IDE中检查测试覆盖率，分析结果及察看那些方法、语句和判断条件没有得到充分执行 。2.1.2 注意事项 如果你的Eclipse 项目的source路径与class输出路径相同,Clover将运行错误. 2.1.3 安装 Eclipse Plugin如果你的Eclipse是打开的,请关闭它.你需要知道你的Eclipse 安装路径,我们以后称呼他为ECLIPSE_HOME. 解压我们提供的clover-eclipse_1._1_3.zip 文件, 你将看到一个目录为 com.cortexeb

5、.tools.clover_x.x 拷贝com.cortexeb.tools.clover_x.x 目录到ECLIPSE_HOME/plugins 目录下. 你应该看到下面目录结构ECLIPSE_HOME/plugins/com.cortexeb.tools.clover_x.x 运行Eclipse, 你的Clover plugin 安装完毕. 2.2 如何在你的Eclipse项目中使用Clover Plugin2.2.1.1 启动 Clover Eclipse plugin在 Eclipse 项目中,请打开Java (JDT) 透视图. 使用菜单 Project | Properties 或

6、者右键点击Package 浏览器中的项目名称. 选择 Clover 页面. 选择Enable Clover plugin in the project. 选择OK, Clover工具窗将会出现在你的workbench中. 2.2.1.2 Clover工具窗Clover工具窗让你控制是否在你的项目中使用Clover, 是否显示一个项目/包/类的测试覆盖率. 在Clover工具窗中右键选择你想使用Clover进行覆盖率分析的项目，选择Compile with Clover.如果你关闭了Clover工具窗,你能使用菜单Window | Show View | Other. 和选择 Clover |

7、Clover View 去再次打开他. Clover工具窗的title上有下列工具图标: Show coverage. 如果你希望在编辑器和任务列表中标记未被测试覆盖的代码，选择它。 Refresh Coverage Data. 重新从Clover数据库中装载覆盖率数据。 Delete Coverage Data.从Clover数据库中清除覆盖率数据。 Compile with Clover. 如果你希望在项目中使用Clover. ，选择它。 Context Filter. 让你指定不希望被Clover分析的代码段，如try,static,syn等等。 Use Clover WorkingSe

8、t. 如果你选择了它, Clover 只对你在WorkingSet 定义的项目/包/类进行覆盖率统计. Edit WorkingSet. WorkingSet 定义了你希望Clover 进行分析的项目/目/包/类. Clear WorkingSet. 清空WorkingSet. 2.3 查看和分析Clover数据Clover Eclipse plugin 使你能够在Eclipse IDE中察看Clover分析结果. 它指定那些方法和语句没有被测试覆盖. 你需要选择Clover工具窗的Show coverage功能，你将要在java编辑器的左边和右边看到指出覆盖问题的tooltip。如果你想在把

9、让Clover在Eclipse的任务列表中以警告的方式指出覆盖问题,你可以点击任务列表视图的Titles上的filter功能,并选择Clover coverage. 注意任务列表仅仅对打开的文件以警告的方式指出覆盖问题. 2.4 配置选项我们可以对Clover Eclipse plugins 在两个地方进行配置，第一种方法，通过 (Project | Properties)菜单, 另一种方法，通过(Window | Preferences)菜单. 2.4.1.1 Project Properties - Instrumentation配置当Compile with Clover 被选择时所使用

10、的一些选项. Initstring 定义Clover 放置分析数据库的位置,你可以选择User specified自定义数据库的位置. Flush Policy 定义了Clover什么时候把分析结果写到分析数据库中, Directed 定义了产生的分析数据会被直接写到数据库中, Interval则让你定义每隔固定时间Clover输出分析数据到数据库中 Filtering Includes/Excludes 你可以使用ant匹配语法定义Clover可以对和不对那些文件进行覆盖率分析,例如,如果你不希望对remote 包的所有文件进行覆盖率分析,你可以在Excludes 中输入*/remote/*

11、.java. Filtering UseClass Includes/Excludes Clover可以把它向你的文件中加入的代码以内部类的方式实现,你可以选择对那些文件应用这种新的分析实现. 2.4.1.2 Project Properties - Compilation Options用于指定是否启动一个新的JVM对需要分析的文件进行编译. Heap size of compiler JVM 用于指定新的JVM所需要的堆内存2.4.1.3 Clover PreferencesDeleting existing coverage data each rebuild当你重建你的项目时, Clo

12、ver 会要你确认是否删除再分析数据库里的存在的数据, 你可以在这里定义当你重建你的项目时缺省的行为和是否向你发出确认信息. Automatically refresh coverage data 如果你选择这个选项,那么plugin 将自动在你在frequency 里给出的时间间隔内刷新分析结果,否则,你将要使用Clover工具窗的Refresh Coverge Data 按钮去获得最新的分析结果. Span 用于告诉Clover在刷新时读取多长时间的分析数据. 3 分析3.1 培训时间成本需要培训30分钟3.2 使用成本使用Clover会导致编译代码的时间延长,但在整个项目的比重可以忽略不计.3.3 对原开发过程的影响我们使用分析结果来确定测试套件对程序功能的覆盖范围到底怎么样. 不仅能够防止代码在通过所有测试之前被提交，而且可以防止代码在未经测试的情况下提交！ 4 建议Clover是一个使用方便,功能全面的单体测试覆盖率分析工具, 可以防止懒惰或考虑不周全所导致的测试覆盖范围偏小，因此，此类强制措施对任何技能级别的程序员都有用。