Build Release Directory Tool (Windows Embedded CE 6.0)

  • Article

1/5/2010

Use the Build Release Directory tool (Buildrel.bat) to copy files for a run-time image to the %_FLATRELEASEDIR% directory.

Buildrel.bat copies files from the following directories:

  • %_PROJECTROOT%\Cesysgen\Oak\Files
  • %_PROJECTROOT%\Oak\Files
  • %_PLATFORMROOT%\%_TGTPLAT%\Files
  • %_PROJECTROOT%\Cesysgen\Oak\Target\%_TGTCPU%\%WINCEDEBUG%
  • %_PROJECTROOT%\Oak\Target\%_TGTCPU%\%WINCEDEBUG%
  • %_PLATFORMROOT%\%_TGTPLAT%\Target\%_TGTCPU%\%WINCEDEBUG%

All files and binaries must reside in %_FLATRELEASEDIR% before Makeimg.exe is called.

buildrel [-h] [-u] [-f] [BuildRoot]

Parameters

  • -h
    Displays the command-line syntax.

  • -u
    Updates the release. This parameter does not allow Buildrel.bat to clean the release directory before copying files.

    This option is not recommended.

  • -f
    Refreshes the release. Buildrel.bat does not copy any binaries that would be copied due to the setting of the WINCEREL environment variable.

    This option is not recommended.

  • BuildRoot
    Specifies the root directory for the build. This can be Local for your own build, or it can be a fully qualified path. The default is Local.

Error Messages

  • ERROR - you are trying to update your release directory with an incompatible build. Either the target CPU, OS, Platform, or Project does not match the release directory. Please run without the [-u] flag to clean the current release directory.
    This message occurs when you run Buildrel.bat with the -u parameter. Buildrel.bat compares existing build information files (.bif) in %_FLATRELEASEDIR% against the environment variables you set through Wince.bat.

    If any .bif file does not match the build environment, Buildrel.bat determines an incompatible build.

    To troubleshoot, run Buildrel.bat without -u.

  • ERROR: You cannot build a release or an image in a build window for the COMMON project.
    **This message occurs if you set the %_TGTPROJ% environment variable to COMMON.

    The %_PROJECTROOT%\Common directory contains functionality that is common to all Windows Embedded CE OS designs. The tools in Platform Builder automatically take the Catalog items that are required for your Windows Embedded CE OS design.

    To troubleshoot, set %_TGTPROJ% by using only the options that are listed for Wince.bat.**

Example

The following code example shows how to use Buildrel.bat to copy all files to the default directory, %_FLATRELEASEDIR%, on the development workstation.

buildrel

Remarks

Because the build tree can contain binaries for more than one microprocessor, Buildrel.bat uses the defined environment variables to determine the directories from which it copies files.

If sharing violations occur when BuildRel.bat tries to copy files into your flat release directory, set the environment variable BUILDREL_USE_COPY=1. This will instruct BuildRel.bat to use xcopy instead of copylink to copy files.

See Also

Concepts

Build System Tools
Windows Embedded CE Build Environment Tool

Other Resources

Building a Run-Time Image That Supports the Kernel Profiler