Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "Linux Tools Project/LTTng Eclipse Plug-in Development Environment Setup"

m
Line 4: Line 4:
  
 
Under eclipse.org downloads, select Eclipse Classic archive. Uncompress and
 
Under eclipse.org downloads, select Eclipse Classic archive. Uncompress and
start eclipse. Example for linux:
+
start Eclipse. Example for Linux:
  
 
  $ tar xzvf eclipse-SDK-3.7.2-linux-gtk-x86_64.tar.gz
 
  $ tar xzvf eclipse-SDK-3.7.2-linux-gtk-x86_64.tar.gz
Line 20: Line 20:
 
** In "work with:" dialog, select "--All Available Sites--"
 
** In "work with:" dialog, select "--All Available Sites--"
 
** Select "General Purpose Tools -> Remote System Explorer End-User Runtime"  
 
** Select "General Purpose Tools -> Remote System Explorer End-User Runtime"  
** Install the package. It's not necessary to restart eclipse at this point.  
+
** Install the package. It's not necessary to restart Eclipse at this point.  
  
 
* Antlr
 
* Antlr
Line 30: Line 30:
 
  http://download.eclipse.org/tools/orbit/downloads/drops/R20120119162704/repository
 
  http://download.eclipse.org/tools/orbit/downloads/drops/R20120119162704/repository
  
** Click ok, then search for Antlr package.
+
** Click OK, then select the Orbit repository in the drop-down list.
 
** Select "All Orbit Bundles -> ANTLR Runtime 3.2.0"
 
** Select "All Orbit Bundles -> ANTLR Runtime 3.2.0"
 
** Install the package.
 
** Install the package.
Line 46: Line 46:
 
Only projects related to LTTng 2.0 should be imported. For legacy LTTng, TCF
 
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
 
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.
+
LTTng will be soon deprecated, the procedure is limited to LTTng 2.0.
  
 
* Select "File -> Import..."
 
* Select "File -> Import..."
 
* Select "General -> Existing Projects into Workspace"
 
* Select "General -> Existing Projects into Workspace"
 
* Select the lttng root directory: workspace/org.eclipse.linuxtools/lttng
 
* Select the lttng root directory: workspace/org.eclipse.linuxtools/lttng
* Then disable all projects org.eclipse.linuxtools.lttng.*  
+
* Then disable all projects org.eclipse.linuxtools.lttng.* (keep the *.lttng2.* ones)
 
* Click Finish.  
 
* Click Finish.  
 
* Rebuild the workspace.
 
* Rebuild the workspace.
Line 57: Line 57:
 
= Step 5 - Define API baseline =
 
= Step 5 - Define API baseline =
  
Eclipse may complain about missing API baseline. If so, do the following:
+
Eclipse may complain about a missing API baseline. If so, do the following:
  
 
* Select "Window -> Preferences -> Plug-in Development -> API Baselines"
 
* Select "Window -> Preferences -> Plug-in Development -> API Baselines"

Revision as of 19:50, 18 April 2012

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 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 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 the *.lttng2.* ones)
  • Click Finish.
  • Rebuild the workspace.

Step 5 - Define API baseline

Eclipse may complain about a 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.

Back to the top