Using Ant

Configuration

CodeGuide works with Apache Ant version 1.4 and above. Support for Ant has to be configured in the Integration | Paths section of the Preferences dialog.

 

Usage

By default new projects use CodeGuide's internal build system. Using the internal build system is highly recommended because advanced features such as incremental compilation and HotSwap class replacement will only work if the internal build system is used.

 

However if you need full control over the build process you can use Jakarta Ant for building. To enable Ant you have to switch the Build system option in the Build section of the Project Settings Dialog to Ant. Once you have switched the build system to Ant Project | Build and Project | Rebuild will use Ant instead of the internal build process.

 

You need to configure some other options in the Ant pane in the Project Settings Dialog.

 

 

You have to specify either a Build file or the Working directory for Ant. If you do not specify a build file Ant will use a file named build.xml located in the specified working directory.

 

You can further customize the behaviour of Ant using the options in the Advanced section:

 

Build target(s)

Use this option to specify a list of targets that will be made when Project | Build is invoked. If no targets are specified the default target is made.

Rebuild target(s)

 

Use this option to specify a list of targets that will be made when Project | Rebuild is invoked. If no targets are specified the default target is made.

Ant options

 

Use this options to specify additional Ant commandline options.

VM commandline options

Use this options to specify additional commandline options that will be passed to the VM when invoking Ant.

Additional CLASSPATH

Using this option you can add additional libraries that will be included in the CLASSPATH when Ant is invoked. Use this options if you have custom tasks.

 

 More information on where to get help for Jakarta Ant can be found in the Where to get help chapter in the First Steps section.