GumTree Development Environment Setup

Windows Only

Compatible with Eclipse 3.2 M3

(Last update: 16/11/05)

Prerequisite

• J2SE Development Kit (JDK) 5.0 installedhttp://java.sun.com/j2se/1.5.0/download.jsp

• Network access to Sourceforge CVSEither in pserver protocol or extssh protocol

• GumTree committers only:GumTree Project account on Sourceforge

Download Files

• Download Eclipse 3.2 M3 SDK for Windowshttp://download.eclipse.org/eclipse/downloads/

drops/S-3.2M3-200511021600/download.php?dropFile=eclipse-SDK-3.2M3-win32.zip

• Download GEF 3.1 SDK with Examples http://www.eclipse.org/downloads/download.php?file=/tools/gef/d

ownloads/drops/R-3.1-200507071758/GEF-ALL-3.1.zip

• Download GumTree External Plug-in Pack for Windows http://gumtree.sourceforge.net/files/

GumTreeExternalPluginPack(win32).zip

Project Sets

• Download GumTree Common Library Project Set Committer (password required):http://gumtree.sourceforge.net/files/GumTree-Lib(extssh).psf

General (no password):http://gumtree.sourceforge.net/files/GumTree-Lib(pserver).psf

• Download GumTree Platform Project Set Committer (password required):http://gumtree.sourceforge.net/files/GumTree-Platform(extssh).psf

General (no password):http://gumtree.sourceforge.net/files/GumTree-Platform (pserver).psf

General Instructions

• General Instructions can be found here:http://gumtree.sourceforge.net/wiki/index.php/

GumTree_Development_Setup

Checklist

• JDK5 installed

• Eclipse SDK 3.2 M3, GEF SDK 3.1, and GumTree External Plug-in pack has been downloaded

• Team project set for GumTree Common Library and GumTree Platform has been downloaded

• Sourceforge user login and password ready (committer only)

Let’s Rock ‘n’ Roll!

Assume we use c:\gumdev as our development folder.Let’s extract Eclipse SDK to c:\gumdev

Also extract GEF SDK to c:\gumdev

Finally extract GumTree External Plug-in Pack to c:\gumdev

After extraction, open directory c:\gumdev\eclipse, and launch eclipse.exe

Eclipse requires users to specify a workspace. For GumTree development, type c:\gumdev\gumtree\plugins as our workspace. Click OK to continue.

Intro screen in Eclipse is opened by default. Click the icon at the upper right corner to continue.

This is the Java perspective in the Eclipse workbench.

GumTree leverages the latest J2SE5.0 features. Eclipse needs to be configured to support those.Select Window -> Preferences... to open the setting dialog.

Select Java -> ComplierOn the right hand side, change Complier compliance level to 5.0

Select Java -> Installed JREsSome build operations in GumTree use utilities from the JDK package. We should change the default Eclipse JRE from normal JRE to JDK

Click Add to introduce a new Java Virtual Machine location.

Type jdk1.5 as in the name boxThen click Browse… for selecting JDK location

By default, JDK5 should be installed to C:\Program Files\Java\jdk1.5.0_xx for the Windows platform.Select that fold and click OK

Select jdk1.5 as the default JRE, and click OK to close dialog

Eclipse will warn you about changes to the complier. Click Yes to continue.

Now we need to import some projects to start our development.Select “Import…” from the File menu.

Select “Team Project Set” from the dialog and click Next.

Click “Browse” to import a team project set file

We should first import Browse and select GumTree-Lib(extssh).psf

After importing the GumTree Lib team project set, click Finish to continue. DO NOT click on “Create a working set…”

If you are using the extssh team project set, you will require souceforge user login and password.Click save password for your convenience.

If you are using the pserver team project set, you will not be asked for password. Please wait until the project is loaded to your workspace

Project “lib” (plus several others) should be loaded in your workspace. Eclipse provides a way to group multiple projects under a single folder (working set). Let’s us select lib project first.

Click on the inverted triangle on the right upper corner of the Package Explorer. Select Show -> Working Sets

A Select Working Sets dialog appears, and let’s click New to add a new working set.

Type GumTree-Lib for our GumTree Common Library working set. The lib project should be checked as well.Click Finish to continue

To arrange our new working set in a proper order, select GumTree-Lib and click Up to swap display order.

GumTree-Lib should now be our first project. Click OK to continue

lib is now properly grouped under GumTree-Lib

By default, Eclipse will copy the lib directory to other directory by an ANT builder. In some occasions, Eclipse may not do this automatically. To check if Eclipse does the job, select lib project, right click and select Properties.

Click on Builders, and make sure CodeLib is selected.

Also, if the ANT script is running correctly, lib project should be copied to C:\gumdev\gumtree

Continue to import GumTree Platform Team Project Set to our workspace

This time we import GumTree-Platform(extssf).psf (or GumTree-Platform(pserver).psf for non committers)

GumTree Platform is BIG in size. Please allow Eclipse some time to fetch all projects to your workspace. It’s now for us to take a coffee……

Eclipse will start to build GumTree once all projects has been checked out. You will see lots of compilation errors at the beginning. DO NOT PANIC.

Select Project -> Clean…

Click “Clean all Project” and OK

All projects should be compiled. If problem raises, please contact us by email: gumtree-developer@lists.sourceforge.net

Let’s create a new working set for the GumTree Platform projects.Firstly, select everything under “Other Projects”, and then open the menu in Package Explorer and select “Select Working Sets…”.

Add new working set, and name it as GumTree-Platform

Move GumTree-Platform to top level

Like lib project, projects in the GumTree Platform run several ANT scripts to copy folders outside of our workspace.By default, Eclipse copies:•org.eclipse.rcp_3.1.0•org.gumtree.gumzilla_1.0.0•org.gumtree.platform_1.0.0to C:\gumdev\gumtree\features

Also, it copies a number of Eclipse plug-ins to C:\gumdev\gumtree\pluginsIf you don’t see those plug-ins in place, please check the project properties in org.eclipse.rcp-feature

We are only ready to run GumTree!Move your mouse cursor to “Run” cool bar tool.

Select a launch configuration called “GumTree_for_windows”

Click Run

A login dialog should appear if GumTree is launched successfully.Click login to continue.

GumTree is now running on your machine. Have fun!!