Qt Reference Documentation

[Previous: Installation]

# Installing Qt for Windows CE

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\4.7.4`.

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\4.7.4\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\4.7.4
     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.

## 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 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!