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

Step 1: Install the License File (commercial editions only)

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

Note: The install path must not contain any spaces.

Step 2: Set the 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\%VERSION%\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.

Step 3: Configure Qt

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

C:
cd \Qt\%VERSION%
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. The Configuration Options for Qt page gives a brief overview of these. See the README file for the list of supported platforms.

Step 4: Build Qt Library

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

That's all. Qt is now installed.

Qt Demos and Examples

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.

Note: 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 Network
• 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!