Setting up the Eclipse Environment

Eclipse Environment

Archi is built upon the Eclipse Rich Client Platform (RCP) version 3.8 and is also developed in the Eclipse Integrated Development Environment (IDE). This section deals with setting up the Eclipse IDE ready for development.

Important! Archi is built and deployed using Eclipse version 3.8.x. There is a later version of Eclipse (4.2.x) available, but the 4.x versions of Eclipse are incompatible with Archi as the "Backwards Compatibility Layer" is buggy. For the immediate future, Archi will be built using Eclipse 3.8.x.

Make sure you have a Java JDK installed

Eclipse runs on top of Java so you need to ensure that you have installed the Java Development Kit (JDK). You can download this from here. Make sure you choose the right version for your platform. Mac users will have to install it from Apple, whilst Linux users may prefer to install OpenJDK from their Install Manager. Java JDK 6 is preferred.

Download Eclipse and the Delta Pack

Download the following files from Eclipse Downloads.

Eclipse SDK
The Eclipse SDK includes the Eclipse Platform, Java development tools, and Plug-in Development Environment, including source and both user and programmer documentation. Choose the version for your operating system.

Delta Pack
The Delta Pack is an add-on pack that allows you to build and compile for Operating Systems other than the one on which you are developing. The same version can be used on all platforms.

Creating the Eclipse Installation

  1. Extract the Eclipse SDK files somewhere on your development machine. This will create an "eclipse" folder
  2. Create a sub-directory of the "eclipse" folder called "delta-pack" and extract the Delta pack to to it. So if your installation directory is c:\eclipse then it should look like the following:

Launching and setting up Eclipse

  1. Launch Eclipse from the "eclipse" executable file in the "eclipse" folder
  2. You will be asked to select a "Workspace". If you're not sure, select the default and check "Use this as the default and do not ask again"
  3. Dismiss the Welcome Screen
  4. Set up Eclipse just how you would like to work with it. See here for more details or search Help within Eclipse

Set up the Target Platform to include the Delta Pack

Now you need to tell Eclipse the location of the Delta Pack.

  1. Open up Eclipse's Preferences (Window -> Preferences on Windows)
  2. Go to the "Plug-in Development -> Target Platform" tab
  3. Edit the Active Target
  4. Add the directory where you added the Delta Pack


Ensure that you set Eclipse to use the Java JDK installed on your system, otherwise you won't be able to debug Java code. Set this up in Preferences, Java, Installed JREs and add the JDK.


Adding additional libraries

You will need to set up your Eclipse installation with three more Eclipse add-ons:

You can add these libraries from within Eclipse itself:

  1. Choose Help-->Install New Software... to invoke the wizard
  2. In the "Work with" combo box select "Juno -"
  3. Wait for the dialog list to populate (You will see a "Pending..." message. Sometimes this can take a long time...)
  4. From the list under "Collaboration" select "Eclipse EGit"
  5. From the list under "Modeling" select "EMF - Eclipse Modeling Framework SDK", "Graphical Editing Framework GEF SDK" and "Graphical Editing Framework Zest Visualization Toolkit SDK"
  6. Click "Next" and Accept all terms to Finish the wizard.
  7. Note - sometimes this can take a long time...keep trying...
  8. The libraries should then be installed and you will need to restart Eclipse

Now you are ready to move onto the next stage, Importing the Code.