Using Eclipse for AVANGO development

For general build and installation information see Installation.

We support loading AVANGO into an Eclipse development environment. In the repository you can find the appropriate project files (.project and .cproject) on top-level. Currently the Eclipse support is organized in a way that the whole AVANGO software is managed in one Eclipse project. As a start we recommend to install the following environment:

Eclipse

• Eclipse IDE for C/C++ Developers  http://www.eclipse.org/downloads/

Plugins

• Pydev (v1.3.x or higher)  http://pydev.sf.net/
• Subclipse (v1.2.x or higher)  http://subclipse.tigris.org/
• Mylyn (v2.1.x or higher)  http://www.eclipse.org/mylyn/

Checkout

With this you can check out AVANGO by creating a new project via File > New > Other... > SVN > "Checkout Projects from SVN". Use repository location shown in the image below and select the trunk directory.

Note: For the initial checkout it might be better to deactivate the Project > Build Automatically option in advance to avoid building the project locally without using your individual environment defined in localdefs.py.

Build the project

First, ensure that all additional required libraries are installed on your system (see Installation). You can build the project by using one of the build configurations that will appear right after the checkout.

• build - executes scons all on top-level
• check - executes scons check on top-level
• install - executes scons install on top-level

The currently selected build configuration can also be triggered using the CTRL + B keyboard shortcut. For each submodule (e.g. avango-osg) own make targets exist with which you can invoke a more specified build process (see image below).

Using the build in debugger

To use the built in python debugger one must create a run config, by selecting Run Configurations... from the Play-Button dropdown menu.

In the upcomming dialog one has to configure all Environment Variables as needed. Make sure that the PYTHONPATH variable contains the entry of youre avango installation. For example /home/wschwan/worspace/avango_install/lib/python2.4. Setting the PYTHONPATH in the main tab issn't sufficient!

In the common tab mark the entrys for Debug and Run to allow quick access to the configurations from the Debug-Button and Run-Button dropdown menus.

To run the programm in debug mode select the created entry from the Debug-Button dropdown menu.

AVANGO Code Style

Developers submitting code are encouraged to follow the AVANGO code conventions. Therefore go to Window > Preferences > C/C++ > Code Style and import the following file:

Eclipse_Avango_C++_Code_Style.xml

Important Note

Since the svn:ignore property doesn't work for files which are under version control any local modification of the Eclipse project files .project and .cproject would be committed to the repository. Therefore please be careful on committing your changes on top-level.