Common Build Infrastructure/Testing
This page is currently under construction. Community members are encouraged to maintain the page, and make sure the information is accurate.
Contents
Running Tests As Part Of An Athena Build
Simply use these build.steps entries to build, then run, your tests. Or omit the property entirely in your build.properties file and the default steps will be run:
build.steps=buildUpdate,buildTests,generateDigests,testLocal,publish,cleanup
Note that the previous test runner task, "test" is still available but only works on Linux as it requires xvnc or xfvb.
Run Tests In Hudson
To use the new testLocal task, you will need to enable Xvnc to run around your entire build.
To use the old test task, you will need to run your tests on a Linux server with xvnc or xvfb installed.
Running Tests Separately From An Athena Build
Option 1. Run Tests Again
After a successful build, you may want to re-run the same tests.
Point your build.properties at the previous build's timestamp and it will re-run the tests in that same folder (destructively).
build.steps=testLocal buildTimestamp=200911232255
Yes, that's it - just point at a pre-existing timestamp, and you're good to go!
Option 2. Run Tests Separately From a Previous Build
Point your build.properties at the paths where the Tests and Update zips can be found.
If you normally build with repositoryURLs and featureIDsToInstall, add the values below to those existing properties - DO NOT replace! You will of course need to define all the runtime/compiletime dependencies as you would for a normal build or build+test run.
Local Inputs
build.steps=testLocal,publish,cleanup
testFramework=/path/to/GEF-Automated-Tests-N200911232255.zip
repositoryURLs=jar:file:/path/to/GEF-Update-N200911232255.zip!/
featureIDsToInstall=${mainFeatureToBuildID}
Remote Inputs
build.steps=testLocal,publish,cleanup testFramework=http://path/to/GEF-Automated-Tests-N200911232255.zip repositoryURLs=http://path/to/GEF-Update-N200911232255.zip featureIDsToInstall=${mainFeatureToBuildID}
To prevent cleanup, you can either omit the build.steps=publish,cleanup steps, or use
noclean=true
References
- bug 295670 - Make Tests run from ANT script only
Controlling Test Environment
You can pass a custom library file (to replace org.eclipse.test/library.xml) or set different Java heap/permgen settings when running your tests. This is particularly important when debugging or running on 64-bit platforms, which need more memory allocation than 32-bit platforms. See Testing - VMArgs for details.