Как настроить задачу Ant для генерации Emma отчетов о покрытии кода?
Как мне генерировать отчеты о покрытии кода Emma с помощью Ant?
Ответ 1
Чтобы ответить на вопросы о том, где находятся исходные и инструментальные каталоги (их можно переключить на любую вашу стандартную структуру каталогов):
<property file="build.properties" />
<property name="source" location="src/main/java" />
<property name="test.source" location="src/test/java" />
<property name="target.dir" location="target" />
<property name="target" location="${target.dir}/classes" />
<property name="test.target" location="${target.dir}/test-classes" />
<property name="instr.target" location="${target.dir}/instr-classes" />
путь к классам:
<path id="compile.classpath">
<fileset dir="lib/main">
<include name="*.jar" />
</fileset>
</path>
<path id="test.compile.classpath">
<path refid="compile.classpath" />
<pathelement location="lib/test/junit-4.6.jar" />
<pathelement location="${target}" />
</path>
<path id="junit.classpath">
<path refid="test.compile.classpath" />
<pathelement location="${test.target}" />
</path>
Сначала вам нужно настроить, где Ant может найти библиотеки Emma:
<path id="emma.lib" >
<pathelement location="${emma.dir}/emma.jar" />
<pathelement location="${emma.dir}/emma_ant.jar" />
</path>
Затем импортируйте задачу:
<taskdef resource="emma_ant.properties" classpathref="emma.lib" />
Затем введите код:
<target name="coverage.instrumentation">
<mkdir dir="${instr.target}"/>
<mkdir dir="${coverage}"/>
<emma>
<instr instrpath="${target}" destdir="${instr.target}" metadatafile="${coverage}/metadata.emma" mode="copy">
<filter excludes="*Test*"/>
</instr>
</emma>
<!-- Update the that will run the instrumented code -->
<path id="test.classpath">
<pathelement location="${instr.target}"/>
<path refid="junit.classpath"/>
<pathelement location="${emma.dir}/emma.jar"/>
</path>
</target>
Затем запустите цель с соответствующими аргументами VM, например:
<jvmarg value="-Demma.coverage.out.file=${coverage}/coverage.emma" />
<jvmarg value="-Demma.coverage.out.merge=true" />
Наконец, сгенерируйте отчет:
<target name="coverage.report" depends="coverage.instrumentation">
<emma>
<report sourcepath="${source}" depth="method">
<fileset dir="${coverage}" >
<include name="*.emma" />
</fileset>
<html outfile="${coverage}/coverage.html" />
</report>
</emma>
</target>
Ответ 2
В В руководстве пользователя есть хороший пример настройки вашей сборки script, чтобы вы не только отделили инструментальный код от выполнение, но также и все, содержащиеся в одном и том же <target>
, так что вам не нужно запускать ряд разных целей, но вместо этого вы можете просто сделать что-то вроде ant emma tests
(если ant tests
было тем, как вы обычно запускались например, ваши юнит-тесты).
Вот их пример:
<target name="emma" description="turns on EMMA instrumentation/reporting" >
<property name="emma.enabled" value="true" />
<!-- EMMA instr class output directory: -->
<property name="out.instr.dir" value="${basedir}/outinstr" />
<mkdir dir="${out.instr.dir}" />
</target>
<target name="run" depends="init, compile" description="runs the examples" >
<emma enabled="${emma.enabled}" >
<instr instrpathref="run.classpath"
destdir="${out.instr.dir}"
metadatafile="${coverage.dir}/metadata.emma"
merge="true"
/>
</emma>
<!-- note from matt b: you could just as easily have a <junit> task here! -->
<java classname="Main" fork="true" >
<classpath>
<pathelement location="${out.instr.dir}" />
<path refid="run.classpath" />
<path refid="emma.lib" />
</classpath>
<jvmarg value="-Demma.coverage.out.file=${coverage.dir}/coverage.emma" />
<jvmarg value="-Demma.coverage.out.merge=true" />
</java>
<emma enabled="${emma.enabled}" >
<report sourcepath="${src.dir}" >
<fileset dir="${coverage.dir}" >
<include name="*.emma" />
</fileset>
<txt outfile="${coverage.dir}/coverage.txt" />
<html outfile="${coverage.dir}/coverage.html" />
</report>
</emma>
</target>
Ответ 3
Emma 2.1 вводит другой способ получения информации о покрытии времени выполнения (файл .ec). Можно удаленно запрашивать данные из данного порта компьютера, на котором запущено инструментальное приложение. Поэтому нет необходимости останавливать VM.
Чтобы получить файл с данными покрытия времени выполнения, вам необходимо вставить следующий фрагмент в Ant script между запуском ваших тестов и созданием отчета о покрытии:
<emma>
<ctl connect="${emma.rt.host}:${emma.rt.port}" >
<command name="coverage.get" args="${emma.ec.file}" />
<command name="coverage.reset" />
</ctl>
</emma>
Другие шаги аналогичны Emma 2.0. Они отлично описаны в предыдущем сообщении
Дополнительная информация о функциях Emma 2.1: http://sourceforge.net/project/shownotes.php?group_id=108932&release_id=336859