Navigation:  Using Visual Build > Building Projects >

Methods of Building

Previous pageReturn to chapter overviewNext page

The following methods are available for starting or continuing a build (shortcut keys are available for all commands)

 

CommandBehavior
BuildStarts from the current build position and executes all checked steps that have not been completed or skipped
Build From CursorSets the current build position to the first selected step and performs a build
Build Step GroupSets the current build position to the first selected step and builds that step and any uncompleted child steps, stopping when a step at the same indentation as the first step is reached
Build Next StepStarts/continues the build from the current build position with single-step debugging, pausing before each step is built
Start From CursorStarts the build from the first selected step with single-step debugging, pausing before each step
Build To CursorStart/continue the build and break when the first selected step is reached

 

RebuildClears the build status for all steps, sets the current build position to the beginning of the project, and performs a build
Rebuild SelectedRebuilds all selected steps, regardless of any grouping, build status, conditional build rules, or include in build status*
Rebuild Step GroupResets the build status of the selected step and children, sets the current build position to the first selected step and builds that step and any child steps

 

RestartResets the build status of all steps, starts a build and pauses at the first step
ResetResets the build status for all steps

 

PausePauses the build after the current step completes
StopTerminates the currently building step and aborts the build (failure steps will also be built if the related option is enabled)

 

 

*Note: Rebuild Selected is an ad hoc method to rebuild the selected steps regardless of step completion status, profiles, conditional build rules, and include in build status. Iterating actions (the Process Files action, Loop action, or a repeating build rule) are not compatible with rebuild selected or the Test button on the step properties dialog.  Some ways to test build rules or iterating steps without building the entire project are:

 

Select the iterating or parent step and choose Build Step Group or Rebuild Step Group.
Select the iterating or first step, choose Start From Cursor, select the step following the last iterating child step, and choose Build to Cursor; then stop the build when it breaks on the selected step.
Add a breakpoint following the iterating children, select the iterating or first step, and choose Build From Cursor.
Put the iterating/parent + child steps in a subroutine (on the Subroutine Steps pane), add a Subroutine Call step in the project steps to call the subroutine, and Rebuild Selected can then be used on the Subroutine Call step.

 

Note: Breakpoints are stored in the project's user configuration file (ProjectFile.bld.user) in the same path as the project file.