Deploying Qt Quick Controls Applications
Deployment of Qt Quick Controls applications is very similar to deployment of other types of Qt applications. However, there are a few factors to consider.
Deploying an Application with Several Styles
Suppose you have an application that will be deployed to both Android and Windows devices. To ensure that only the minimum set of files that are necessary for the application to run are deployed to each device, you can use file selectors. For example, your directory structure could look like this:
resources.qrc main.qml +windows/MyPage.qml +windows/qtquickcontrols2.conf +android/MyPage.qml +android/qtquickcontrols2.conf
In the project above, main.qml
would import QtQuick.Controls
, for example, but shouldn't import, say, QtQuick.Controls.Material
. Any code that is style-specific is moved out into separate files; just as we've done for MyPage.qml
.
The +windows/qtquickcontrols2.conf
file would contain configuration options specific to the Universal style:
[Controls] Style=Universal [Universal] Theme=Dark Accent=Red
The +android/qtquickcontrols2.conf
file would contain configuration options specific to the Material style:
[Controls] Style=Material [Material] Theme=Light Accent=Brown
Static Builds
For dynamically built applications, it is not necessary to import a specific style that should be usable by that application. For statically built applications, Qt's build system must be involved to ensure that QML plugins function as expected. Specifically, qmake
uses qmlimportscanner
to scan the QML files in your application for import statements. For this reason, any styles that should be usable by a statically built application must explicitly import that style. Where the import occurs is up to the developer, but it is recommended to follow the approach mentioned in the Deploying an Application with Several Styles section, so that only the minimum set of files that are necessary for a particular device are deployed.
See also Deploying Qt Applications and Using Styles in Qt Quick Controls.
© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.