Setting Up Eclipse to Compile GUTS

There are several options for working with the GUTS source code in Eclipse (add more as you find them):

1. m2eclipse with NO svn plugin integration
2. m2eclipse with Subclipse integration
3. m2eclipse with Subversive integration

download / update sites:

m2eclipse: http://m2eclipse.sonatype.org/

subclipse: http://subclipse.tigris.org/

subversive: http://www.eclipse.org/subversive/

m2eclipse with NO svn plugin integration

The following procedure will download GUTS source code from SVN and configure projects in Eclipse for each GUTS sub-module;

It will work for both eclipse/subclipse and eclipse/subversive plugins and does NOT require specific subclipse+m2e or subversive+m2e integrations;

1. Switch to SVN repository perspective
2. Add Checkout URL as an svn repo
3. Navigate to Trunk
4. Right click, Check Out

1. Check out as project configured using New Project Wizard
2. Check out HEAD
3. Finish

1. New Project Wizard will display
2. Next
3. Project name = GUTS
4. Next
5. Remove all Source folders (right click on src in the folder tree in the wizard and choose Remove)
6. Finish
7. Click OK to ignore the warning about .project file being part of svn

After SVN checkout is complete, you will have a single project called GUTS displaying in the Eclipse workspace

1. Click on the project
2. File->Import, Maven\Existing Maven Projects, Next
3. Leave all sub-projects checked
4. Click Finish

The Maven console in Eclipse will show a bunch of [INFO] entries as various dependency downloads are performed

At this point, you will have a separate Eclipse project for each guts module, plus the top level project containing all of the source for all of the modules. The individual projects (i.e. guts-common, guts-events, etc...) will have dependency management completely configured, so changes in one project become available in the others.

m2eclipse with SUBCLIPSE integration

Be sure that you have m2eclipse AND the m2eclipse subclipse plugin installed in Eclipse.

The m2eclipse subclipse plugin is available on the M2eclipse Extras download site (you can add http://m2eclipse.sonatype.org/sites/m2e-extras to the Eclipse Software Updates and Add-Ons dialog, then choose Maven SVN Handler for Subclipse)

Once both plugins are installed, downloading GUTS is quite simple:

1. File->New->Project
2. Checkout Maven Projects from SVN
3. Set the SCM URL to Checkout URL and add the /trunk branch to the end
4. Click Advanced and ensure that 'Use separate projects for modules' is checked
5. Click Finish

GUTS will be checked out as a set of projects with Maven dependency management enabled, each project will be properly bound to source control.

m2eclipse with SUBVERSIVE integration

TODO

General m2eclipse information

The embedded Maven implementation used by m2eclipse (as of version 0.10) is great for dependency resolution, but not so great for running lifecycle phases. If you are wanting to explicitly run mvn commands via Eclipse, we strongly recommend that you install the Maven command line tool, and configure m2eclipse to use it under Window->Preferences->Maven->Installations