Build Configurations (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 configuration | Description |
|---|---|
| Debug | Building 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. |
| Release | Building 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 EnableKITL and EnableKernel 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.
- Build run-time images based on Release and Debug configurations of your OS design.
- 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.
- 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
Last updated on Thursday, February 02, 2006
Send Feedback on this topic to the authors