Home · All Classes · All Functions · Overviews

Compiler Notes

This page contains information about the C++ compilers and tools used to build Qt on various platforms.

Please refer to the Platform Notes for information on the platforms Qt is currently known to run on, and see the Supported Platforms page for information about the status of each platform.

If you have anything to add to this list or any of the platform or compiler-specific pages, please submit it via the Bug Report Form or through the Public Qt Repository.

Supported Features

Not all compilers used to build Qt are able to compile all modules. The following table shows the compiler support for five modules that are not uniformly available for all platforms and compilers.

g++ 3.3XXX
g++ 3.4 and upXXXXX
SunCC 5.5XX
aCC series 3XX
aCC series 6XXXXX
xlC 6XX
Intel CC 10XXXXX
MSVC 2005 and upXXXXX


GCC on Windows (MinGW)

We have tested Qt with this compiler on Windows XP. The minimal version of MinGW supported is:

Note: For users of the MinGW binary package: This package is now based on MinGW 4.4. The installer no longer offers to download MinGW for you, but rather offers to use a version of MinGW that you already have installed on your machine. You just tell the installer which directory MinGW is installed in. If you don't already have MinGW 4.4 installed, you can download a .zip archive from our ftp site. This archive provides fixes to MinGW and support for missing API, See the _patches directory in the archive for details.

Note: A MinGW installation is only needed to build against the binary pacakge, not to run the pre-compiled binaries that are in the package.

GCC 4.0.0

The released package of the compiler has some bugs that lead to miscompilations. We recommend using GCC 4.0.1 or later, or to use a recent CVS snapshot of the GCC 4.0 branch. The version of GCC 4.0.0 that is shipped with Mac OS X 10.4 "Tiger" is known to work with Qt for Mac OS X.


The hpux-g++ platform is tested with GCC 3.4.4.


Please use GCC 3.4.2 or later.

Mac OS X

Please use the latest GCC 3.3 from Apple or a later version of GCC 3. The gcc 3.3 that is provided with Xcode 1.5 is known to generate bad code. Use the November 2004 GCC 3.3 updater available from Apple.

GCC 3.4.6 (Debian 3.4.6-5) on AMD64 (x86_64)

This compiler is known to miscompile some parts of Qt when doing a release build. There are several workarounds:

  1. Use a debug build instead.
  2. For each miscompilation encountered, recompile the file, removing the -O2 option.
  3. Add -fno-gcse to the QMAKE_CXXFLAGS_RELEASE.


The hpux-acc-32 and hpux-acc-64 platforms are tested with aCC A.03.57. The hpuxi-acc-32 and hpuxi-acc-64 platforms are tested with aCC A.06.10.

Intel C++ Compiler

Qt supports the Intel C++ compiler on both Windows and Linux. However, there are a few issues on Linux (see the following section).

Intel C++ Compiler for Linux

Nokia currently tests the following compilers:

We do not currently test the IA-64 (Itanium) compiler.

Known Issues with Intel C++ Compiler for Linux

Intel C++ Compiler (Windows, Altix)

Qt 4 has been tested successfully with:

We currently only test the Intel compiler on 32-bit Windows versions.


IRIX is an unsupported platform. See the Supported Platforms page and Qt's Software's online Platform Support Policy page for details.

Qt 4.4.x requires MIPSpro version 7.4.2m.

Note that MIPSpro version 7.4.4m is currently not supported, since it has introduced a number of problems that have not yet been resolved. We recommend using 7.4.2m for Qt development. However, please note the unsupported status of this platform.

Forte Developer / Sun Studio (Solaris)

Sun Studio

Qt is tested using Sun Studio 12 (Sun CC 5.9). Go to Sun Studio Patches page on Sun's Web site to download the latest patches for your Sun compiler.

Please note that Qt 4.6 is stricter in its STL requirements and that the default STL implementation used by Sun CC does not pass those requirements. This does not affect binary compatibility and you can continue to use STL in your own code, but Qt's STL-compatibility functions will be disabled.

Sun CC ships with a secondary STL implementation (called stlport4) which is standards-compliant and can be used by Qt. You can enable it by passing the -library=stlport4 option to the compiler. Note that this does not affect Qt's binary compatibility, but it may affect that of other libraries and programs that use STL.

Sun WorkShop 5.0

Sun WorkShop 5.0 is not supported with Qt 4.

Visual Studio (Windows)

We do most of our Windows development on Windows XP, using Microsoft Visual Studio .NET 2005 and Visual Studio 2008 (both the 32- and 64-bit versions).

Qt works with the Standard Edition, the Professional Edition and Team System Edition of Visual Studio 2005.

We also test Qt 4 on Windows XP with Visual Studio .NET and Visual Studio 2003.

In order to use Qt with the Visual Studio 2005/2008 Express Edition you need to download and install the platform SDK. Due to limitations in the Express Edition it is not possible for us to install the Qt Visual Studio Integration. You will need to use our command line tools to build Qt applications with this edition.

The Visual C++ Linker doesn't understand filenames with spaces (as in C:\Program files\Qt\) so you will have to move it to another place, or explicitly set the path yourself; for example:


If you are experiencing strange problems with using special flags that modify the alignment of structure and union members (such as /Zp2) then you will need to recompile Qt with the flags set for the application as well.

If you're using Visual Studio .NET (2002) Standard Edition, you should be using the Qt binary package provided, and not the source package. As the Standard Edition does not optimize compiled code, your compiled version of Qt would perform suboptimally with respect to speed.

With Visual Studio 2005 Service Pack 1 a bug was introduced which causes Qt not to compile, this has been fixed with a hotfix available from Microsoft. See this Knowledge Base entry for more information.


The makeC++SharedLib utility must be in your PATH and be up to date to build shared libraries. From IBM's C and C++ Application Development on AIX Redbook:

VisualAge C++ for AIX, Version 6.0

Make sure you have the latest upgrades installed.

GCCE (Symbian)

GCCE cannot be used to compile Qt libaries for the Symbian platform, but GCCE is supported when compiling Qt applications for Symbian platform.

Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt 4.6.3