Set the OS Design Configuration Properties of a Build (Compact 2013)

  • Article

3/26/2014

In Platform Builder, you can manage and set Windows Embedded Compact 2013 OS design configuration properties that affect your build. You do this on the following property pages: You access the OS design configuration property pages in two ways: by using the shortcut menu and by using the menu bar.

To access the OS design configuration properties using the shortcut menu

  1. In Solution Explorer, right-click the OS design project, and then click Properties.

  2. In the left pane of the Property Pages dialog box, select and expand the Configuration Properties menu item.

To access the OS design configuration properties using the menu bar

  1. In Solution Explorer, select the OS design project.

  2. On the Project menu, click Properties.

  3. In the left pane of the Property Pages dialog box, select and expand the Configuration Properties menu item.

  • General
    On the General page, you can select the build type: Debug, Release, or Checked. You can also set the name of the image and the location of the flat release directory. (If you change either of these properties, you must re-run the Copy Files to Release Directory command).

    Note

    A debug image is useful for development because it includes additional debug output. By using a debug image, you can perform full source-level debugging, because compiler optimizations are turned off. For more information about the differences between debug, release, and checked builds, see How the Build System Works.

  • Locale
    On the Locale page, you can set environment variables that are passed to the build localization tools during the build process. In this manner, you can create an OS design for non-English languages.
  • Build Options
    On the Build Options page, you can set several environment variables that affect how the image behaves, such as enabling the kernel debugger and allowing it to connect and pass debugging information from the target device to the host device. Other options include enabling a ship build or enabling kernel profiling.
  • Environment
    On the Environment page, you can set custom environment variables that influence the build. You typically use these variables in combination with custom build logic in a hardware platform or subproject. By default, none are set because this functionality is typically for advanced users.
  • Custom Build Actions
    On the Custom Build Actions page, you can set actions — typically, the running of batch files — to take during various build steps. Custom build actions are typically for advanced users and so, by default, none are set.

  • Subproject Image Settings
    On the Subproject Image Settings page, you can include or exclude a subproject from the build or final image.

    Note

    This page differs from the Properties that you access by right-clicking a subproject in Solution Explorer.

See Also

Concepts

Customize Your Build