Windows CE - Using shadow builds

While developing for Windows CE you might want to compile a version of Qt for several different platforms and SDKs. In order to create those different builds of Qt you do not have to copy the whole Qt package or the Qt source. You are able to create multiple Qt builds from a single source tree. Such builds are called shadow builds.

Basically a shadow build is created by calling configure.exe from a different directory.

To make sure that the shadow build compiles correctly it is important that you following these guidelines:

• The original Qt source package must be left untouched - configure must never have been run in the source tree directory.
• The shadow build directory must be on the same level as the Qt source package.
  If the Qt package is in C:\Qt\%VERSION% the shadow build directory could be C:\Qt\shadowbuild. A shadow build from a directory like C:\shadowbuild will not compile.
• Avoid using "release" and "debug" in the path to the shadow build directory. (This is an internal limitation of the build system.)
• The \bin directory of the shadow build directory must be added to the PATH environment variable.
• Perl has been installed on your system. (ActivePerl is a popular distribution of Perl on Windows.)

So lets assume you have installed Qt in C:\Qt\%VERSION% and you want to create a shadow build in C:\Qt\mobile5-shadow:

• First add C:\Qt\mobile5-shadow\bin to the PATH variable.

   set PATH=C:\Qt\mobile5-shadow\bin;%PATH%

• Make sure the enviroment variables for your compiler are set.

  Visual Studio includes vcvars32.bat for that purpose - or simply use the "Visual Studio Command Prompt" from the Start menu.

• Now navigate to your shadow build directory and run configure:

   cd c:\Qt\mobile5-shadow
   C:\Qt\%VERSION%\configure.exe -platform win32-msvc2005 -xplatform wincewm50pocket-msvc2005 -release

• To build Qt, you have to update your PATH, INCLUDE and LIB paths to point to your target platforms.

  For a default installation of the Windows Mobile 5.0 Pocket PC SDK, you can do the following:

   set INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\ce\include;
       C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Pocket PC SDK\Include\Armv4i
   set LIB=C:\Program Files\Microsoft Visual Studio 8\VC\ce\lib\armv4i;
       C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Pocket PC SDK\Lib\ARMV4I
   set PATH=C:\Program Files\Microsoft Visual Studio 8\VC\ce\bin\x86_arm;
       %PATH%

  We have provided a convenience script for this called setcepaths. Simply type:

   setcepaths wincewm50pocket-msvc2005

• Finally, to build the shadow build type:

   nmake

• That's all. You have successfully created a shadow build of Qt in C:\Qt\mobile5-shadow.