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.
  • With Qt5, the code has to be checked out of the git repository, otherwise the out of source build will fail as syncqt is not executed.
  • Avoid using "release" and "debug" in the path to the shadow build directory. (This is an internal limitation of the build system.)
  • 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:

  • Make sure the environment 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 -xplatform wincewm50pocket-msvc2005 -prefix %INSTALLDIR%
  • 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.
  • Now you can call nmake install and get a clean installation of Qt in %INSTALLDIR%.

© 2015 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.