Prequisites
- Check out or download as a ZIP file the Codehaus Cargo source code from Github into a
CARGOHOME
directory (wherever you want on your machine). - Install Maven 3.2.2 or later. Verify your installation works by typing "
mvn --version
" at a command prompt.
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
toCARGOHOME
and typemvn clean
First time build
The Codehaus Cargo build contains functional tests. Those tests are run on different containers. The first time you build Codehaus Cargo it will download those container distributions which will take some time (the containers are installed into core/samples/java/installs
). If you want to tell Codehaus Cargo to run only on some specific container, see below.
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 command line by using profiles (-P<containerId>
).
For example if you only want to run on Tomcat 8.x you'd write: mvn -Ptomcat8x clean install
Tips
- Type
mvn -o
to work offline. This improves the build speed as Maven does not check for updates on the remote repository forSNAPSHOT
versions.
Proxy settings
If you need to build Codehaus Cargo from behind a proxy, proceed as follows:
- Edit the
.m2/settings.xml
file from your home directory (C:\Documents and Settings\username
orC:\Users\username
on Windows), - Comment out the
<proxy>
element and fill in the proxy server settings accordingly.