Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Linux Tools Project/LTTng Eclipse Plug-in Development Environment Setup
This page describes how to setup LTTng Eclipse Plug-in development environment.
Contents
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.