The Plug-in requires Ant 1.3 or higher. It has been tested with 1.3 and 1.5 versions of Ant. Please feel free to notify of other success stories. See Section 1.1, “System requirements” for the basic requirements to run Jalopy.

To obtain more information about this wonderful build tool, visit the official Ant home page at the Apache Jakarta site: http://jakarta.apache.org/ant/

The Plug-in comes either as a single .zip or compressed .tar archive. Unzipping either one of these files into a directory of your choice (referred to as <INST_DIR>) will produce three subdirectories /bin, /docs and /lib.

..
  bin/       contains wrapper scripts for different platforms
  docs/      contains the documentation
  lib/       contains all necessary libraries

Before you can use the Jalopy Ant task in your build scripts, you have to add it to your system. Maybe the simplest way is to utilize the <taskdef> element in your build script as follows:

<taskdef name="jalopy"
         classname="de.hunsicker.jalopy.plugin.ant.AntPlugin">
  <classpath>
    <fileset dir="<INST_DIR>/lib">
      <include name="*.jar" />
    </fileset>
  </classpath>
</taskdef>

If you rather want to add the provided libraries to your classpath (either by copying the libraries into the /lib folder of your Ant installation or setting up the classpath as usual), please be aware that the provided parser (aelfred-xxx.jar) is incompatible with Ant 1.4.1 or prior releases. If you happen to use one of these outdated versions, the parser library must not be copied into the /lib folder (or added to the classpath) otherwise Ant will fail to work!