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

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

Step 1 - 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

Step 2 - 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 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.

Step 3 - 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

Step 4 - Import LTTng projects into the workspace

Only projects related to LTTng 2.0 should be imported. For legacy LTTng, TCF dependency is also required. To avoid this dependency and because the legacy LTTng will be soon 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 projects org.eclipse.linuxtools.lttng.* (keep *.ctf.* *.tmf* and *.lttng2.* ones)
• Click Finish.
• Rebuild the workspace.

Step 5 - Define 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.