Master Build Tool
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
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 Tree is a project specified by _DEPTREES. Build.exe compiles the source code in the project's directories.
- For each project specified by the _DEPTREES environment variable, Cebuild.bat runs Sysgen.bat –p Tree, where Tree is a project specified by _DEPTREES. Sysgen.bat builds the project's 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.
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.
- -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. For more information, see Environment Variables.
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 navigate to the directory of the source code and type build to recompile it. Then, you can use cebuild to build the operating system, project, and platform modules.
Cebuild.bat can be used to restart the build at a certain location in the build process, usually after fixing a build error and recompiling the code at that location.
Example
The following code example shows how to use Cebuild.bat.
cebuild -r -d dcom