Bumping QML Module Versions

This page documents the process for bumping a QML module in Qt, using Qt Quick Controls 2 as an example.

Bump MODULE_VERSION, qmldirs and docs

MODULE_VERSION determines the module version used by "make qmltypes" (which runs qmlplugindump, a tool used to create plugins.qmltypes).

qmldir files are explained here. In the case of Qt Quick Controls 2, it has a dependency to Qt Quick Templates, hence why it must be bumped.

Any documentation files that mention the version number should be bumped as well. For example:

https://codereview.qt-project.org/#/c/221809/2/src/imports/controls/doc/src/qtquickcontrols2-qmltypes.qdoc

This patch bumps all three at once:

https://codereview.qt-project.org/#/c/221809/

Bump imports of QML files using the module itself

For example:

https://codereview.qt-project.org/#/c/221211/

Bump plugins.qmltypes

For example:

https://codereview.qt-project.org/#/c/221397/

Bump any imported versions of QML files that follow the Qt version

Qt's version is bumped by increasing MODULE_VERSION in qtbase/.qmake.conf:

https://github.com/qt/qtbase/commit/df9de3e4543b8f8bf4ec4c53921700133e37f051

QT_VERSION is then deduced from that:

http://code.qt.io/cgit/qt/qtbase.git/tree/configure#n343

After that, the Qt version bump in qtbase will need to integrate to qt5.git. For example, in the case of the commit above, that was done here:

https://codereview.qt-project.org/#/c/204113/

Once all of that has happened, any imports of a module whose version follows the Qt version (such as QtQuick) can be bumped:

https://codereview.qt-project.org/#/c/220052/