Getting started

Version 23.1 by Lachlan Deck on 2009/09/01 14:10

Outline

Introduction

This guide is aimed at those who'd like to set up a local wolips development environment utilising maven and scm (git, svn).

Install Maven

You can download and install maven for most platforms here.

Success

Mac Tip

  install macports [http://www.macports.org/install.php], then on the terminal
  {noformat}sudo port install maven2{noformat}

  In future, to keep this up to date:
  {noformat}sudo port upgrade maven2{noformat}

Download Eclipse

Eclipse can be downloaded and installed from www.eclipse.org/downloads/. For mac it's just a simple matter of unpacking the zip file downloaded into /Applications or /Users/youraccount/Applications.

Success

Which one do I choose?

  Eclipse Classic (161MB) is a popular choice among WO developers.
  However, the more lightweight Eclipse IDE for Java Developers (91MB) should work.

Launch Eclipse

Open eclipse by double clicking on the application icon (from where you installed it).
LaunchEclipse.png

Eclipse will then ask you for the location of a 'workspace' which is where eclipse will store its metadata.
LaunchEclipseWorkspace.png

Eclipse plugins

Various plugins have prerequisites, and some are just useful anyway, so here's a suggested order of installing some useful plugins when setting up a brand new eclipse environment.

Step 1 - Choose the menu item: Help > install new software...

install_menu.png

This will open the install window:
install_window.png

Step 2 - install the testNG plugin (for a simple example)

a) Click the "Add..." button to define the update site, fill in the details, click OK.

addsite_testng.png

b) Tick the plugin fragments to install

fragments_testng.png

c) Click next repeatedly, confirming license agreements, finally clicking "Finish" to install.
d) after the software plugin has installed, it will prompt you for a restart of eclipse. Click Yes.

install_restart.png

e) after eclipse has restarted, continue...

Step 3 - install Groovy

Repeat step 2 with the following detail changes:
Site name: Groovy-dev
Site location: http://dist.codehaus.org/groovy/distributions/updateDev/

Step 4 - Install subversive connectors

Repeat step 2 with the following detail changes:
Site name: Subversive-connectors
Site location: http://community.polarion.com/projects/subversive/download/eclipse/2.0/galileo-site/
Fragments selected: 'Subversive SVN Connectors', 'SVNKit 1.3 Implementation (Optional)'

fragments_subversive.png

Step 5 - Install egit

Repeat step 2 with the following detail changes:
Site name: egit
Site location: http://www.jgit.org/updates

Step 6 - Install m2eclipse

Repeat step 2 with the following detail changes:
Site name: m2eclipse
Site location: http://m2eclipse.sonatype.org/update-dev/
Fragments selected: all fragments of 'Maven Integration'
fragments_m2eclipse.png

Step 6 - Install WOLips 3.5

Repeat step 2 with the following detail changes:
Site name: WOLips35
Site location: http://webobjects.mdimension.com/wolips/eclipse_3_5/
Fragments selected: all fragments of 'Maven Integration'
fragments_wolips.png