Tutorial Step 2: Building the Custom OS Image for the Emulator

  • Article

After you have created a platform, you can build an OS image based on that platform. In this step, you build a custom OS image from the MyPlatform platform that you created.

For the purposes of this tutorial, before building the custom OS image, you must choose a debug OS image. By choosing to build a debug OS image, you can later debug your OS from Platform Builder. In addition, because the size of a debug OS image is greater than the size of a release OS image, you must also change the value of an environment variable to accommodate a larger OS image.

To build the custom OS image for the Emulator

  1. From the Build menu, choose Set Active Configuration.

  2. From the list of platform configurations, select MYPLATFORM - EMULATOR: X86 Win32 (WCE emulator) Debug, and then choose OK.

  3. From the Platform menu, choose Settings.

  4. Choose the Build Options tab, and then verify that the Enable Full Kernel Mode and Enable Images Larger Than 32MB check boxes are selected.

    Enabling full kernel mode for your platform increases system performance. For more information, see Full-Kernel Mode.

  5. To close the Platform Settings window, choose OK.

  6. From the Build menu, choose Build Platform.

The time required by Platform Builder to build the OS image depends on the number of features that are included in the platform. In this example, you are building a large configuration containing many features, so it may take as long as twenty minutes to build the OS image.

You can observe the build process in the IDE. The progress of the build process is displayed on the Build tab of the Output window. When the build is complete, you see the following message: MYPLATFORM - 0 error(s), XX warning(s).

See Also

Tutorial Step 3: Setting Up a Connection to the Emulator and Downloading the OS Image | Tutorial Step 1: Creating a Custom OS Image for the Emulator | Tutorial: Using Platform Builder with the Emulator | Platform Builder Tutorials | Build Options Tab

 Last updated on Wednesday, April 14, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.