Share via


Building a Run-Time Image

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

Windows Mobile Not SupportedWindows Embedded CE Supported

8/27/2008

After you create your OS design, you can build a run-time image by using the Platform Builder integrated development environment (IDE).

Before you build a run-time image, you will choose the active configuration. A configuration specifies a board support package (BSP) and build options, such as Release or Debug. On the Standard toolbar in the IDE, the Solution Configurations list shows available configurations.

Note

If you copy your OS design (.pbxml) file from one development workstation to another, only the configurations corresponding to CPUs installed on the destination development workstation are available for selection.

If you change project settings for your OS design, your changes apply to the active configuration selected in the <OS design> Property Pages dialog box.

If you change the active configuration after you changed the project settings for your OS design, your changes are not included in the run-time image. To include the new settings for your OS design in the run-time image, you must run another build.

For information about the characteristics of a run-time image built from each configuration, see Levels of Debugging Support.

To build a run-time image

  1. From the Build menu, choose Configuration Manager.

  2. Choose an active configuration, and then choose Close.

    If you expect the size of your run-time image to exceed 32 megabytes (MB), enable support for a large run-time image in the settings for the configuration. For information about enabling support for a large run-time image, see Enabling a Run-Time Image Size Larger Than 32 MB.

    Note

    Debug run-time images are typically larger than release run-time images. If you choose a debug configuration and the OS design contains many features, it is likely that the size of the run-time image will exceed 32 MB.

  3. If you have previously built a run-time image and recently changed environment variables or SYSGEN variables, you can clean the CESYSGEN, PLATFORM, and %_FLATRELEASEDIR% directories for your OS design before you build. To clean before you build, from the Build menu, choose Clean <OS design>.

  4. From the Build menu, choose Global Build Settings and then verify that Make Run-Time Image After Build and Copy Files to Release Directory After Build are selected. Then choose one of the following actions.

    • If you are building a run-time image for the first time, from the Build menu, choose Build <OS design>.
      - or -
    • If you have modified your OS design after a previous build, it is recommended that, from the Build menu, choose Rebuild <OS design>. This reduces the chances of a build error occurring.

    For more information about the options on the Build menu, see Build Menu Options. For more information about the advanced build commands, see Advanced Build Commands.

  5. Verify that your run-time image is being built by observing the output messages in the Output tab of the Output window in the IDE.

When the build process is complete, Platform Builder adds a count of the warnings and errors generated during the process to the output in the build window, using the following format: (XX warnings, XX errors).

This count is based on the number of messages containing the strings "warning" and "error" that are generated during the build process.

See Also

Concepts

Run-Time Image Build Process

Other Resources

How-to Topics