diff options
author | Kai Köhne <kai.koehne@qt.io> | 2022-08-11 16:20:22 +0200 |
---|---|---|
committer | Qt Cherry-pick Bot <cherrypick_bot@qt-project.org> | 2022-08-24 08:10:13 +0000 |
commit | 919dce8930ac3019b7ec172993357ccc3a5e4c5e (patch) | |
tree | 96bedf6d19320b0ba6e6a5107f2e841f751e9d66 | |
parent | 6a1000967b753f180f91d398aa1e31261adbc7b0 (diff) | |
download | qtdoc-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.qdoc | 29 |
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 */ |