Installing Qt on Windows CE

Note: Qt for Windows CE has some requirements that are given in more detail in the Qt for Windows CE Requirements document.

1. Uncompress the files into the directory you want to install Qt into; e.g., C:\Qt\4.6.3.

   Note: The install path must not contain any spaces.

2. Environment variables

   In order to build and use Qt, the PATH environment variable needs to be extended:

    PATH               - to locate qmake, moc and other Qt tools

   This is done by adding c:\Qt\4.6.3\bin to the PATH variable.

   For newer versions of Windows, PATH can be extended through "Control Panel->System->Advanced->Environment variables" and for older versions by editing c:\autoexec.bat.

   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.

3. Configuring Qt

   To configure Qt for Windows Mobile 5.0 for Pocket PC, type the following:

    C:
    cd \Qt\4.6.3
    configure -platform win32-msvc2005 -xplatform wincewm50pocket-msvc2005

   If you want to configure Qt for another platform or with other options, type configure -help to get a list of all available options. See the README file for the list of supported platforms.

4. Building Qt

   Now, to build Qt you first have to update your PATH, INCLUDE and LIB paths to point to the correct resources for your target platforms. For a default installation of the Windows Mobile 5.0 Pocket PC SDK, this is done with the following commands:

    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 provide a convenience script for this purpose, called setcepaths. Simply type:

    setcepaths wincewm50pocket-msvc2005

   Then to build Qt type:

    nmake

5. That's all. Qt is now installed.

   To get started with Qt, you can check out the examples found in the examples directory of your Qt installation. The documentation can be found in doc\html.

   Remember: If you reconfigure Qt for a different platform, make sure you start with a new clean console to get rid of the platform dependent include directories.

   The links below provide further information for using Qt:

   • How to Learn Qt
   • Tutorials
   • Developer Zone
   • Deploying Qt Applications

   You might also want to try the following Windows CE specific links:

   • Windows CE - Introduction to using Qt
   • Windows CE - Working with Custom SDKs
   • Windows CE - Using shadow builds
   • Windows CE - Signing

   Information on feature and performance tuning for embedded builds can be found on the following pages:

   • Fine-Tuning Features in Qt
   • Qt Performance Tuning

We hope you will enjoy using Qt. Good luck!

[Previous: Installation]