Setting up the Eclipse Environment

Eclipse Environment

Archi is built upon the Eclipse Rich Client Platform (RCP) version 4.6 (Neon) and is also developed using 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. Linux users may prefer to install OpenJDK from their Install Manager. JDK 8 is the minimum version supported.

Download Eclipse

Download an Eclipse IDE version 4.6 (Neon) from Eclipse Downloads. Ensure that you download a package that is correct for your OS and includes the Git client.

Setting up Eclipse

  1. Extract the Eclipse IDE files somewhere on your development machine. This will create an "eclipse" folder

  2. Launch Eclipse from the "eclipse" executable file in the "eclipse" folder

  3. 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"

  4. Dismiss the Welcome Screen

  5. Set up Eclipse just how you would like to work with it. See here for more details or search Help within Eclipse


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 plug-ins

You might want to set up your Eclipse installation with more Eclipse plug-ins. Some Eclipse packages don't include the Git client. If this is the case you can add more plug-ins to your Eclipse IDE.

You can add these plug-ins from within Eclipse itself:

  1. Choose Help-->Install New Software... to invoke the wizard

  2. In the "Work with" combo box select "Neon -"

  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 Git Team Provider"

  5. Click "Next" and Accept all terms to Finish the wizard.

  6. Note - sometimes this can take a long time...keep trying...

  7. The libraries should then be installed and you will need to restart Eclipse

Next Steps

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