Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Code Coverage with Emma"
m (Equinox - Code Coverage with Emma moved to Code Coverage with Emma: Not an Equinox-specific page.) |
|||
| Line 10: | Line 10: | ||
* Create a new Ant launch configuration called <i>Emma Instrumentation</i> and select the <code>instr</code> target. | * Create a new Ant launch configuration called <i>Emma Instrumentation</i> and select the <code>instr</code> target. | ||
* Run the <i>Emma Instrumentation</i> launch configuration. This will instrument the class files in your output directory. | * Run the <i>Emma Instrumentation</i> launch configuration. This will instrument the class files in your output directory. | ||
| − | * Run your test suites with the <code>-Demma.coverage.out.file=<output.dir>/coverage.ec</code> (fill in your output directory). | + | * Run your test suites with the following System property set: <code>-Demma.coverage.out.file=<output.dir>/coverage.ec</code> (fill in your output directory). |
* Create a new Ant launch configuration called <i>Emma Create Report</i> and select the <code>report</code> target. | * Create a new Ant launch configuration called <i>Emma Create Report</i> and select the <code>report</code> target. | ||
* Run the <i>Emma Create Report</i> launch configuration. This will generate a report in the output directory. Open the <code>index.html</code> file to start browsing the results. | * Run the <i>Emma Create Report</i> launch configuration. This will generate a report in the output directory. Open the <code>index.html</code> file to start browsing the results. | ||
| Line 90: | Line 90: | ||
[[Category:Equinox|Code Coverage]] | [[Category:Equinox|Code Coverage]] | ||
| + | [[Category:JDT]] | ||
Revision as of 15:28, 28 March 2007
Olivier from the JDT/Core team has been working on running the Emma code coverage tool on the JDT/Core test suites to get an idea of their coverage. Here are some steps to get the tool running in your workspace. (Olivier did most of the work... we just put it on the wiki :-)
Steps
- Download and extract latest Emma release.
- Put the contents of the
build.xmlfile below into a file in your workspace. - Edit the 3 properties at the top of the file.
-
project.dir- the root directory of the project that you are testing -
output.dir- the directory where you want your output to go -
emma.dir- your Emma installation directory
-
- Create a new Ant launch configuration called Emma Instrumentation and select the
instrtarget. - Run the Emma Instrumentation launch configuration. This will instrument the class files in your output directory.
- Run your test suites with the following System property set:
-Demma.coverage.out.file=<output.dir>/coverage.ec(fill in your output directory). - Create a new Ant launch configuration called Emma Create Report and select the
reporttarget. - Run the Emma Create Report launch configuration. This will generate a report in the output directory. Open the
index.htmlfile to start browsing the results.
Notes:
- Remember to clean your bin/ folder to remove instrumented class files.
- You may have to expand the
export-srcAnt call if you have multiple source folders in your project. - You will also have to make changes if you have multiple output folders in your project.
build.xml
These are the contents of the Ant build file that you will be running.
<?xml version="1.0" encoding="UTF-8"?>
<project name="emma" basedir="../../.">
<!-- What project are you testing? -->
<property name="project.dir" value="${basedir}/org.eclipse.core.jobs"/>
<!-- Where should we output the results?-->
<property name="output.dir" value="D:/temp/emma20070328"/>
<!-- Emma? Where are you? (Emma installation directory)-->
<property name='emma.dir' value='D:/downloads/emma-2.0.5312' />
<!------------------------------------------------------------->
<!-- Where are the class files? -->
<property name="bin" value="${project.dir}/bin"/>
<!-- EMMA distribution directory: -->
<path id='emma.lib' >
<fileset dir='${emma.dir}' includes='lib/*.jar' />
</path>
<taskdef resource='emma_ant.properties' classpathref='emma.lib' />
<!-- Target which instruments the class files -->
<target name="instr">
<mkdir dir="${output.dir}"/>
<emma>
<!-- instrumentation of bin folder -->
<instr instrpath="${bin}" mode="overwrite" outfile="${output.dir}/coverage.em"/>
</emma>
<!-- copy the emma classes into the bin folder -->
<unjar dest="${bin}" src="${emma.dir}/lib/emma.jar" overwrite="true"/>
</target>
<!-- This target copies your source files so they can be used for generation of
the reports later. -->
<property name="src.dir" value="${output.dir}/src" />
<target name="export-src">
<antcall target="cleanup"/>
<mkdir dir="${src.dir}" />
<copy todir="${src.dir}">
<fileset dir="${project.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
</target>
<!-- Generate the report. -->
<target name="report">
<antcall target="export-src"/>
<emma>
<!-- creating a report -->
<report sort="+name,+class,+method,+block" sourcepath="${src.dir}">
<infileset dir="${output.dir}" includes="*.em, *.ec"/>
<html outfile="${output.dir}/index.html" depth="method" columns="name,class,method,block,line"/>
</report>
</emma>
</target>
<target name="cleanup">
<delete dir="${src.dir}" failonerror="false"/>
</target>
</project>