diff options
Diffstat (limited to 'src/corelib/doc/src/cmake/qt_add_plugin.qdoc')
| -rw-r--r-- | src/corelib/doc/src/cmake/qt_add_plugin.qdoc | 25 |
1 files changed, 23 insertions, 2 deletions
diff --git a/src/corelib/doc/src/cmake/qt_add_plugin.qdoc b/src/corelib/doc/src/cmake/qt_add_plugin.qdoc index 89a68dbee2..d2322086e7 100644 --- a/src/corelib/doc/src/cmake/qt_add_plugin.qdoc +++ b/src/corelib/doc/src/cmake/qt_add_plugin.qdoc @@ -2,11 +2,11 @@ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! -\page qt_add_plugin.html +\page qt-add-plugin.html \ingroup cmake-commands-qtcore \title qt_add_plugin -\target qt6_add_plugin +\keyword qt6_add_plugin \summary {Creates a Qt plugin target.} @@ -21,9 +21,14 @@ qt_add_plugin(target [SHARED | STATIC] [CLASS_NAME class_name] [OUTPUT_TARGETS variable_name] + [MANUAL_FINALIZATION] + sources... ) \endcode +The \c MANUAL_FINALIZATION option and the ability to set sources +were introduced in Qt 6.5. + \versionlessCMakeCommandsNote qt6_add_plugin() \section1 Description @@ -37,6 +42,9 @@ By default, the plugin will be created as a \c STATIC library if Qt was built statically, or as a \c MODULE library otherwise. You can override this default by explicitly providing the \c STATIC or \c SHARED option. +Any \c{sources} provided will be passed through to the internal call to +\c{add_library()}. + \note Non-static plugins are meant to be loaded dynamically at runtime, not linked to at build time. CMake differentiates between these two scenarios by providing the \c MODULE library type for dynamically loaded libraries, and @@ -63,4 +71,17 @@ project should also install these internal targets. The names of these targets can be obtained by providing the \c OUTPUT_TARGETS option, followed by the name of a variable in which to return the target list. +\section2 Finalization + +After a target is created, further processing or \e{finalization} steps may be +needed. The finalization processing is implemented by the +\l{qt6_finalize_target}{qt_finalize_target()} command. + +For details and the meaning of the \c{MANUAL_FINALIZATION} option, refer to the +\l{qt_add_library finalization}{finalization documentation} for +\c{qt_add_library}. + +\sa {qt6_finalize_target}{qt_finalize_target()}, + {qt6_add_executable}{qt_add_executable()} + */ |