Eclipse SCons Usage Guide

HTTP://SCONSOLIDATOR.COM/PROJECTS/SCONSOLIDATOR/WIKI/GETTING_STARTEDADD scons support to an existing project

To add scons support to an existing/C + + project, just right click on the project (s) in the Project Explorer and choose O NE of the following submenus of SCons:

• Use self-provided scons build (aka "Existing Mode") for projects where you provide the SCons build files
• Use generated scons build (aka "managed Mode") for projects where Sconsolidator should create and update the SCons build files

Notice that's should use managed for simple C + + projects only. It can be considered as a good the starting point if is not the yet familiar with SCons. As soon as your projects grow in size and complexity, you want to use your own provided scons build files.

For non-c/c++ projects, you are only having one menu named Add sconssupport.

Building Projects with SCons

If you request a build, the output of a scons build run was shown in a project specific console. Compile errors is shown in red and hyperlinks is provided to directly jump to the location of the editor where the error was found by the compiler. Error markers is created for the compiler errors as we is used from Eclipse.

Target View

SCons Target view shows all the scons projects in the current workspace and allows your maintain the targets on a projec T level. To request a builds for a specific target, you have to select it in the view and click the Build button in the upper right Corner. The same can achieved for a build in the interactive console.

There is a dialog to create a new target for a scons project. There you can define the name of the target and additional scons options which would be used when SCons was invoked. Furthermore, you can also specify a target alias which are also shown in the target view.

Dependency View

The dependency view visualizes the dependencies of the selected target scons has emitted. You can choose a target of a scons project in the workspace with a click on the "lookup symbol in the" upper right corner. The dependencies is then shown in the graph area.

C + + specific support

Create new SCons based C + + Managed Project

To create a new scons based project, you can use the New Project Wizard of Eclipse and choose C + + project . There you can see three new project types for scons managed projects: executable, shared library and static Library Project.

Sconsolidator also provides a facility to convert existing managed projects to scons projects with a context menu on the P Roject level (scons, Add sconssupport), and with a wizard as shown in the this figure.

Import of Existing SCons based C + + Project

Sconsolidator helps you to import existing scons based C + + projects with a wizard. You can choose the location where the code of the existing project is located. If The location contains a Eclipse project, the name of the project is deduced and shown in the corresponding input field . In case you want to set further options for the initial scons run and you have the possibility to put them in the field S Cons options. Sconsolidator would and try to gather all include paths and macros of your project necessary for the CDT indexer to proper Ly work and store them in the project settings.

Refresh Sconsolidator After altering the scons build

Sconsolidator helps you to keep the build settings of your scons build consistent with your Eclipse CDT project by (One-wa Y) synchronizing the used include paths and macros. Whenever you changed your scons build in a-a-the-affects-used include paths or macros, click on the icon with the S Witzerland flag in the toolbar or use the project context menu to Refresh C + + project from SCons of Sconsolidator. Both actions run your scons build and collect all the necessary information for Eclipse CDT to work as expected.

Interactive Console

To build single targets without the need to invoke full builds with every change, we provide a interactive console with S Consolidator where you had all of the possibilities known from scons ' interactive mode. We allow building and cleaning of the corresponding target (s) for the source file currently loaded in the active editor an D A redo of the last action as can is seen from the buttons. Of course, you can also type scons commands in the interactive console directly.