Build a Run-Time Image for Debugging (Compact 2013)
3/26/2014
To create a run-time image that supports debugging, you choose a build configuration, set debug options, and then build the OS. The size of a Debug run-time image is about twice the size of a Retail run-time image.
The build time varies depending on your computer speed, your board support platform (BSP), and your OS design. For tips on how to reduce the build time, see Tuning the Build Process.
You can build the run-time image by using Platform Builder, or you can build it by using commands at the command line. For information about the command-line build process, see How the Build System Works. The following instructions use Platform Builder. For more detailed information about building the run-time image by using Platform Builder, see Build with Platform Builder.
To build the run-time image by using Platform Builder
In Platform Builder, open your OS design project.
Select a build configuration.
Note
We recommend that you select a Debug configuration because it provides full debugging capabilities. You can also choose a Release configuration and enable the kernel debugger and the Kernel Independent Transport Layer (KITL) as described in the third step of this procedure, but you will have limited debugging support because the Release configuration is optimized for speed and provides no symbolic debugging information. For more information about the differences between Release and Debug configurations, see Set Build Options for Debugging.
- In Platform Builder, in Solution Explorer, right-click the OS design project, and then click Properties.
- In the OS design Property Pages dialog box, in the upper-right corner, click Configuration Manager.
- In the Configuration Manager dialog box, under Active solution configuration, select your configuration. For the reasons previously described, we recommend that you select a Debug configuration.
- Click Close to close the Configuration Manager dialog box.
- Click OK to close the Property Pages dialog box.
Set the build options to support the kernel debugger and KITL. For instructions, see Set Build Options for Debugging.
In Solution Explorer, right-click your OS design project, and do one of the following:
- If you are building your OS design for the first time, click Build.
- If you have already built your OS design but have changed catalog items, click Rebuild because rebuilding deletes the contents of the SYSGEN output root directory before it executes the build process.