Working with jagtool  The Ant build file

Chapter 12: Using jagtool and jagant

jagtool and jagant

jagant lets you run jagtool commands from Ant build files. This powerful feature allows you to write build files that automate many development and deployment tasks.

Jakarta Ant is a Java-based build tool developed by the Apache Jakarta project. To obtain Ant software and documentation, see the Ant Web site . Ant functions similarly to other build tools (such as make, gnumake, or jam) but is platform-independent, extending Java classes rather than OS-specific shell commands. Ant includes a number of tasks that are frequently used to perform builds, including compiling Java files and creating JAR files. It also includes common functions such as copy, delete, chmod, and so on.

Ant build files (similar to a make file) are written in XML. Like make, Ant build files can include targets that perform a series of tasks. Instead of extending shell commands, Ant’s build file calls out a target tree where various tasks are executed. Each task is run by an object that implements a particular task interface.


Setting up your environment

Install Ant and read the accompanying documentation.

The jagant script requires a full JDK installation. If you are running jagant from an EAServer client install, make sure you have installed the full JDK. By default, only the JRE files are installed.

Before running jagant, verify that:


jagant scripts

The following scripts are provided for running Ant with jagtool commands:


jagant syntax

The jagant script uses this syntax:

jagant [ant_options]

where ant_options are any options and commands supported by Ant; see the Ant documentation for details on these options.

You may frequently use the -buildfile flag. Using -buildfile lets you specify a location other than the default for the Ant XML build file.





Copyright © 2005. Sybase Inc. All rights reserved. The Ant build file