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 Luna 4.4.1 from the Eclipse download page. The download page offers several different variants of Eclipse; you want the Eclipse Modeling Tools, as they come with many of the features required for KIELER development already installed. Once Eclipse is installed and started, you need to install the remaining features. For each of these steps, fire up the software installation dialog by clicking Install New Software... from the Help menu.

  1. From the Luna update site (should already be in the Work with list), choose the following components:
    1. Xtext Complete SDK
    2. MWE 2 language SDK
    3. MWE 2 runtime SDK
  2. If you are going to be working in the Semantics project, you may also have to install the following from the Luna update site:
    1. Xpand SDK
    2. MWE SDK

Now open up the Eclipse Marketplace from the Help menu and install the following plug-ins:

  1. Checkstyle Plug-in
  2. FindBugs Eclipse Plugin

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

If you are in charge of creating a new reference target platform, make sure to consider the (info) below.

Optional 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.

  1. SVG export functionality is based on the Batik Swing feature  from the Orbit update site. Make sure to install version 1.6 of the plug-in, not version 1.7.
  2. If you want to work on the Graphiti integration of KIELER Layout, install the Graphiti SDK Plus (info) from the Kepler update site.
  3. If you want to work on KlighDning (info), install the Jetty bundles from the Jetty update site. Currently we are using version 8 (which should be included in the Luna Release).
  4. If you want to work on KWebS (info), install the JAX-WS Tools from the Kepler update site.
  5. 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. Eclipse e4 Tools (Incubation)
    2. We originally also installed E4 CSS Spy (Incubation), but it installed keyboard shortcuts that somehow conflicted with Eclipse's built-in ones. This lead to common shortcuts such as Ctrl+Z and Ctrl+Space not working properly, which is why we don't install the CSS Spy for the time being.
  6. If you use some code from Subversion repositories, install the Subversive SVN Team Provider from the Kepler update site. You will be prompted to install a Subversive Connector upon restarting Eclipse; select one that fits to your installed SVN version. KIELER does not use Subversion anymore.
  7. Some plug-ins require Papyrus to be installed, which you should probably simply google for.
  8. Some deprecated dependencies (we don't work with these frameworks anymore):
    1. Graphical Editing Framework Zest Visualization Toolkit SDK
    2. Graphical Modeling Framework (GMF) Notation SDK
    3. Graphical Modeling Framework (GMF) Tooling SDK

Memory Problems

Regardless of the two methods you've decided on following, Eclipse may well run into problems due to lack of memory. If so, navigate to your installation directory, open eclipse.ini, and edit it to contain the following lines:

Code Block
languagenone
titleEclipse Configuration
--launcher.XXMaxPermSize 256M
--launcher.XXPermSize 64M
-Xmn128m
-Xmx768m

For more information about what these settings to, see this page.