Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleClick here to expand the installation guide...

The first step in getting your own Eclipse installation is to download Eclipse Indigo 3Juno 4.72.21 from the Eclipse download page. The download page offers several different variants of Eclipse; you want the Eclipse Modeling Tools, as they come with most of the features required for KIELER development. Once Eclipse is installed and started, there are two ways to install the remaining features: the (recommended) automatic way, and the manual way.

Automatically Installing the Remaining Features

The automatic installation basically uses a description of our reference Eclipse installation to bring your own installation to the same state. Follow these steps:

  1. Download our reference installation file.
  2. In Eclipse, choose Import... from the File menu. The import wizard should be displayed.
  3. From the Install category, choose Install Software Items from File and click Next.
  4. As the description file, select the one you've just downloaded.
  5. The list should now display a bunch of features. Make sure they are all selected, except for the Eclipse Modeling Tools – your Eclipse download already had them.
  6. Make sure to disable the check box Install latest version of selected software. This might seem silly, but some of the plug-ins you're about to install don't play well with the latest versions of other plug-ins you're about to install.

  7. Click Next and wait for the wizard to collect all the installation details. This could take a while, so use the opportunity to visit your long-neglected relatives in New Zealand.

  8. Once your relatives have finished telling you how tall you've grown since they've last seen you, the wizard will ask you to review the changes that it will apply to your installation. Confirm them by clicking Next, accept the license agreements and click Finish. This could again take a while, so go out and finally do that thing you've always wanted to do since you were a child.

  9. Once you've finally done that thing and realized that it wasn't what you had expected, restart Eclipse and configure your installation according to our configuration guidelines.

If the installation fails because of some version problems, try to uncheck the option Install latest version of selected software in the Install Software Items from File wizard. Some of the plug-ins we're installing have been known to not play well with the latest versions of other plug-ins in the past.

Manually Installing the Remaining Features

If you have a problem with automatic installation procedures or the installation for some reason didn't work for you, install the required features manually. Warning:

  • Install Xpand/Xtend and Xtext Antlr via their update site.
  • Install Xtext and Xtend (in a newer version, which is installed alongside the old version) via their update site.
  • Install Checkstyle via its update site.
  • Install Find Bugs via its update site.
  • Install Google Guava via its update site. Make sure to install version 10.0.1 of the Runtime and SDK; Xtext 2.2.1 doesn't work with version 11 of the libraries.
  • If you need SVN access, install Subversive via its update site (from the Subversive SVN Team Provider Plugin (Incubation) category, choose Subversive SVN Team Provider (Incubation)). For some reason, the version of Subversive bundled with the current Eclipse release is too old for the current versions of the SVN connector plug-ins required to actually use Subversive. If you don't install a more recent version, a dialog will always pop up when starting Eclipse asking you to install a proper SVN connector, which will always fail due to unsatisfied dependencies.
  • fter

    this is going to take quite a while. For each of these steps, fire up the software installation dialog by clicking Install New Software... from the Help menu.

    1. From the Juno update site (should already be in the Work with list), choose the following components:
      1. Xpand SDK
      2. Xtext SDK
      3. Xtend SDK
      4. Graphical Editing Framework Zest Visualization Toolkit SDK
      5. JAX-WS Tools
      6. MWE 2 language SDK
      7. MWE 2 runtime SDK
      8. MWE SDK
      9. EMF Compare SDK
      10. Graphiti SDK Plus (Incubation)
      11. Graphical Modeling Framework (GMF) Notation SDK
      12. Graphical Modeling Framework (GMF) Tooling SDK
      13. Optional: Subversive SVN Team Provider (You will be prompted to install a Subversive Connector upon restarting Eclipse. SVN Kit 1.3.7 works fine.)
    2. From the Itemis update site, install the following:
      1. Xtext Antlr SDK Feature
    3. From the Checkstyle update site, install the following:
      1. Eclipse Checkstyle Plug-in
    4. From the FindBugs update site, install the following:
      1. FindBugs Feature
    5. From the Google Guava update site, install the following:
      1. Guava: Google Core Libraries for Java 1.5 - SDK
    6. If you're interested in e4 application development, install the following from the e4 update site: (If you don't know what e4 application development is, odds are you won't need these.)
      1. E4 CSS Spy (Incubation)
      2. Eclipse e4 Tools (Incubation)

    After everything is installed, restart Eclipse and configure your installation according to our configuration guidelines.

    Esoteric Dependencies

    Some projects require a bunch of more esoteric dependencies. For each one of them, make sure you actually work with a given project and then install the required dependencies only if necessary.

    Some plug-ins use the Graphiti framework, which can be installed from this update site.

    . Note: This list has not yet been updated for Eclipse 4.2.1. If this doesn't work, find an adult!

    1. Required for KEV: Install the missing Batik Swing plug-in from the Orbit update site. Make sure to install version 1.6 of the plug-in, not version 1.7.The ...kiml.zest plug-in depends on the Zest Visualization Toolkit SDK, which can be found on the Indigo update site.
    2. Some plug-ins require Papyrus to be installed, which is available via the Indigo update site.

    ...