Skip to content
  • Denis Mingulov's avatar
    Add precompiled headers to Qt Creator sources, to any library and plugin · 69229287
    Denis Mingulov authored
    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: default avatarOswald Buddenhagen <oswald.buddenhagen@nokia.com>
    69229287