Build Release Directory Tool (Buildrel.bat) (Compact 2013)

3/26/2014

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

Syntax

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 have set the %_TGTPROJ% environment variable to COMMON. In Windows Embedded Compact 2013, this variable is always set to "CEBase".

Remarks

Buildrel.bat copies files from the following directories:

  • %SG_OUTPUT_ROOT%\platcomm\%_TGTPLAT%
  • %SG_OUTPUT_ROOT%\oak\files
  • %SG_OUTPUT_ROOT%\oak\target\managed\%WINCEDEBUG%
  • %SG_OUTPUT_ROOT%\oak\target\%_TGTCPU%\%WINCEDEBUG%
  • %SG_OUTPUT_ROOT%\target\managed\%WINCEDEBUG%
  • %SG_OUTPUT_ROOT%\oak\target\%_TGTCPU%\%WINCEDEBUG%

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

Reference

Windows Embedded Compact Build Environment Tool (Wince.bat)

Other Resources

Build System Command Line Tools
Building a Run-Time Image That Supports Standalone Profiling