Advanced Build Commands (Compact 2013)
3/26/2014
These commands provide additional functionality for users who want to build their run-time images.
UI Element List
These build commands are for advanced users who are familiar with the build system and want additional flexibility on the Build menu.
Command |
Description |
|---|---|
Sysgen |
Runs the Sysgen tool on files in the OS design. Choose this command when you change the SYSGEN variables, typically by adding or removing items from the Catalog. Files are copied to the release directory if Copy Files to Release Directory After Build is selected in Global Build Settings. A run-time image is built if Make Run-Time Image After Build is selected in Global Build Settings. |
Clean Sysgen |
Cleans the SYSGEN variables in the operating system, runs the Sysgen tool on files in the OS design, compiles BSPs and runs the Sysgen tool on BSPs, and builds subprojects. Files are copied to the release directory if Copy Files to Release Directory After Build is selected in Global Build Settings. A run-time image is built if Make Run-Time Image After Build is selected in Global Build Settings. Choose this command when you change an environment variable or a SYSGEN variable. If you have only modified a source file, then a clean build is not necessary. |
Build and Sysgen |
Builds, and then runs the Sysgen tool on files in the OS design. Choose this command when you modify files under %_WINCEROOT%\Public, or under %_WINCEROOT%\<custom_directory>, that are included in the OS design. Subprojects in the OS design are included in the build process. Files are copied to the release directory if Copy Files to Release Directory After Build is selected. A run-time image is built if Make Run-Time Image After Build is selected in Global Build Settings. .gif "Gg469903.note(en-us,WinEmbedded.80).gif") Important:
Build and Sysgen builds the OS tree and then performs a Sysgen. The OS tree contains source code from Microsoft and recompiling and rebuilding this code is usually unnecessary and involves risk, especially if you do not implement a source control system. Build and Sysgen also significantly increases the time required for building an OS image.
|
Rebuild and Clean Sysgen |
Cleans the SYSGEN variables in the operating system and the %_WINCEROOT%\Platform directory for your OS design, and then does a Build and Sysgen (see above). Choose this command when you have modified files under %_WINCEROOT%\Public, or under %_WINCEROOT%\<custom_directory>, that are included in the OS design. |
Build Current BSP and Subprojects |
Builds BSP source code and subproject code, and then runs the Sysgen tool on files in the BSP. Choose this command when you modify files in your BSP directory or in one of your subprojects. If SYSGEN variables in the OS have changed, do not choose this command. Files are copied to the release directory if Copy Files to Release Directory After Build is selected. A run-time image is built if Make Run-Time Image After Build is selected in Global Build Settings. |
Rebuild Sysgen Current BSP and Subprojects |
|