Source & build notes

Getting the source

What you need:

We use subversion for source version control, so 'll need a subversion client. To build the software, we use maven. You'll need maven version 2.0.9 or above. See the Apache Maven site for more information. We use a maven JAXB plugin that is not yet officially released. You can download it from the Glassfish JAXB project site. That site contains also a lot of information on how to install and use the plugin. If the information in the following sections doesn't make sense to you, we advise that you read up on subversion and, especially, on maven.

Get the Source Code:

To get the source code for release 1.3.0 do:

$ svn checkout https://svn.geomajas.org/majas/tags/1.3.0/ geomajas

Building Geomajas using Maven

Goto to the majas-maven directory and run the install plugin.

Maven commands

$ cd majas-tutorial
$ mvn install

Maybe take a coffee now as this can take quite some time (depending on what jars you might already have in the repository)... After the build is done, the web application majas-tutorial-1.3.0.war should be available in the majas-tutorial/target folder. This is a regular web application which is self-consistent and can be deployed on a servlet engine like Tomcat 5.

Eclipse Integration

Maven can turn the source directories into eclipse projects. Turn the directory where you downloaded the source into a workspace, and define an Eclipse Classpath Variable "M2_REPO" to your local maven repository (usually $HOME/.m2/repository on Unix/Linux/Mac OS X and %HOME%\.m2\repository on Windows).
Also make sure that your java compiler level is 5.0 and turn of validation as it is way to strict on html pages.
After that goto majas-tutorial directory and do:

create Eclipse projects

$ mvn eclipse:eclipse

After that you can import the projects into Eclipse

Import project into the workspace

In Eclipse use:File-> Import ... \-> General/Existing Projects into Workspace