Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 31 Next »

To start working on KIELER, you will need an Eclipse installation, configure it correctly, and import all the necessary projects. Choose one of the options below and run with it.

Which Java Version Do I Need?

Java 8. The KIELER project has started using Java 8 features, such as lambda expressions and the stream API.

Oomph Setup

Pragmatics Only

We currently only have a setup for developers working on the Pragmatics team. We will at some point also add Semantics support.

This is the easiest way, and is recommended for everyone.

  1. Go to this site and download the Eclipse Installer for your platform. You will find the links at the bottom of the "Try the Eclipse Installer" box.
  2. Start the installer. You should see something like this:

    Click the Hamburger button at the top right corner and select Advanced Mode. Why? Because we're computer scientists, that's why!
  3. Oomph now wants you to select which Eclipse distribution you want to use to develop KIELER in. Select the Eclipse Modeling Tools and click Next.
  4. Next, we need to tell Oomph to get everything ready for KIELER development. Download our Oomph setup file, click the Plus button at the top right corner and add the setup file to the Eclipse Projects catalog. Double-click the new KIELER entry. This will cause an item to appear in the table at the bottom of the window. The Stream column entry can be edited to choose which part of KIELER you want to work on. Once you're done, click Next.
  5. Oomph now asks you to enter some more information. You can usually leave the settings as is, except for the Installation folder name. This will be the directory under which all your Eclipse installations installed with Oomph will appear, each in a separate sub-directory. Select a proper directory and click Next.

    Separate Installations?

    This is the part that veteran Eclipse developers will find strange. In the Oomph world, there is no one big Eclipse installation anymore. Instead, we simply use one installation for each project we're working on, completely self-contained in a folder that also contains the workspace and all required Git repositories. If something goes wrong, simply delete the whole folder and install a new Eclipse using Oomph.
    Having multiple Eclipse installations isn't even a problem in terms of disk space. Each installation is very lightweight, because all features and plug-ins used are saved in a centralized bundle pool (usually something like ~/.p2), which keeps each installation very small.
  6. Oomph now displays a summary of what will happen once you click Finish. Ignore it and click Finish.
  7. Once the basic installation is complete, your new Eclipse will start (at this point, you can safely close the Oomph dialog). Now, Oomph will try (and probably fail) to clone all required Git repositories. The Eclipse window will look something like this (once you've closed the Welcome page):

    Note the icon at the bottom with the error marker. It tells you that something went wrong during the Oomph setup.
  8. The problem is that Eclipse doesn't know which SSH key to use to clone the repositories. Go to the Eclipse preferences and navigate to General -> Network Connections -> SSH2. Add the private key you want to use to connect to our repositories and click OK.
  9. You will now need to retry the failed Oomph setup steps. Either click on the Oomph setup icon at the bottom of the Eclipse window (if it's still there), or select Perform Setup Tasks from the Help menu. The dialog shows the failed setup tasks. Click Back, Next, and Finish to retry them all.

Manual Installation

If you want to install Eclipse on your own computer without using the Oomph setup, just expand the installation guide below. On Windows, double-click the eclipse.exe found in the installation directory. On Linux, execute the eclipse executable found in the installation directory.

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
  3. From the Itemis update site, install the following:
    1. Xtext Antlr SDK Feature

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

Working on the Institute Server

Deprecated

This is not supported anymore. We will remove this section sometime soon.

You can use the reference installation of Eclipse on the institute server. Just log in (institute account, using your "mail-password") and start Eclipse using the following command line:

   /home/java/eclipse-modeling/eclipse

This  will always point to the current reference installation. Feel free to setup a link on your desktop to avoid having to start the console every  time.

For developers in the semantics section it might be interesting to choose the eclipse version by themselves from the versions provided in /home/java, especially in case pragmatics has turned to a new eclipse version, but semantics has not followed yet.

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:

Eclipse Configuration
--launcher.XXMaxPermSize 256M
--launcher.XXPermSize 64M
-Xmn128m
-Xmx768m

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

  • No labels