Page History

The eagle-i source code is a multi-module maven project stored in a Subversion source control repository. This guide outlines a procedure for setting up the Eclipse IDE and importing in order to import the eagle-i code.  We assume a Mac running Mountain Lion, but much will be similar in other platforms. This is not meant to be an exhaustive guide, but rather to give you an idea of how to set up an environment - different OSs, different versions of Eclipse, different installed plugins, etc.  introduce subtle differences that would be hard for us to cover here.

We have tested this procedure with the latest Eclipse version (Kepler).

...

m2eclipse (m2e) provides reasonable integration of a maven project in Eclipse. Luckily, the m2e plugin is part of the standard Eclipse bundle since the Indigo release. If you have an older version of Eclipse (Helios or older), you'll have to install the plugin manually (it is not clear if that 's is supported any more - please consult the interwebs).

...

Whatever your Eclipse version, you'll need to make sure you have a Subversion plugin - either Subclipse or Subversive. We prefer Subclipse - to install it, follow the instructions here: Subclipse installation. We use version 1.8 (later versions don't have the SvnKit option yet, which is what works in MacOSX). Once installed (requires a restart of Eclipse), go to Preferences->Team->SVN and select SvnKit as client interface.

m2eclipse Subclipse connector

...

Open the SVN perspective and add the eagle-i svn repository: https://open.med.harvard.edu/svn/eagle-i-dev

Right Open the repository, then the apps folder, then right click on trunk and select Checkout as Maven project.... You can accept the defaults or customize as you please (e.g. add a prefix to all checked-out projects, add them to a filtered list, etc.). If you're prompted to select additional m2e connectors, accept the suggestions and continue. After a little while you'll see Eclipse building the workspace. A full build will take quite some time. Note that this initial build is not a maven compilation, but an Eclipse compilation. At the end of all this, you will have an eclipse project per maven module.

...

To build the entire maven project, right click on the root module eagle-i-base and select run as -> maven install. The built artifacts will reside in the target directory of each module/project.

There is a chance that some tests may fail with a java.lang.OutOfMemoryError when doing this full build. If this happens open the Run Configurations in Eclipse for this build. Go to the JRE tab and in the section VM arguments add the following:
-DargLine="-Xmx2048m -XX:MaxPermSize=1024m"