Prequisites
- Check out or download as a ZIP file the Codehaus Cargo source code from SVN Github into a
CARGOHOME
directory (wherever you want on your machine).In case your SVN client needs to go through a proxy, have a look at What if I'm behind a proxy? - Install Maven 2 or Maven 3 (most likely, only Maven 3 is available for download). Verify your installation works by typing "
mvn --version
" at a command prompt.- CARGO Codehaus Cargo requires Maven 2.0.5 or greater to run
- CARGO requires Codehaus Cargo requires Maven 2.1 or greater to compile; in particular the
core/samples
builds require that version of Maven
Info | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
CARGO 1.0.x's Maven 2 plugins do work very well with Maven 3, but CARGO 1.0.x requires Maven 2 for its build process. Starting from CARGO 1.1.x, CARGO also builds on Maven 3, see
|
Building
Building
To build Codehaus Cargo:
- Go to
CARGOHOME
and typemvn install
This will build the full Cargo project. - If you wish to clean all build-generated files, cd to
CARGOHOME
and typemvn clean
Info | ||
---|---|---|
| ||
The The Codehaus Cargo build contains functional tests. Those tests are run on different containers. The first time you build build Codehaus Cargo it will download those container distributions which will take some time (the containers are installed into |
...
. |
...
Selecting containers
The default list of containers to run on depends a property cargo.containers defined in CARGOHOME/core/samples/pom.xml
. It can also be supplied at the commandline by using profiles (-P<containerId>
).
For example if you only want to run on Tomcat 5.x you'd write: mvn -Ptomcat5x clean install
There are also some multi-container profiles, for example mvn -Pall-downloadable clean install
will build CARGO and test the CARGO samples with all downloadable containers (Jetty's many versions, Tomcat's many versions, etc.)
Tips
- Type
mvn -o
to work offline. This improves the build speed as Maven 2 does not check for updates on the remote repository for SNAPSHOTsSNAPSHOT
versions.
Proxy settings
If you need to build cargo build Codehaus Cargo from behind a proxy, proceed as follows:
- edit Edit the
.m2/settings.xml
file from your home directory (C:
/\Documents and Settings
/\username
orC:\Users\username
on Windows), - comment Comment out the <proxy> element and fill in the proxy server settings accordingly.