$URL: svn+ssh://alci@svn.forge.objectweb.org/svnroot/barracudamvc/Barracuda2/tags/2.1/WEB-INF/src_docs/getting_started/building_barracuda.html, v158
Compiling the Source
Barracuda is built using Ant 1.5.1+.
The following are the basic steps required to build Barracuda 2.x.
- install your preferred JDK. Barracuda has been tested to compile
under JDK 1.4, and
JDK 1.5.
- download and
install
the latest release version of Ant
- Get the source for Barracuda
and make sure the distribution is installed on your file system
- if you plan to run the JUnit tests, you need to do 2 additional
things:
- copy the JUnit jar file located in
Barracuda/WEB-INF/jars to ANT_HOME/lib
- copy the Log4j jar file located in
Barracuda/WEB-INF/lib-cvs to ANT_HOME/lib
- copy the Xalan jar file located in
Barracuda/WEB-INF/jars to CATALINA_HOME/shared/lib
You are all set to start building Barracuda. The Barracuda distribution
contains all required dependencies (other than stuff like JAXP and Xerces2
which already come with packages such as
Ant and Tomcat).
To actually run the build, open a command console, cd to
Barracuda/WEB-INF/bin, and type "ant" to run the default build target
(currently the "install" target). Or, if you are a windows type, you can
simply double click WEB-INF/bin/ant_0_install.bat. Running the install task
simply copies all the jars from lib-cvs in to lib.
To view available targets and information about those targets, type "ant
-projecthelp". Here's a brief list of common tasks:
- ant install - [DEFAULT] copies the jar files from /lib-cvs to
/lib and creates needed files from samples.* if they don't already
exist. Cycle the webapp and you're good to go.
- ant clean - cleans all compiled class. Does NOT nuke any
files installed from samples.
- ant superclean - just like clean, but cleaner: it DOES nuke
files installed from samples (subsequent install will restore fresh
copies)
- ant taskdefs - build the custom Barracuda taskdefs
- ant compile compile.test - compiles all source code
(including test cases)
- ant compile contrib -Dclean.contrib=true -Dsubskip=true -
compiles the contrib packages
- ant test - runs the unit tests
- ant docs - generate the
developer docs (HTML)
- ant javadoc - generate the javadocs
- ant jars - rebuilds the jar files [note that the jar files
are stored under cvs, so you don't need to do this when you download
Barracuda; you can simply install]
- ant jars.master - same as above, except that it will also
create one master barracuda.jar (so you don't have to mess with a
handful of individual ones)
Last Modified: 2007-02-03 14:24:13 +0100 (sam, 03 fév 2007)