- Qbs Manual
- Qt Modules
- Qbs 1.19.1

# Qt Modules

The `Qt.*` modules contain properties and rules for Qt.

## Creating Dependencies to Qt Modules

The Qt modules are grouped using the prefix `Qt`. If your product depends on the Qt.core and Qt.network modules, you could write:

     Depends { name: "Qt.core" }
     Depends { name: "Qt.network" }

Or, alternatively:

     Depends { name: "Qt"; submodules: [ "core", "network" ] }

The Qt modules that have properties and relevant file tags are described in separate topics.

## Qt-specific Module Provider Properties

Looking up a Qt installation happens via a module provider. By default, if a dependency to a Qt module is encountered, Qbs collects all Qt installations it can find. This lookup happens by searching for `qmake` executables in the `PATH` environment variable. Alternatively, you can explicitly tell Qbs which Qt installations it should consider by setting the `Qt.qmakeFilePaths` module provider property. In that case, the environment will be ignored. For instance, with the following Linux command line, Qbs will build the project against a custom Qt instead of the standard one in `/usr/bin`:

     $ qbs moduleProviders.Qt.qmakeFilePaths:/opt/myqt/bin/qmake

You can also set the module provider property in a profile. The simplest way to do this is via the setup-qt tool.

## List of Submodules

Submodule Name | Qt Module Name | Notes
--- | --- | ---
axcontainer | QAxContainer | This module is only available on Windows.
axserver | QAxServer | This module is only available on Windows.
concurrent | Qt Concurrent |
core | Qt Core | For more information, see Qt.core.
dbus | Qt D-Bus | For more information, see Qt.dbus.
declarative | Qt Quick 1 | Provides the `Qt Quick 1` module. For more information, see Qt.declarative.
designer | Qt Designer |
enginio | Qt Enginio |
gui | Qt GUI | For more information, see Qt.gui.
help | Qt Help | You do not need this module for building `qdoc` documentation, because that functionality is part of the Qt.core module. This module is for using Qt classes such as `QHelpEngine`.
multimedia | Qt Multimedia |
multimediawidgets | Qt Multimedia Widgets |
network | Qt Network |
opengl | Qt OpenGL |
phonon | Phonon (Qt 4 only) |
printsupport | Qt Print Support |
quick | Qt Quick 2 | Provides the `Qt Quick` module (Qt Quick 2). For more information, see Qt.quick.
quickcontrols2 | Qt Quick Controls 2
qml | Qt QML | For more information, see Qt.qml.
qmltest | Qt Quick Test |
script | Qt Script |
scxml | Qt Scxml | For more information, see Qt.scxml.
sql | Qt SQL |
svg | Qt SVG |
testlib | Qt Test |
webkit | Qt WebKit |
webkitwidgets | Qt WebKit Widgets |
widgets | Qt Widgets |
xml | Qt XML | You do not need this module for the `QXmlStreamReader` and `QXmlStreamWriter` classes, because those classes are a part of the `Qt.core` module. This module provides the deprecated DOM and SAX classes.
xmlpatterns | Qt XML Patterns |  |