Download and compile

This document explains how to download the sources of blueMarine and build the application. You need the following pieces of software:

• Java JDK 1.6.0 or later
• Mercurial 1.4 or later
• Maven 2.2.0 or later
• optionally, an IDE supporting Maven (the NetBeans IDE 6.8, or later, is highly recommended)

From the command line

It is possible to fetch all the sources in a single step by cloning the special "All" repository:

hg clone https://kenai.com/hg/bluemarine~all-src

Alternatively, it is possible to fetch only a single subproject, as those listed in the table below (just use the specified Mercurial URL):

(*) Measured on March 19, 2010.
(**) It's vastly experimental and only a few modules are currently used

Once the sources have been downloaded, to compile the project(s), run from the command line (or execute the equivalent command from inside an IDE):

mvn clean install -DskipTests

The first time you build the project, it might take a long time as it will download many resources from the internet. These resources are cached in the local Maven repository, so further builds will be considerably faster.

From the NetBeans IDE

From inside the NetBeans IDE, execute the following steps:

1. Select the menu “Team / Kenai / Get sources from Kenai”.
2. Click on “Browse...” near “Kenai Repository”.
3. Enter “bluemarine” and press “Search”.
4. Select the appropriate repository (see the previous paragraph for details).
5. Press “Ok”.
6. Select the “Local Folder” where you wish to copy the sources.
7. Press “Get from Kenai”

Please be patient, as the operation might requires some time (also in function of the size of the selected repository).
When the download is completed, NetBeans will ask you to login at Kenai (if you weren't already logged in). This step is optional, and you can just press the “Cancel” button.

At the final step, blueMarine asks you which projects you want to open - we suggest you select the topmost project and mark the “Open required” checkbox; then press the “Open” button.