Deploying Qt Applications#
Deploying an Qt application does not require any C++ programming. All you need to do is to build Qt and your application in release mode, following the procedures described in this documentation.
Deploying Qt’s Libraries#
Unless Qt is part of the system libraries it must be redistributed with your application. The minimum is to redistribute the run-time of the libraries used by the application. However, with static linking, the Qt run-times can be compiled into the executable.
In general, you should deploy all plugins that your Qt build uses, excluding those that you have identified as unnecessary for your application and its users.
For instance, you may need to deploy plugins for JPEG support and SQL drivers, but you should also deploy plugins that your users may require, including those for accessibility. For more information about plugins, see How to Create Qt Plugins .
Applications using Qt QML also need to ship the QML modules they use.
While deploying an application using the shared library approach, you must ensure that the Qt libraries use the correct path to find the Qt plugins, documentation, translation, and so on. To do this, you can use a
qt.conf file. For more information, see Using qt.conf .
Depending on configuration, compiler-specific libraries must be redistributed as well. For more information, see the platform-specific application dependencies for X11 , Windows , and macOS .
Some of Qt’s libraries are based on third party libraries that are not licensed using the same dual-license model as Qt. As a result, care must be taken when deploying applications that use these libraries, particularly when the application is statically linked to them. For more information, see Third-Party Licenses Used in Qt .
Some configurations of QtNetwork use OpenSSL at run-time. Deployment of OpenSSL libraries is subject to both licensing and export restrictions. For more information, see Secure Sockets Layer (SSL) Classes .
The procedure of deploying Qt applications is different for the various platforms:
Qt for X11 Platforms
Qt for Windows
Qt for macOS
Qt for Android