summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKai Köhne <kai.koehne@qt.io>2022-08-11 16:20:22 +0200
committerQt Cherry-pick Bot <cherrypick_bot@qt-project.org>2022-08-24 08:10:13 +0000
commit919dce8930ac3019b7ec172993357ccc3a5e4c5e (patch)
tree96bedf6d19320b0ba6e6a5107f2e841f751e9d66
parent6a1000967b753f180f91d398aa1e31261adbc7b0 (diff)
downloadqtdoc-919dce8930ac3019b7ec172993357ccc3a5e4c5e.tar.gz
Plugins: Update information on deploying Qt plugins
Fix description of incompatibilities; Qt will load plugins built with a newer Qt version, if it is limited to the patch level. Remove outdated advise that plugins are only built in release mode, for a debug_and_release build; they are not. Also update Qt version numbers in the given example setup. Change-Id: I6d58b43f791371d21d2cd9fe3e8c66fb37d892e4 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io> Reviewed-by: Jörg Bornemann <joerg.bornemann@qt.io> (cherry picked from commit cc1119daeef19c504397c6cd0af1e1628804586e) Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-rw-r--r--doc/src/deployment/deployment-plugins.qdoc29
1 files changed, 7 insertions, 22 deletions
diff --git a/doc/src/deployment/deployment-plugins.qdoc b/doc/src/deployment/deployment-plugins.qdoc
index 85857216..ff21d5ec 100644
--- a/doc/src/deployment/deployment-plugins.qdoc
+++ b/doc/src/deployment/deployment-plugins.qdoc
@@ -47,19 +47,19 @@
The following rules apply:
\list
- \li Plugins linked with a Qt library that has a higher version number will not be loaded by a
- library with a lower version number.
+ \li Plugins linked with a Qt library that has a higher minor version number will not be loaded by a
+ library with a lower minor version number.
\br
- \b{Example:} Qt 5.0.0 will \e{not} load a plugin built with Qt 5.0.1.
+ \b{Example:} Qt 6.2.0 will \e{not} load a plugin built with Qt 6.3.0.
+ \b{Example:} Qt 6.2.0 will load a plugin built with Qt 6.1.0.
+ \b{Example:} Qt 6.2.0 will load a plugin built with Qt 6.2.1.
\li Plugins linked with a Qt library that has a lower major version number will not be loaded
by a library with a higher major version number.
\br
- \b{Example:} Qt 5.0.1 will \e{not} load a plugin built with Qt 4.8.2.
- \br
- \b{Example:} Qt 5.1.1 will load plugins built with Qt 5.1.0 and Qt 5.0.3.
+ \b{Example:} Qt 6.0.0 will \e{not} load a plugin built with Qt 5.15.0.
\endlist
When building plugins to extend an application, it's important to ensure that the plugin is
@@ -67,19 +67,6 @@
release mode, plugins should be built in release mode, too. Except for Unix operating systems,
where the plugin system will not load plugins built in a different mode from the application.
- If you configure Qt to be built in both debug and release modes, but only build your
- applications in release mode, you need to ensure that your plugins are also built in release
- mode. By default, if a debug build of Qt is available, plugins will \e only be built in debug
- mode. To force the plugins to be built in release mode, add the following line to the plugin's
- project (\c{.pro}) file:
-
- \code
- CONFIG += release
- \endcode
-
- This ensures that the plugin is compatible with the version of the library used in the
- application.
-
\section1 Debugging Plugins
There are a number of issues that may prevent correctly-written plugins from working with the
@@ -102,9 +89,7 @@
\QD shows the plugin libraries in its \uicontrol{Help|About Plugins} dialog, but no
plugins are listed under each of them.
\li The application and its plugins are built in different modes.
- \li Either share the same build information or build the plugins in both debug and release
- modes by appending the \c debug_and_release to the
- \l{qmake Variable Reference#CONFIG}{CONFIG} variable in each of their project files.
+ \li Build the plugin in the same configuration as the executable.
\endtable
*/