NOTE: The Maven EMMA Plugin invokes the EMMA Ant tasks, and exposes the corresponding attributes as plugin properties. Refer to EMMA Documentation for detailed documentation and examples of corresponding properties.

Maven Emma plugin properties

PropertyOptional?DescriptionDefault
maven.emma.redirect Yes Indicates whether the maven.build.dest and maven.test.dest (if maven.emma.instrument.tests=true) properties will be redirected to ${maven.emma.destdir}/classes while Emma is enabled. This will prevent accidental deployment of Emma-instrumented classes in a deliverable. This is accomplished by redefining maven.build.dest and maven.test.dest to maven.emma.destdir.classes when emma:on is called, and setting them back to the original value when emma:off is called. true
maven.emma.destdir Yes If maven.emma.redirect = true, then maven will compile all classes to ${maven.emma.destdir}/classes. If maven.emma.mode is not set to overwrite, this will be used by the instr task to indicate the location to store instrumented classes. If maven.emma.mode = overwrite (which is the default), the destdir property will be ignored by the instr task. true
maven.emma.mode Yes The Emma instrumentation output mode. It is recommended that the default of "overwrite" be used, but it is exposed for maximum flexibility. If you override it, make sure that you understand how Maven, Emma, and this plugin work, and that you know what you are doing. overwrite
maven.emma.instrument.tests Yes Decides whether to instrument test classes. false
maven.emma.report.html Yes Decides whether an HTML report will be generated. true
maven.emma.report.html.outfile Yes Determines location for the generated HTML output report. ${maven.docs.dest}/coverage/index.html
maven.emma.report.xml Yes Decides whether an XML report will be generated. false
maven.emma.report.xml.outfile Yes Determines location for the generated XML output report. ${maven.build.dir}/coverage.xml
maven.emma.report.txt Yes Decides whether a Text report will be generated. false
maven.emma.report.txt.outfile Yes Determines location for the generated text output report. ${maven.build.dir}/coverage.txt
maven.emma.working.dir Yes Working directory to store files generated and/or instrumented by the Emma plugin. ${maven.build.dir}/emma
maven.emma.data.dir Yes Directory in which instrumentation and coverage data files will be generated by Emma. ${maven.emma.working.dir}/data
maven.emma.metadata.out.file Yes Specifies the location of the Emma class instrumentation metadata file. ${maven.emma.data.dir}/coverage.em
maven.emma.coverage.out.file Yes Specifies the location of the Emma runtime coverage data file. ${maven.emma.data.dir}/coverage.ec
maven.emma.merge Yes Indicates whether the metadata should be merged into the destination metadatafile. true
maven.emma.jar Yes Allows the user to override the core emma.jar.
maven.emma_ant.jar Yes Allows the user to override the ant tasks emma_ant.jar.
maven.emma.execute.during.report Yes Controls whether or not the emma-report goal builds Emmaify the sources and execute the tests. true
maven.emma.filter.value Yes Specifies a list of inclusion/exclusion patterns. Example: +com.foo.*, -com.foo.test.*, -com.foo.*Test*. N/A
maven.emma.filter.includes Yes Specifies a list of patterns, separated with white space and/or commas. Example: com.foo.*. N/A
maven.emma.filter.excludes Yes Specifies a list of patterns, separated with white space and/or commas. Example: com.foo.test.*, com.foo.*Test*. N/A
maven.emma.filter.file Yes Specifies a list of patterns to be loaded from a file with a given name. Example: myfilters.txt. N/A
maven.emma.report.relativedir Yes Specifies the name of the directory (relative to the xdocs dir) where the reports will generated. Example: emma. coverage