The tests are then run on the bootstrap VM, i.e. the JVM used to build Jikes RVM. You can also configure the build to run unit tests on the newly built Jikes RVM. Note that this may significantly increase the build times of slow configurations (e.g. prototype and protype-opt).
If you are developing new unit tests, it may be helpful to run them on an existing Jikes RVM image. This can be done by using the Ant target
unit-tests-on-existing-image. The path for the image is determined by the usual properties of the Ant build.
Functional and Performance Tests
The name of the test-run. The name should match one of the files located in the build/test-runs/ directory minus the '.properties' extension.
The directory where Ant stores the results of the test run.
The directory where Ant gzips and archives a copy of test run results and reports.
Define this property to send reports via email.
The from address used when emailing report.
The to address used when emailing report.
The host to connect to when sending mail.
The port to connect to when sending mail.
If set to true, the test process will skip the build step for specified configurations. For the test process to work the build must already be present.
If defined the test process will skip the build step for all configurations and the javadoc generation step. For the test process to work the build must already be present.
If defined the test process will skip the javadoc generation step.
A test-run is defined by a number of properties located in a property file located in the build/test-runs/ directory.
The property test.configs is a whitespace separated list of test-configuration "tags". Every tag uniquely identifies a particular test-configuration. Every test-configuration is defined by a number of properties in the property file that are prefixed with test.config.<tag>. and the following table defines the possible properties.
The names of the test groups to execute.
The unique identifier for test-configuration.
The name of the RVM build configuration to test.
The name of the RVM build target. This can be used to trigger compilation of a profiled image
The test mode. May modify the way test groups execute. See individual groups for details.
Extra arguments that are passed to the RVM.
Extra arguments that are passed to the RVM. These may be varied for different runs using the same image.
- Search for one of the the following ant properties, in order.
- If none of the above properties are defined then use the parameter that was passed to the <rvm> macro in the ant build file.
- If no parameter was passed to the <rvm> macro then use the default value which is stored in the "Default Property" as specified in the above table. By default the value of the "Default Property" is specified as the "Default Value" in the above table, however a particular build file may specify a different "Default Value".