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

This page describes how to setup LTTng Eclipse Plug-in developement 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..."
  • In "work with:" dialog, select "--All Available Sites--"
  • 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 search for Antlr package.
  • 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 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 depricated, 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.*
• Click Finish.
• Rebuild the workspace.

Step 5 - Define API baseline

Eclipse may complain about missing API baseline. If so, do the following:

• Select "Window -> Preferences -> Plug-in Development -> API Baselines"
• Click on "Add Baseline..."
• Enter some name and click on "reset"
• Click "Finish"
• Rebuild the workspace

The environment should be set at this point.