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 inC:\Qt\%VERSION%
the shadow build directory could beC:\Qt\shadowbuild
. A shadow build from a directory likeC:\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 thePATH
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 thePATH
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:
- To build Qt, you have to update your
PATH, INCLUDE
andLIB
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
.
© 2016 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.