Chapter 2. Getting started

Table of Contents

Requirements
Downloading At4J
Installing At4J
Running unit tests (optional)

At4J requires Java 5 or a newer Java version to run.

Get At4J from http://www.at4j.org.

At4J is distributed in two Zip archives. The binary archive contains everything necessary for using At4J. The source archive contains everything that the binary archive does, as well as unit test classes, test data and the complete At4J source code in an Eclipse workspace.

Unzip the distribution into a directory.

The At4J Jar file and its dependencies are in the lib sub directory of the distribution.

The source distribution comes with a Schmant script for running all unit tests.

To run the unit tests, open a command window (terminal, cmd) and change directory to the At4J source distribution's build directory. Set the JAVA_HOME environment variable to point to a Java JDK 6 installation. (Just a JRE won't do.)

On Unix, run:

$ # For instance
$ export JAVA_HOME=/opt/java6
$ schmant.sh -p javaCmd=[Java command] run_unit_tests.js

where the Java command is the path to the java to use for running the tests.

On Windows, run:

> rem For instance. Note the absence of quotes in JAVA_HOME
> set JAVA_HOME=c:\Program Files\Java\jdk1.6.0_16
> schmant -p "javaCmd=[Java command]" run_unit_tests.js

where the Java command is the path to the java.exe to use for running the tests.