1. GumTree Development Environment Setup Windows Only Compatible with Eclipse 3.2 M3 (Last update: 16/11/05)

2. Prerequisite J2SE Development Kit (JDK) 5.0 installed  http://java.sun.com/j2se/1.5.0/download.jsp http://java.sun.com/j2se/1.5.0/download.jsp Network access to Sourceforge CVS  Either in pserver protocol or extssh protocol GumTree committers only:  GumTree Project account on Sourceforge

3. Download Files Download Eclipse 3.2 M3 SDK for Windows  http://download.eclipse.org/eclipse/downloads/drops/ S-3.2M3- 200511021600/download.php?dropFile=eclipse-SDK- 3.2M3-win32.zip http://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 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 http://gumtree.sourceforge.net/files/GumTreeExternalPluginPack (win32).zip

4. 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

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

7. 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!

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

9. Also extract GEF SDK to c:\gumdev

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

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

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

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

14. This is the Java perspective in the Eclipse workbench.

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

16. Select Java -> Complier On the right hand side, change Complier compliance level to 5.0

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

18. Click Add to introduce a new Java Virtual Machine location.

19. Type jdk1.5 as in the name box Then click Browse… for selecting JDK location

20. 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

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

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

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

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

25. Click “Browse” to import a team project set file

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

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

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

29. 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

30. 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.

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

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

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

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

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

36. lib is now properly grouped under GumTree-Lib

37. 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.

38. Click on Builders, and make sure CodeLib is selected.

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

40. Continue to import GumTree Platform Team Project Set to our workspace

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

42. 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……

43. 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.

44. Select Project -> Clean…

45. Click “Clean all Project” and OK

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

47. 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…”.

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

49. Move GumTree-Platform to top level

50. 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.0 to C:\gumdev\gumtree\features

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

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

53. Select a launch configuration called “GumTree_for_windows”

54. Click Run

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

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