Table of Contents
Schmant requires at least Java 6.0 to run. This requirement is just for running Schmant, though. Schmant scripts can build applications targeted for any Java version.
Download Schmant from http://www.schmant.org. There are two distributions to choose between. The binary distribution includes everything that is needed to run Schmant and all documentation. The source distribution contains everything that the binary distribution contains, as well as the complete Schmant source code in an Eclipse workspace.
Unpack the distribution into a directory. Most script languages require
that the script language implementation JARs are on the classpath when running
build scripts. Either put them on the classpath manually or put them in the
Schmant installation's libengine directory.
See the different script language guides for details.
The source distribution comes with a set of unit tests. For running them, the following requirements must be met:
Apache Ant must be installed and the ANT_HOME
environment variable must be set to point to the installation root directory.
Findbugs must be installed and the FINDBUGS_HOME
environment variable must be set to point to the installation root directory.
A Java 6 or newer JDK (just the JRE won't do) must be installed and the
JAVA_HOME environment variable must point to the
installation root directory.
The unit tests will generate verbose output and what may seem to be a lot of errors. That is just part of the normal tests. The interesting output comes in the test report that is written when all tests have been run.
To run the unit tests on Unix, cd to the
$SCHMANT_HOME/build directory
and execute the following command (on one line):
PATH=path to bin catalog of JDK6 installation:$PATH \ JAVA_HOME=path to JDK6 installation\ ANT_HOME=path to Ant installation\ FINDBUGS_HOME=path to Findbugs installation\ ../bin/schmant.sh run_unit_tests.js
See the header of the run_unit_tests.js
for more configurable options.
To run the unit tests on Windows, cd to the
build directory in the Schmant source distribution
and execute the following commands (several lines):
set PATH=path to bin catalog of JDK6 installation, no quotes;%PATH% set JAVA_HOME=path to JDK6 installation, including drive letter, no quotesset ANT_HOME=path to Ant installation, including drive letterset FINDBUGS_HOME=path to Findbugs installation, including drive letter..\bin\schmant.bat run_unit_tests.js
See the header of the run_unit_tests.js
script for more configurable options.