5.5 Adding JUnit Report

Version 16 by Robin Shen
on Jun 23, 2008 18:53.

<< Changes from 15 to 16

compared with

Version 17 by Lubos Pochman
on Aug 28, 2008 20:30.
(show comment)

Changes from 17 to 18 >>

Key

These lines were removed. This word was removed.

These lines were added. This word was added.

View page history

There are 11 changes. View first change.

		To add [JUnit\|http://www.junit.org] report, only need two steps:
		# Generate JUnit XML report from [Ant\|http://ant.apache.org] or [Maven\|http://maven.apache.org] or any other build tools.
		To add [JUnit\|http://www.junit.org] report, you only need two steps:
		# Generate JUnit XML report from [Ant\|http://ant.apache.org] or [Maven\|http://maven.apache.org] or any other build tool.
		# Publish JUnit report in the [configuration\|1. Working with Configuration].

		h2. Generate JUnit Report
		QuickBuild will NOT generate [JUnit\|http://www.junit.org] report automatically, so first make sure the [JUnit\|http://www.junit.org] report is produced by [ANT\|http://ant.apache.org] or by any other build tools, the following example shows how to generate JUnit test results by [Ant JUnit task\|http://ant.apache.org/manual/OptionalTasks/junit.html]:

		QuickBuild will NOT generate [JUnit\|http://www.junit.org] report automatically, so first make sure the [JUnit\|http://www.junit.org] report is produced by [ANT\|http://ant.apache.org] or by any other build tool. The following example shows how to generate JUnit test results by [Ant JUnit task\|http://ant.apache.org/manual/OptionalTasks/junit.html]:
		{code:xml\|title=JUnit target in build.xml}
		<target name="junit">
		<junit printsummary="yes" haltonfailure="yes">
		<classpath>
		<pathelement location="${build.tests}"/>
		<pathelement path="${java.class.path}"/>
		</classpath>

		<formatter type="xml"/> <!-- DO use xml here -->

		<batchtest fork="yes" todir="reports/junit">
		<fileset dir="${src.tests}">
		<include name="*/Test*.java"/>
		<exclude name="**/AllTests.java"/>
		</fileset>
		</batchtest>
		</junit>
		</target>
		{code}

		The code snippet will generate the XML reports for each test case, and the reports will be captured to 'reports/junit' directory. You may also want to merge all the test case report by using [Ant JUnitReport task\|http://ant.apache.org/manual/OptionalTasks/junitreport.html] like:
		The code snippet will generate the XML reports for each test case, and the reports will be captured to 'reports/junit' directory. You may also want to merge all the test case reports by using [Ant JUnitReport task\|http://ant.apache.org/manual/OptionalTasks/junitreport.html] like:
		{code:xml\|title=JUnitReport task in build.xml}
		<target name="junit">
		<junit>
		<junit>
		... ...
		</junit>

		<junitreport todir="${outputdir}">
		<fileset dir="reports/junit">
		<include name="TEST-*.xml"/>
		</fileset>
		<report todir="${outputdir}/html"
		styledir="junitreport"
		format="frames">
		<param name="key1" expression="value1"/>
		<param name="key2" expression="value2"/>
		</report>
		</junitreport>
		</target>
		</target>
		{code}
		After adding the targets, you can generate the XML report(s) for your test results, and you can tell QuickBuild to publish the results.

		After adding generate the XML report(s) for your test results, you can tell QuickBuild to add those results now.

		h2. Publish JUnit Report

		Just like all other [build reports\|5. Publish Build Reports], to add JUnit report is by [adding a publish step\|Working With Step] in a [configuration\|1. Working with Configuration]. When you add publish JUnit Report step, the following screen will be displayed:

		!junit_step.png!

		In source files field, QuickBuild use Ant style file patterns to collect the reports, and the directory you specified is relative to the [workspace\|Workspace Directory] directory.

		In source files field, QuickBuild uses Ant style file patterns to collect the reports, and the directory you specified is relative to the [workspace\|Workspace Directory] directory.
		{info:title=More on JUnit Report}
		* If you have merged all test reports into one report using JUnitReport task, and the merged report is in the same directory as those test cases reports, please DO specify the merged report only.
		{info}