|
Last update : June 18 2001
Home
Jakarta Commons
About
News
Features
Goals
Changes
Todo
Contributors
Contributing
License
Downloads
Downloads
Design
Architecture
Mock vs Container
User Guides
Installation
Installing Ant
Installing Sample
Configuration
Writing Test Case
Servlet Sample
Ant integration
Servlet Engines
API Reference
Support
CVS
Bug database
Mailing lists
FAQ
Misc.
Resources
|
Forewords |
Ant is a Java based build tool. It is used to build the Cactus
framework itself and the Cactus Sample application.
|
Ant tasks needed by Cactus |
Cactus uses the following optional tasks of Ant :
-
<stylebook> to build the Cactus
web site and Cactus
documentation. The Stylebook version required by the Cactus build is
the Stylebook 1.0b3 for Xalan2 (named
stylebook-1.0-b3_xalan-2.jar ) which needs the Xalan 2.0
jar and the Xerces 1.3 jar. The Ant stylebook task It is not used by
the Cactus Sample application build process.
-
<junit> to run the unit tests of
Cactus itself and the Cactus unit tests in the Sample application.
-
The Cactus Sample application uses a custom task provided by Cactus
in the
commons-cactus-ant.jar jar file (the task
is called <runservertests> ).
|
Installing Ant on Windows systems |
Ant is an application that needs to be installed somewhere on your
hard drive.
Follow the steps below to install Ant :
-
Download Jakarta Ant
(
jakarta-ant-<version>-bin.zip ) from
here. I
recommend version 1.3 or above. Alternatively you can download a
prepackaged Ant version (containing required optional tasks and jars)
from here,
-
Unzip it in a directory. Let's call this directory
antroot ,
-
Create an environment variable named
ANT_HOME that points
to your antroot directory,
-
Modify the
PATH environment variable to include the
%ANT_HOME%\bin directory (so that you'll be able to type
ant in a DOS shell, in whatever directory and it will
call the %ANT_HOME%\bin\ant.bat script,
-
Download the Ant optional task jar
(
jakarta-ant-<version>-optional.jar ) from
here
and put it in %ANT_HOME%\lib ,
-
If you haven't downloaded the prepackaged Ant zip, you'll need to
download the Stylebook 1.0b3 for Xalan 2 jar (from ?), the latest
Xalan, the latest
Xerces and the
latest JUnit jars. You'll also
need to ensure that you use a JAXP 1.1 parser (Ant 1.3 comes with
a JAXP 1.0 parser only, called
parser.jar . Ant 1.4
already bundles a JAXP 1.1 parser, called crimson.jar ).
You can download one (crimson) from
here. Put
all these jars in %ANT_HOME%\lib .
 |
You should ensure that the Ant optional jar that you download contains
the <stylebook> and <junit> tasks. Alternatively you can
download the prepackaged Ant zip as mentionned above.
|
|
|
|