GumTree Development Setup

From GumTree

NEW!! Powerpoint presentation for setting up GumTree development environment is now available here




Note: This setup instrument is for Windows perform ONLY. I assume both Eclipse and GumTree development workspace are located under a directory called c:\gumdev (stands for gumtree development). Of course, you can install Eclipse elsewhere if you wish. The current constrain is that the GumTree workspace should contain no space character. You will need JDK1.5 for developing GumTree.

Contents

Eclipse Installation

  • Download Eclipse 3.1 SDK for Windows: here, and extract to c:\gumdev.
  • Download GEF 3.1 SDK with Examples: here, and extract to c:\gumdev.
  • Download GumTree Basic External Plug-in Pack: here, and extract to c:\gumdev.

Configure Eclipse for GumTree Development

  • Launch Eclipse from c:\gumdev\eclipse\eclipse.exe and set your workspace to c:\gumdev\gumtree\plugins
  • Create a new JRE definition (Window->Preferences->Java->Installed JREs), and select your JDK directory for the new definition. For Windows platform, the default location of JDK should be c:\program files\java\jdk1.5.0_0x.
  • Set JDK Compliance to 5.0 (Window->Preferences->Java->Compiler)

Check up GumTree Common Library from CVS

  • Switch to Java Perspective. From the Package Explorer, import http://gumtree.sourceforge.net/files/GumTree-Lib(pserver).psf as a Team Project Set. Do not create working set as this stage. You need your sourceforge or boson CVS login and password be ready with you.
  • Select "Show" from the Package Explorer's menu and change from "Projects" to "Working Sets"
  • Open "Select Working Sets" dialog from the Package Explorer, and create a new Java working set GumTree-Lib. Include any plugin that you have imported from the previous Team Project Set file in your new working set
  • Ensure copy_lib.xml is automatically launched (by right click and lib project - > select properties -> select Builders -> see if all builders are checked). It should copy lib folder to c:\gumdev\gumtree\lib. If not, use clean on yout lib project (Project->clean..)

Check up GumTree-Platform from CVS

  • Like checking out GumTree Common Library, this time uses http://gumtree.sourceforge.net/files/GumTree-Platform(pserver).psf
  • Put those newly imported plugins to a new working set called GumTree-Platform
  • Make sure copy-feature.xml and copy_required_plugins.xml under org.eclipse.rcp-feature work in automatic build. If they work, you will see a folder calls org.eclipse.rcp under c:\gumdev\gumtree\features, and a set of Eclipse plugins under c:\eclipse\gumtree\plugins
  • Also check the following ANT script are activated during autobuild
    • copy-feature.xml from org.gumtree.gumzilla-feature
    • copy-feature.xml from org.gumtree.platform-feature