Overview

• Ensure you have Java and Ant installed (see below)
• Change into the buildscripts/ directory of your svn checkout (see GettingTheSource)
• Invoke ant without arguments - Ant will fail the first time it runs while it installs the apropriate jar files to your home directory
• Invoke ant again, this time receiving a list of possible targets that you can invoke to make builds, run tests, etc. (see AntIncantations for some examples)

The long story

After a bunch of hemming and hawing, Ant was selected as a build tool for Dojo due to its portability. Unfortunately, Ant isn't without dependencies and foibles. The setup of Ant requires some platform-specific configuration which the better OS vendors have taken care of for you.

Windows

Windows users need to pull down the entire toolchain bit by bit. You will need to install:

• JDK v1.4.2 from whichever Java vendor you prefer
• Ant 1.6 or later

Mac OS X

If you're using Apple OS X, Ant and the Java SDK are provided by the Apple Developer Tools which can be downloaded for free from http://connect.apple.com with a free registration.

Linux

Most competent Linux distros provide both Java and Ant via their package system. On Debian-based Linux systems, you can in theory save yourself a lot of pain by using apt:

apt-get install ant

You should verify that it's installing Ant 1.6.x and not 1.5.x, and that Ant will run the Dojo "testScripting" target once installed.

On SuSE linux (9.2 or 9.3), you can safely install Ant via YaST, but library location will fail and none of the script-based tasks will work out of the box.