Setting up the 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.
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.
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.
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
- Extract the Eclipse SDK files somewhere on your development machine. This will create an "eclipse" folder
- 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
- Launch Eclipse from the "eclipse" executable file in the "eclipse" folder
- 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"
- Dismiss the Welcome Screen
- 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.
- Open up Eclipse's Preferences (Window -> Preferences on Windows)
- Go to the "Plug-in Development -> Target Platform" tab
- Edit the Active Target
- Add the directory where you added the Delta Pack
Adding additional libraries
You will need to set up your Eclipse installation with three more Eclipse add-ons:
- EGit - The Eclipse Git support
- Graphical Eclipse Framework (GEF) - Performs drawing in the Archi Views
- Graphical Editing Framework Zest Visualization Toolkit SDK
- Eclipse Modelling Framework (EMF) - Manages the domain model
You can add these libraries from within Eclipse itself:
- Choose Help-->Install New Software... to invoke the wizard
- In the "Work with" combo box select "Juno - http://download.eclipse.org/releases/juno"
- Wait for the dialog list to populate (You will see a "Pending..." message. Sometimes this can take a long time...)
- From the list under "Collaboration" select "Eclipse EGit"
- From the list under "Modeling" select "EMF - Eclipse Modeling Framework SDK", "Graphical Editing Framework GEF SDK" and "Graphical Editing Framework Zest Visualization Toolkit SDK"
- Click "Next" and Accept all terms to Finish the wizard.
- Note - sometimes this can take a long time...keep trying...
- 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.