Directory After Build and Make Run-Time Image After Building options, Platform Builder copies the files to the release directory and creates the run-time image. You can also perform these steps individually either through the menu or by running the Buildrel.exe and Makeimg.exe tools at the command prompt.
If you run the Clean Sysgen command in one build configuration, you also have to run Sysgen for the other build configurations later. Keep in mind that the Clean Sysgen command deletes all files generated for other build configurations, as well as for the current build configuration.
Building Run-Time Images from the Command Line
The Platform Builder for CE6 R2 plug-in for Visual Studio 2005 provides convenient access to batch files and build tools, but you can also run these batch files and build tools directly at the command prompt. Each build command in Visual Studio with Platform Builder corresponds to a specific build command, as listed in Table 2-2. Remember, however, to use the Open Build Window command in Visual Studio to open a Command Prompt window for this purpose. The standard command prompt does not initialize the development environment. The build process will fail without the presence of the required environment variables.
Table 2-2 Build commands and command line equivalents
| Build Command | Command Line Equivalent |
|---|---|
| Build | blddemo -q |
| Rebuild | blddemo clean -q |
| Sysgen | blddemo -q |
| Clean Sysgen | blddemo clean -q |
| Build And Sysgen* | Blddemo |
| Rebuild And Clean Sysgen* | blddemo clean cleanplat -c |
| Build Current BSP And Subprojects | blddemo -qbsp |
| Rebuild Current BSP And Subprojects | blddemo -c -qbsp |
* Not recommended
Windows Embedded CE Run-Time Image Content
As illustrated in Figure 2-3, the run-time image includes all items and components that you want to deploy and run on a target device as part of the OS design, such as kernel components, applications, and configuration files. The most important configuration files for developers are binary image builder (.bib) files, registry (.reg), database (.db), and file system (.dat) files. These files determine the memory layout and specify how Platform Builder initializes the file system and the system registry. It is important to know how to work with these files. For example, you can modify the .reg and .bib files for a BSP directly in the OS design or create a subproject to add custom settings to the run-time image in a more componentized way. As mentioned in Chapter 1, it is generally faster and more convenient to modify the .reg and .bib files of an OS design directly, yet subprojects facilitate the reuse of customizations across multiple OS designs.
Figure 2-3 Contents of a run-time image
Binary Image Builder Files
The Windows Embedded CE build process relies on .bib files to generate the content of the run-time image and to define the final memory layout of the device. At the end of the build process, during the Make Run-time Image phase, the Make Binary Image tool (Makeimg.exe) calls the File Merge tool (Fmerge.exe) to combine all applicable .bib files, such as Config.bib and Platform.bib from the Platform<
A .bib file can include the following sections:
¦ MEMORY Defines the parameters for the memory layout. You can typically find this section in the Config.bib file for your BSP, such as C:Wince600PlatformDeviceEmulatorFilesConfig.bib.
¦ CONFIG Defines configuration options for Romimage.exe to customize the binary run-time image. You can typically find this section in the Config.bib file for your BSP. This section is optional.
¦ MODULES Specifies a list of files that Romimage.exe marks to be loaded into RAM or executed in place (XIP). Only uncompressed object modules can execute directly from read-only memory. You can list native executable files in this section, but not managed binaries, because the Common Language Runtime
