Workbench Project Builder Commands

Workbench provides project build commands in two menus: the Project menu and a contextual menu on the Project Navigator. These commands are the standard project builder commands defined by Eclipse. Wind River provides additional build commands as well.

Project Menu

The Project menu on the menubar defines the standard Eclipse project build commands with the standard semantics. Specifically, these commands operate based on the build history, that is, they perform their action only if necessary so you will not see any effect if you invoke any one of them immediately in succession.

For example, Build Project will only actually invoke the builder if no previous build succeeded. In fact, the Build Project command will be disabled whenever it previously succeeded and nothing has changed to make another build necessary.

The Workbench Application Development perspective extends the Project menu with additional build commands. These enhancements appear in the next section down in the menu, as shown in the following figure:

wrs menubar project builder menu

"Rebuild Project" and "Clean Project" are convenience commands that apply to the currently active Workbench project. The Clean Project command simply cleans the project, like the standard command, but does not offer the option to clean more than that one project, unlike the standard command. The Rebuild Project command first performs a Clean Project and then a build.

Contextual Menu

The contextual menu of the Workbench Project Navigator includes the standard Build Project command, as shown below. Note that this is the same command as in the Project menu so it will be disabled when a build is not necessary.

wrs contextual project builder menu

Sample Build Result

As the project builder executes, the steps are displayed in the Build Console. The following figure shows the console content after a successful build.

successful build result displayed in Build Console

In this example we have a number of subdirectories for both source files and object files. The builder will traverse into these directories but does nothing there. These steps are shown in green. The actual Ada build steps occur after the subheading shown in blue titled "building Ada project MS1553_demo.gpr".

The first time you invoke the project builder on a project you may encounter a popup like the one in the following figure. You can safely press "Continue". This popup will only appear once.

search path popup on build