560 likes | 666 Views
GumTree Development Environment Setup. Windows Only Compatible with Eclipse 3.2 M3 (Last update: 16/11/05). Prerequisite. J2SE Development Kit (JDK) 5.0 installed http://java.sun.com/j2se/1.5.0/download.jsp Network access to Sourceforge CVS Either in pserver protocol or extssh protocol
E N D
GumTree Development Environment Setup Windows Only Compatible with Eclipse 3.2 M3 (Last update: 16/11/05)
Prerequisite • J2SE Development Kit (JDK) 5.0 installed • 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
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 • Download GEF 3.1 SDK with Examples • http://www.eclipse.org/downloads/download.php?file=/tools/gef/downloads/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 extractEclipse SDK 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.
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 -> Complier On the right hand side, change Complier compliance level to 5.0
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
Type jdk1.5 as in the name box Then 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.
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
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.
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.
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…”.
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