Build Configurations
Collapse the table of content
Expand the table of content

Build Configurations (Windows CE 5.0)

Windows CE 5.0

During the development process, you can use the Platform Builder integrated development environment (IDE) to select one of two default build configurations for your OS design. These configurations are called Debug and Release configurations, and offer different options.

  • The term release is used to refer to a configuration which, when built, results in a run-time image that usually includes all optimization.
  • The term debug is used to refer to a configuration which, when built, results in a run-time image that usually includes limited optimization.

The level of optimization in a configuration can be modified according to your needs, resulting in a type of configuration known as a custom configuration.

You can create or select a different configuration at any time within the development process.

To choose an existing configuration, from the Build OS menu, select Set Active Configuration.

The following table shows the default configurations that you can select.

Build configurationDescription
DebugBuilding a Debug configuration produces a very large run-time image, which has full debugging enabled.

From the Build OS menu, select Set Active Configuration. This sets the environment variable WINCEDEBUG=debug.

ReleaseBuilding a Release configuration produces a smaller run-time image, which has limited debugging enabled. Release configurations support OutputDebugMessage, and can be configured for debugging.

From the Platform menu, select Settings, and then verify that both the Enable KITL and Enable Kernel Debugger check boxes are selected on the Build Options tab.

This sets the environment variable WINCEDEBUG=retail.

You can build a run-time image that has no debugging enabled by copying and modifying a Release configuration to create a custom configuration for your OS design. For more information, see Creating a Custom Ship Configuration.

When you switch between a Release configuration and a custom configuration that has no debugging enabled, you must do a clean rebuild of your OS design. This is because these configurations place their binaries in the same place, which can lead to conflicts between the configurations.

You do not need to switch the active configuration for your entire OS design to selectively build a few executables for debugging purposes in a Release configuration.

The following process shows how you can selectively build a few executables for debugging purposes in a Release configuration.

  1. Build run-time images based on Release and Debug configurations of your OS design.
  2. From the build release directory in the Debug configuration, copy the executable (.exe) files that you want to debug into the build release directory of the Release configuration.
  3. Run Makeimg.exe in the Release configuration, which links the copied executables into your run-time image.

See Also

Run-Time Image Build Process | Miscellaneous Environment Variables | Platform Settings: Build Options Tab | Build OS Menu Options | Compiler Options


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show:
© 2016 Microsoft