Master Build Tool (Cebuild.bat) (Compact 2013)

  • Article

3/26/2014

The Master Build Tool (Cebuild.bat) builds the modules and functionality and generates the source code for an entire OS design. Cebuild.bat performs the following steps to create a run-time image:

  • For each project specified by the _DEPTREES environment variable, Cebuild.bat runs Build.exe in the %_WINCEROOT%\Public\Tree directory, where Treeis a project specified by _DEPTREES. Build.exe compiles the source code in the project directories.
  • For each project specified by the _DEPTREES environment variable, Cebuild.bat runs Sysgen.bat -p Tree, where Treeis a project specified by _DEPTREES. Sysgen.bat builds the project modules, which are selected in Cesysgen.bat. Sysgen.bat builds the modules in the %_PROJECTROOT%\Oak\Misc directory.
  • Cebuild.bat runs Build.exe in the %_PLATFORMROOT%\%_TGTPLAT% directory to compile the code for the hardware platform.

Syntax

Cebuild [-h] [-r] [-q] [-qbsp] [-d <deptree_entry>] [<build_flags>]

Parameters

  • -h
    Displays a Help screen.
  • - r
    Releases binaries, if the WINCEREL environment variable is set.
  • -q
    Calls Sysgen.bat only; does not call Build.exe. This is not recommended in most circumstances. This option is not used for source code builds.

  • - qbsp
    Performs a build and Sysgen operation for the board support package (BSP) only.

    Note

    Do not perform a build and Sysgen operation, because this builds the OS tree and then performs a Sysgen operation. 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 operations also significantly increase the time required to build a run-time image.

  • -d <deptree_entry>
    Specifies the deptree entry where the build will start from. <deptree_entry> is the name of a project in the directory structure.
  • <build_flags>
    Specifies the environment variables that are set for the build process.

Error Messages

Cebuild.bat generates error information in the following files:

  • %_WINCEROOT%\Build.err
  • %_WINCEROOT%\Build.log

Remarks

If you have changed any source code that needs to be recompiled, you must browse to the directory of the source code and the type build to recompile it. Then, you can type cebuild to build the operating system, project, and platform modules.

You can use Cebuild.bat to restart the build at a certain location in the build process, usually after fixing a build error and then recompiling the code at that location.

See Also

Reference

Build Demo Tool (Blddemo.bat)
Build Tool (Build.exe)
Sysgen Tool (Sysgen.bat)

Other Resources

Build System Command Line Tools