Build Menu Options

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/27/2008

The Build menu provides a variety of options for your OS design, such as building run-time images. For information about the build process, see Build Phases.

This menu contains build commands and flags that modify these commands, resulting in more flexibility when determining the settings for a build.

Note

Menu options specific to Windows Embedded CE 6.0 are visible only when the active project is an OS design.

This functionality is similar to the functionality available in a command-line prompt build window. The results of a build depend on the settings that you choose, and can vary widely.

You can customize the settings for a build according to your needs by selecting the build flags you want to set, then choosing a build command to begin the build.

For more information about these build options, see Advanced Build Commands.

The following build options are available on the Build menu.

Command Description

Build Solution

Visual Studio.

Performs a build of all projects in the currently active Microsoft Visual Studio 2005 solution.

This is the equivalent of the following command.

blddemo -q

Rebuild Solution

Visual Studio.

Performs a rebuild of all projects in the currently active Visual Studio 2005 solution.

This is the equivalent of the following command.

blddemo clean -q.

Clean Solution

Visual Studio.

Performs a clean of all projects in the currently active Visual Studio 2005 solution.

This is the equivalent of cleanos.bat.

Command Description

Build <OS design>

Runs the Sysgen tool on files related to the OS design. This assumes that the files have not changed from a previous build process.

Aa909420.note(en-US,WinEmbedded.60).gifNote:
If you have added or removed files or Catalog items after a previous Sysgen, it is recommended that you choose Rebuild <OS design> before running a new build. This reduces the chances of a build error appearing.

Subprojects in the OS design are included in the build process. No files are copied to the release directory.

This is the equivalent of the following command.

blddemo -q

Rebuild <OS design>

Performs a rebuild of the active OS design.

This is the equivalent of the following command.

blddemo clean -q

Advanced Build Commands

Provides build options for advanced users who are familiar with the build system.

For more information, see Advanced Build Commands.

Build All Subprojects

Performs the following commands on all subprojects currently included in the OS design. The second and third lines are repeated for each subproject.

set WINCEREL=1
cd <CurrentSubproject>
build -nmake cleantgt && build
makeimg

These commands mean that the Build tool is called for each subproject. This is useful if you made changes to the subprojects, but not the OS design.

Rebuild All Subprojects

Performs the following commands on all subprojects that are currently included in your OS design. The second and third lines are repeated for each subproject.

set WINCEREL=1
cd <CurrentSubproject>
build -c
makeimg

These commands mean that the Build tool is called for each subproject. This is useful if you made changes to the subprojects, but not the OS design.

Build All SDKs

Select to build all SDKs currently included in your OS design.

Aa909420.note(en-US,WinEmbedded.60).gifNote:
It is recommended that you make sure that a run-time image based on your OS design has been built before building an SDK.

Copy Files to Release Directory

Select to use the Buildrel tool to copy output files to the release directory after the build completes.

Make Run-Time Image

Select to use the Makeimg tool to use files in the release directory to create the run-time image after the build completes.

Open Release Directory in Build Window

Use to open a command prompt build window in the release directory for your OS design.

Global Build Settings

Use to view or modify the global build settings, which affect all Catalog items in your OS design.

Targeted Build Settings

Use to view or modify the targeted build settings, which affect the selected Catalog items in your OS design.

You can select or deselect the Make Run-Time Image After Building option, which creates the run-time image after the build has completed, using the newly built files.

Batch Build

Use to modify and choose multiple configurations of your OS design from which to build run-time images.

Configuration Manager

Use to modify and choose an active configuration for your OS design.

The Standard toolbar can also be used to access the Configuration Manager.

See Also

Concepts

Platform Builder Menus