Qt is split into components. Each component installs its corresponding Qt5*Config.cmake and libraries.


# same as: hunter_add_package(Qt COMPONENTS qtbase)

find_package(Qt5Concurrent REQUIRED)
find_package(Qt5Core REQUIRED)
find_package(Qt5Gui REQUIRED)
find_package(Qt5Network REQUIRED)
find_package(Qt5OpenGL REQUIRED)
find_package(Qt5OpenGLExtensions REQUIRED)
find_package(Qt5PrintSupport REQUIRED)
find_package(Qt5Sql REQUIRED)
find_package(Qt5Test REQUIRED)
find_package(Qt5Widgets REQUIRED)
find_package(Qt5Xml REQUIRED)
find_package(Qt5DBus REQUIRED)
hunter_add_package(Qt COMPONENTS qtsvg)
find_package(Qt5Svg REQUIRED)
hunter_add_package(Qt COMPONENTS qtxmlpatterns)
find_package(Qt5XmlPatterns REQUIRED)
hunter_add_package(Qt COMPONENTS qtlocation)
find_package(Qt5Positioning REQUIRED)
find_package(Qt5Location REQUIRED)
hunter_add_package(Qt COMPONENTS qtdeclarative)
find_package(Qt5Qml REQUIRED)
find_package(Qt5Quick REQUIRED)
find_package(Qt5QuickTest REQUIRED)
find_package(Qt5QuickWidgets REQUIRED)
hunter_add_package(Qt COMPONENTS qtmultimedia)
find_package(Qt5Multimedia REQUIRED)
find_package(Qt5MultimediaWidgets REQUIRED)
hunter_add_package(Qt COMPONENTS qtsensors)
find_package(Qt5Sensors REQUIRED)
hunter_add_package(Qt COMPONENTS qtwebsockets)
find_package(Qt5WebSockets REQUIRED)
hunter_add_package(Qt COMPONENTS qtwebchannel)
find_package(Qt5WebChannel REQUIRED)
hunter_add_package(Qt COMPONENTS qttools)
find_package(Qt5Designer REQUIRED)
find_package(Qt5Help REQUIRED)
find_package(Qt5LinguistTools REQUIRED)
find_package(Qt5UiPlugin REQUIRED)
find_package(Qt5UiTools REQUIRED)
hunter_add_package(Qt COMPONENTS qtscript)
find_package(Qt5Script REQUIRED)
find_package(Qt5ScriptTools REQUIRED)
hunter_add_package(Qt COMPONENTS qtquick1)
find_package(Qt5Declarative REQUIRED)
hunter_add_package(Qt COMPONENTS qtimageformats)
find_package(Qt5Gui) # load plugins
# targets available:
#  * Qt5::QDDSPlugin
#  * Qt5::QICNSPlugin
#  * Qt5::QJp2Plugin
#  * Qt5::QMngPlugin
#  * Qt5::QTgaPlugin
#  * Qt5::QTiffPlugin
#  * Qt5::QWbmpPlugin
#  * Qt5::QWebpPlugin
hunter_add_package(Qt COMPONENTS qtquickcontrols)
# no *.cmake modules installed


    • Build with gstreamer
    • You will need this when building Qt application with camera support on Linux
    • Adds -gstreamer 1.0
    • Only configuration with shared libraries tested. Also you have to set runtime paths with LD_LIBRARY_PATH/GST_PLUGIN_PATH, see example.
    • To test GStreamer camera you can run gst-launch -v -m camerabin

Windows “path too long”

Using HUNTER_BINARY_DIR is not helping with path too long errors. The only way to build Qt is to use short path for HUNTER_ROOT directory.


  • Python is required to be in PATH if you’re building the qtdeclarative component
  • Conflicts with system Qt: bug with workaround
  • iOS (Qt < 5.9): you must use qtmn instead of main:
#include <QtGlobal> // Q_OS_IOS

#if defined(Q_OS_IOS)
extern "C" int qtmn(int argc, char** argv) {
int main(int argc, char **argv) {

you will see next error without this fix applied:

Error: You are creating QApplication before calling UIApplicationMain.
If you are writing a native iOS application, and only want to use Qt for
parts of the application, a good place to create QApplication is from
within 'applicationDidFinishLaunching' inside your UIApplication
  • QtQuick2Plugin conflict.

    Both plugins/qmltooling/libqmldbg_qtquick2.a and qml/QtQuick.2/libqtquick2plugin.a implement this plugin:

[Install]> nm -gU plugins/qmltooling/libqmldbg_qtquick2.a | grep static_plugin
00000000000000b0 T __Z31qt_static_plugin_QtQuick2Pluginv
[Install]> nm -gU qml/QtQuick.2/libqtquick2plugin.a | grep static_plugin
0000000000000080 T __Z31qt_static_plugin_QtQuick2Pluginv

Linking of libqmldbg_qtquick2.a may lead to the next runtime error:

module "QtQuick" plugin "qtquick2plugin" not found

if you see this error try to remove usage of target Qt5::QtQuick2Plugin and variable Qt5Qml_PLUGINS.

  • Static QML plugins loading issue and workaround: https://bugreports.qt.io/browse/QTBUG-35754

  • iOS with armv7s architecture is broken: https://bugreports.qt.io/browse/QTBUG-48805

  • Errors when compiling on Linux Debian without manually installing some Qt dependencies first. See Qt Issue 2. The Problem can be fixed by installing the necessary libraries before calling CMake with the command:

    > sudo apt-get install libfontconfig1-dev libfreetype6-dev libx11-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev libxcb1-dev libx11-xcb-dev libxcb-glx0-dev
  • Requirements for Ubuntu for Hunter v0.14.14+ (need GL,EGL: /usr/include/GL/gl.h, usr/include/EGL/egl.h):

    > sudo apt-get install libegl1-mesa-dev libgl1-mesa-dev libegl1-mesa-drivers
  • Extra libraries for Android tools on Ubuntu needed (see this answer)