OSDN Git Service

Add precompiled headers to Qt Creator sources, to any library and plugin
authorDenis Mingulov <denis.mingulov@gmail.com>
Wed, 13 Oct 2010 12:02:49 +0000 (14:02 +0200)
committerOswald Buddenhagen <oswald.buddenhagen@nokia.com>
Wed, 13 Oct 2010 12:08:26 +0000 (14:08 +0200)
commit692292871b06f51729793a8ce17912797093a333
treed53a5881661f38913799bf661fbaf86ca50b6efa
parent90efb2c0598d49130ada9195fd8ffa41ff4ece42
Add precompiled headers to Qt Creator sources, to any library and plugin

Precompiled headers are a performance feature supported by some
compilers to reduce the (re-)compilation time substantially.
Usage in Qt: http://doc.qt.nokia.com/4.7/qmake-precompiledheaders.html

Due to the usage of precompiled headers Qt without demos/examples/webkit
etc might be compiled even faster than Qt Creator on some systems.
Despite of Qt, Qt Creator consist of mostly quite small subprojects
(plugins and libraries) where the effect would not be so noticeable
but still will be visible.

This patch adds default precompiled headers to any plugin and library
(i.e. by changes in src/qtcreatorplugin.pri and src/qtcreatorlibrary.pri
respectively). Almost the same headers are included to general
precompiled header (src/shared/qtcreator_pch.h) like used in QtCore,
just QPointer/QScopedPointer etc and QDebug are added, it is used almost
in any subproject. Also for plugins some QtGui related headers are added
(src/shared/qtcreator_gui_pch.h).

Default precompiled headers are enabled so:

isEmpty(PRECOMPILED_HEADER):PRECOMPILED_HEADER = $$PWD/shared/header.h

So it is possible to override this variable in any place in the project
file in case if it will be needed.

Such overriding is used for Botan (src/libs/3rdparty/botan) - it is
not a Qt project, just a pure C++. Most usable headers were used to
create special precompiled header for Botan. It is 3rd party component
so also src/libs/3rdparty/precompiled_headers folder was created -
to use for any future 3rd party components' precompiled headers.

To enable a usage of precompiled headers feature in Qt projects
'precompile_header' has to be added to CONFIG. It is done by default
for limited platforms only (e.g. not for Linux now), so to enable it on
any other platform - e.g. special qmake command has to be used:

qmake "CONFIG *= precompile_header" -r ../../qt-creator/

To disable a usage of precompiled headers (on platforms where it is
pre-enabled - otherwise it will be used automatically):

qmake "CONFIG -= precompile_header" -r ../../qt-creator/

To see on which platforms precompiled headers feature is enabled
by default - qt/mkspecs folder has to be checked.

Precompiled headers require an additional space on the disk, it looks
like for Qt Creator full size of the shadow build folder grows up to
2 times (e.g. 1.5 GB to 3 GB).

Test results:

Linux x64, gcc 4.4, T7500, 3 GB RAM: About 22.5 minutes are reduced
to about 14 minutes (almost 80% faster).

Windows x86, vs2008, P8400, 2 GB RAM: About 70 minutes are reduced
to about 20 minutes (amazing 250% faster).

Merge-request: 2182
Reviewed-by: Oswald Buddenhagen <oswald.buddenhagen@nokia.com>
src/libs/3rdparty/botan/src/src.pro
src/libs/3rdparty/precompiled_headers/botan_pch.h [new file with mode: 0644]
src/qtcreatorlibrary.pri
src/qtcreatorplugin.pri
src/shared/qtcreator_gui_pch.h [new file with mode: 0644]
src/shared/qtcreator_pch.h [new file with mode: 0644]