Using IncrediBuild from the Microsoft Visual Studio
.NET/2005/2008 IDE
IncrediBuild is fully integrated into the Visual Studio development
environment. Builds can be run, stopped and reviewed using the
IncrediBuild menu and toolbar commands, as well as their equivalent
keyboard shortcuts. By default, IncrediBuild will only distribute
execution of C/C++ compilation tasks and MIDL tasks. To learn about
distributing custom build steps, custom build rules and build
events, see this section.
IncrediBuild Operations
Following is a description of operations available from within the
Microsoft Visual Studio .NET/2005/2008 IDE:
Building the current project
To start building a project, first make sure the target project is
selected in the Project Explorer and that the desired configuration
is selected. Next, open the "IncrediBuild" menu and choose either
Build Solution or Build Project to build the current
project incrementally (similarly, choose Rebuild Project to
clean all intermediate and output files and then build the
project). This will open up the Build
Monitor, displaying the build's output and progress.
Note that selecting Build Solution or Rebuild
Solution will perform a build operation on all selected project
configurations in the active solution configuration.
Cleaning the current project's intermediate and output
files
IncrediBuild provides its own Clean operation, which also cleans
intermediate files created by IncrediBuild during builds, so it is
generally recommended to use this instead of MSVC's Clean
operation. To clean the current project's intermediate and output
files, select the Clean command from the IncrediBuild
menu.
Note that by selecting Clean Active Project Only you can
clean only the active project's folders, ignoring its sub-projects.
Stopping a build in progress
IncrediBuild's operation can be halted at any time during the build
by selecting Stop Build from the IncrediBuild menu. This
operation will also stop a currently running MSVC build.
Batch operations
All of the above operations can be performed on a group of projects
or on several solution configurations in a single operation. To
perform a batch operation, select Batch Build... from the
IncrediBuild menu. The Batch Build dialog will open:
Select one or more project/configuration combinations by
clicking on the checkboxes to the left of the configuration names.
Next, click any of the action buttons (Build, Rebuild
and Clean) to perform the operation on all of the selected
configurations. A detailed reference of the Batch Build dialog's
options is available here.
Reviewing build results
To display the Build Monitor for the currently running build or for
the last build executed by IncrediBuild, choose Open Build
Monitor from the IncrediBuild menu.
Modifying IncrediBuild Agent settings
The IncrediBuild Agent Settings dialog can be accessed using the
Settings... menu command.
Toolbar and Keyboard Shortcuts
IncrediBuild operations can also be activated from the IncrediBuild
toolbar. To change the commands displayed in the IncrediBuild
toolbar or add keyboard shortcuts for IncrediBuild commands, use
the IDE's Customize command. For more details on customizing
IncrediBuild's IDE integration, click here.
Copyright (C) 2001-2008 Xoreax Software Ltd. All rights
reserved.