This site is no longer active; it remains as a historical reference.
For the latest version of JWare Software visit jwaresoftware.org
Like most Ant extensions, the JWare/AntXtras Foundation package (AntX) is a Java-based library. The release consists of three independent download packages: binaries, api-docs, and source. Only the most recent zipped packages (v0.5.1) can be downloaded from this website; for older releases, visit the AntX SourceForge.net
files release archive.
The current release has been verified against the Windows Sun J2SE 1.4 platform and the Ant 1.6.5 and 1.7 distributions. Up-to-date installation instructions, release notes, licenses, and known issues are available for your perusal before download.
Every released AntX component has an associated MD5 hash value and gpg-generated signature so you can verify its integrity. To authenticate the various components with any PGP or GPG application, download our KEYS file from this website only and import them into your public keyring.
Installing AntX
AntX's installation is similar to any optional Ant package. The following instructions describe how to install and verify AntX in your runtime environment.
- If you haven’t already done so, download and install an Ant distribution—at least version 1.6.5. Verify that Ant is properly installed. AntX only uses components of the standard Ant distribution; optional tasks are not required.
- Download, verify, and extract an AntX distribution. For the first-time user we suggest you download the binary distribution that includes several sample build files; these samples can be used to verify the installation is working properly.
- If you must manually generate all binaries for your environment, download the source-only distribution. The included ez‑build.xml Ant build file can generate a default distribution from the source. Be sure you download the required third-party libraries and configure the ez‑build.properties file for your environment. You must use javadoc version 1.4 or later to generate the javadocs using the ez-build.xml Ant file.
In the remaining steps we will use <ANTX_DIR> to refer to the directory into which the AntX distribution was extracted or built.
- Update your Ant runtime environment to include the AntX jar files <ANTX_DIR>/lib/AntX_tasks.jar and <ANTX_DIR>/lib/JWare_apis.jar in its classpath. There are several ways of telling Ant about third-party jar files; the easiest method is to copy the files into your Ant distribution’s lib directory. A safer approach is to install AntX in its own location and update the CLASSPATH used when you run Ant (for example, by using the -lib option or a custom $HOME/.antrc file). See “Running Ant” for details.
- Verify the AntX tasks are accessible from Ant. The easiest way to do this is to run Ant against one of the sample build files from the distribution. From within the <ANTX_DIR>/etc directory, run `ant -f antx-install-check.xml`. This build file doesn’t actually do anything except declare several AntX task and type definitions. If Ant is unable to locate the AntX classes, even this simple build file will fail.
- Read the “JWare/AntXtras Foundation Quick Start Guide”(pdf) or the [overview] page for a general description of the most useful AntX components.
- Start using AntX!
AntX Dependencies (Build Your Own AntX
)
If you would like to compile the source distribution, AntX is dependent on a few other open-source offerings that you must download and install before trying to compile your own AntX binaries. These dependencies are listed below: