Setting Up Eclipse For Hermes Development

Here's the first part of a howto to get you started. This was thrown together quickly to assist a team member and is not a complete guide. Hopefully I'll revise this at some stage.

  • Install Java if you haven't already!
  • Install Eclipse from

 http://www.eclipse.org/downloads/

I use the EE developers version.

  • Install a Subversion plugin by following (site seems VERY slow today):

 http://subclipse.tigris.org/install.html

  • Install a Maven plugin by following the animation at

 http://m2eclipse.codehaus.org/Installing_Maven_2.0_plugin_for_Eclipse.html

I actually installed mine according to

 http://m2eclipse.codehaus.org/

but I assume the animation will make it easier if you're new to Eclipse.

  • Assuming those plugins installed fine and you've restarted Eclipse:
  • Define a Subversion repository using File/New/Other and choose the SVN/Checkout Projects from the SVN wizard, then hit Next. Now select Create a new repository location and set the URL to:  https://projects.arcs.org.au/svn/commons-vfs-grid/ and then hit Next.

At this point hit Cancel because we don't actually want to check anything out yet.

  • Try File/Import/Other/Check out Maven Projects from SCM in order to grab the Hermes source. Set SCM URL to svn, and hit Browse. The Repository Browser should show the url you just defined. Expand the item to show the projects it contains. Navigate to Hermes/trunk and select that. You should be back at the main checkout window again and so select Next.

Now select Add projects to working set, then New/java/Next and set the working set name to Hermes and Finish. Now back in the Checkout main window select Finish.

Hopefully Eclipse will now check out the source as a project called Hermes. I think you should be able to grab the source anonymously. I often get an error at this point due to a connection reset and have to try again several times. Not sure why.

  • Using the Project Explorer view (I think that's visible by default for a new Eclipse installation), right click on the Hermes project and select Maven/Update dependencies. If all goes well it'll take AGES to grab all of the required libraries needed by maven and Hermes.
  • If you are incredibly lucky, Eclipse will compile the project automatically now. If so (I'm being very optimistic), Choose Run/Run Configurations from the main menu and you should see ApplicationRunner? under the Java Application item in the tree. If you select that and hit run and by some miracle all of the above worked, it'll launch Hermes!