Configuring C/C++ Builds

Overview

When a C/C++ project is created for ESbox, most projects will have autotools and Make builders assigned. The autotools builder will run autogen.sh or autoconf and then the generated configure script. The Make builder, will then run make on the generated or pre-written top-level Makefile in the project.

Make Builder Settings

The Make builder may be configured for the project so that other Makefiles can be invoked or other targets can be selected for common Eclipse build actions. Consult the Project > Properties > C/C++ Build Settings page to see the settings.

Build Command is the command that runs "make". When Use default is set, "make" is invoked. You may override this to run a different make or to run make with different options. (This is modified when importing from Debian packages to invoke fakeroot debian/rules, for instance.)
Stop on first build error corresponds to the "-k" option to make. If you use a custom build command, you will need to provide this option yourself in Build command.
Build on resource save (Auto Build) selects the Makefile target invoked when you make ordinary file changes in Eclipse and the Project > Build Automatically option is enabled. This target may be blank.
Build (Incremental Build) selects the Makefile target invoked when you invoke an ordinary Build in Eclipse (Project > Build, build before launch, build after cleaning a project, etc). This target may be blank.
Clean selects the Makefile target invoked when you clean a project in Eclipse (Project > Clean, etc). This target may be blank, but probably shouldn't be.
Build location is the location, typically relative to the project, where the build command is launched. You may use this to build inside a large project, for instance. Note: this also affects the autotools builder.

Using Debian source projects

When a project is imported from a Debian project, only a Make builder is used, and fakeroot debian/rules is used as the Build command. This file will itself run autotools commands, so the Project > Build Application menu will not provide the autotools-related commands.

Rules selected for Build and Clean build types are derived from the Debian policy manual. If your project does not use these rules, you must edit them here.

If you wish to de-Debianize a project, check Use default for the Build command. You may also need to convert the project to use the Autotools builder.