|
|
(39 intermediate revisions by 8 users not shown) |
Line 1: |
Line 1: |
− | This page describes how to setup LTTng Eclipse Plug-in development environment.
| + | The Eclipse LTTng (and related) plugins have moved to the [http://eclipse.org/tracecompass Trace Compass] project. Updated instructions can now be found on [[Trace_Compass/Development_Environment_Setup | this page]]. |
− | | + | |
− | = 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 (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 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.
| + | |