blob: 79a993dc6fa34d42d672d4b237493312cb55189f [file] [log] [blame]
<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Test - build.properties</title>
<link type="text/css" rel="stylesheet" href="../../book.css"/>
</head>
<body>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<th style="width: 100%" align="center" colspan="3">build.properties</th>
</tr>
<tr>
<td style="width: 20%" align="left">
<a href="Virgo-Test-Framework.html" title="Virgo Test Framework">
<img alt="Previous" border="0" src="../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right">
<a href="Updating-This-Document.html" title="Updating This Document">
<img alt="Next" border="0" src="../../images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Virgo Test Framework</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
</table><hr/>
<h1 id="build.properties">build.properties</h1>
<p>Certain test properties may be set for all the projects of a given git repository in its build.properties file. For an example, see the kernel's
<a href="http://git.eclipse.org/c/virgo/org.eclipse.virgo.kernel.git/tree/build.properties" target="doc_external">build.properties</a>.
</p>
<p>
<br/>
</p>
<table border="1" cellpadding="1" cellspacing="1" width="70%">
<tr>
<td>+ Test-related build.properties</td>
</tr>
<tr>
<th>
<b>Property name</b>
</th>
<th>
<b>Definition</b>
</th>
<th>
<b>Default value</b>
</th>
</tr>
<tr>
<td>test.forkmode </td>
<td>"perTest" if a new JVM is to be launched for each test class. "perBatch" if a new JVM is to be launched for each project. See "forkMode" in the
<a href="http://ant.apache.org/manual/Tasks/junit.html" target="doc_external">Ant JUnit task</a>.
</td>
<td>perBatch</td>
</tr>
<tr>
<td>test.java.dir</td>
<td>The directory containing the source code for a project's tests.</td>
<td>&lt;project&gt;/src/test/java</td>
</tr>
<tr>
<td>test.resources.dir</td>
<td>The directory containing resources for a project's tests.</td>
<td>&lt;project&gt;/src/test/resources</td>
</tr>
<tr>
<td>test.output.dir</td>
<td>The directory in which a project's compiled tests are stored.</td>
<td>&lt;project&gt;/target/test-classes</td>
</tr>
<tr>
<td>test-results.output.dir</td>
<td>The directory in which a project's test results are stored.</td>
<td>&lt;project&gt;/target/test-results</td>
</tr>
<tr>
<td>test.vm.args</td>
<td>JVM parameters for running the test classes. See the "jvmarg" nested element of the
<a href="http://ant.apache.org/manual/Tasks/junit.html" target="doc_external">Ant JUnit task</a>.
</td>
<td>&lt;the empty string&gt;</td>
</tr>
<tr>
<td>ci.build</td>
<td>Set to "true" if the build should continue after errors are encountered. When needed, this property is passed on the Ant invocation by specifying "-Dci.build=true" and is otherwise left to default. This property is used to specify the "haltOnError" and "haltOnFailure" parameters to the
<a href="http://ant.apache.org/manual/Tasks/junit.html" target="doc_external">Ant JUnit task</a>.
</td>
<td>false</td>
</tr>
</table>
<p>Virgo build drives JUnit for unit and integration tests in the "test-run" macro in
<a href="http://git.eclipse.org/c/virgo/org.eclipse.virgo.virgo-build.git/tree/common/quality.xml" target="doc_external">common/quality.xml</a>. The above properties parameterise the macro.
</p>
<p>The properties are defaulted in
<a href="http://git.eclipse.org/c/virgo/org.eclipse.virgo.virgo-build.git/tree/common/common.properties" target="doc_external">common/common.properties</a> and are typically overridden for all the projects of a given git repository in the build.properties file.
</p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
<a href="Virgo-Test-Framework.html" title="Virgo Test Framework">
<img alt="Previous" border="0" src="../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center">
<a href="Test.html" title="Test">
<img alt="Test" border="0" src="../../images/home.gif"/>
</a>
</td>
<td style="width: 20%" align="right">
<a href="Updating-This-Document.html" title="Updating This Document">
<img alt="Next" border="0" src="../../images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Virgo Test Framework</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
</table>
</body>
</html>