Starting Points

If you are new to Clover and want to get it going with your Ant project quickly, try the Quickstart Guide. The Introduction for Code Coverage section provides a brief background on the theory and motivation behind Code Coverage.

If you are browsing and interested in seeing how Clover can be used on your project, see Using Clover Interactively and Using Clover in Automated builds.

If you are using a Clover IDE Plugin, see the Plugin Guides section.

The Clover Tutorial provides a good alternative introduction to Clover.

For help with Ant, see The online Ant manual at http://ant.apache.org/manual/index.html.

For Clover troubleshooting information, see the FAQ or Online Forums.

System Requirements

JDK Version	JDK 1.2 or greater required to perform instrumented compilation and coverage measurement. JDK 1.3 or greater required to produce coverage reports.
Ant Version	Ant 1.4.1 or greater.
Operating System	Clover is a pure Java application and should run on any platform provided the above requirements are satisfied.

The Clover IDE Plugins document their own IDE version requirements. Please consult the Plugins Section

Installing your license file

You need a valid Clover license file to run Clover. You can obtain a free 30 day evaluation license or purchase a commercial license at http://www.cenqua.com.

To install your Clover license file, you need to do one of the following:

Place the license file next to the Clover jar file (or next to the Clover plugin jar file, if you are running a Clover IDE plugin).
Place the license file on the Java Classpath that will be used to run Clover.
Place the license file on the file system somewhere, and then set the Java System Property clover.license.path to the absolute path of the license file.

Acknowledgements

Clover makes use of the following excellent 3rd party libraries.

Jakarta Velocity 1.2	Templating engine used for Html report generation.
Antlr 2.7.1	A public domain parser generator.
iText 0.96	Library for generating PDF documents.
Jakarta Ant	The Ant build system.

Note

To prevent library version mismatches, all of these libraries have been obfuscated and/or repackaged and included in the clover jar. We do this to prevent pain for users that may use different versions of these libraries in their projects.