Linux Tools Project/LTTng Eclipse Plug-in Development Environment Setup

This page describes how to setup LTTng Eclipse Plug-in development environment.

Get the Eclipse SDK

Under eclipse.org downloads, select Eclipse Classic archive. Uncompress and start Eclipse. Example for Linux:

$ tar xzvf eclipse-SDK-3.7.2-linux-gtk-x86_64.tar.gz
$ cd eclipse
$ ./eclipse

Install dependencies

Two dependencies are required: Remote System Explorer (RSE) and Antlr. Here is how to install them. Notice that RSE is named Target Management on the Eclipse website.

• RSE
  • Select "Help -> Install New Software..."
  • Select the current Eclipse release repository (e.g. Indigo)
  • Select "General Purpose Tools -> Remote System Explorer End-User Runtime"
  • Install the package. It's not necessary to restart Eclipse at this point.

• Antlr
  • Select "Help -> Install New Software..." again
  • Click on "Available Software Sites"
  • Search for the Orbit repository.
  • If more than one site appears, select the latest one. The procedure has been tested with this URL:

http://download.eclipse.org/tools/orbit/downloads/drops/R20120119162704/repository

• • Click OK, then select the Orbit repository in the drop-down list.
  • Select "All Orbit Bundles -> ANTLR Runtime 3.2.0"
  • Install the package.
  • Restart Eclipse.

Get the source code for org.eclipse.linuxtools

Use your git client (or better yet, use EGit) to clone the source repository in your workspace.

$ cd workspace
$ git clone git://git.eclipse.org/gitroot/linuxtools/org.eclipse.linuxtools.git

Import LTTng projects into the workspace

Only projects related to LTTng 2.0 should be imported. For legacy LTTng, a TCF dependency is also required. To avoid this dependency and because the legacy LTTng will soon be deprecated, the procedure is limited to LTTng 2.0.

• Select "File -> Import..."
• Select "General -> Existing Projects into Workspace"
• Select the lttng root directory: workspace/org.eclipse.linuxtools/lttng
• Then disable all org.eclipse.linuxtools.lttng.* projects (keep the *.ctf.*, *.tmf* and *.lttng2.* ones)
• Click Finish.
• Rebuild the workspace.

Define an API baseline

Eclipse may complain about a missing API baseline. These errors can be safely ignored by performing this procedure:

• Select "Window -> Preferences -> Plug-in Development -> API Baselines"
• Under "Options -> Missing API baseline:" select "Ignore"
• Click "OK"

The environment should be set at this point.

Run the plugins

To run the code, right-click one of the imported plugins (for example, the o.e.l.tmf.core one) and select "Run As..." -> "Eclipse Application". This will start a nested Eclipse with the plugins loaded.