Doc: Update CMake functions in Qt Core for Qt 6
Change-Id: Ica6141f183c75f60e5b1031c0972f79de7821841 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io> (cherry picked from commit f74e572cb7aff59d3a64d1761370b0a88d5ec7c6) Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Kai Koehne
Qt Cherry-pick Bot
parent
2f7fcebf3b
commit
5d45a1d83a
@ -26,42 +26,11 @@
|
|||||||
****************************************************************************/
|
****************************************************************************/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\page qtcore-cmake-qt5-wrap-cpp.html
|
\page qt_wrap_cpp.html
|
||||||
\ingroup cmake-macros-qtcore
|
|
||||||
|
|
||||||
\title qt5_wrap_cpp
|
|
||||||
|
|
||||||
\brief Creates \c{.moc} files from sources.
|
|
||||||
|
|
||||||
\section1 Synopsis
|
|
||||||
|
|
||||||
\badcode
|
|
||||||
qt5_wrap_cpp(<VAR> src_file1 [src_file2 ...]
|
|
||||||
[TARGET target]
|
|
||||||
[OPTIONS ...]
|
|
||||||
[DEPENDS ...])
|
|
||||||
\endcode
|
|
||||||
|
|
||||||
\section1 Description
|
|
||||||
|
|
||||||
\include includes/qt_wrap_cpp.qdocinc description
|
|
||||||
|
|
||||||
\note For compatibility with Qt 6, the command is also available under the name \l qt_wrap_cpp.
|
|
||||||
|
|
||||||
\section1 Arguments
|
|
||||||
|
|
||||||
\include includes/qt_wrap_cpp.qdocinc arguments
|
|
||||||
|
|
||||||
\section1 Examples
|
|
||||||
|
|
||||||
\snippet cmake-macros/examples.cmake qt5_wrap_cpp
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*!
|
|
||||||
\page qtcore-cmake-qt-wrap-cpp.html
|
|
||||||
\ingroup cmake-macros-qtcore
|
\ingroup cmake-macros-qtcore
|
||||||
|
|
||||||
\title qt_wrap_cpp
|
\title qt_wrap_cpp
|
||||||
|
\target qt6_wrap_cpp
|
||||||
|
|
||||||
\brief Creates \c{.moc} files from sources.
|
\brief Creates \c{.moc} files from sources.
|
||||||
|
|
||||||
@ -72,17 +41,35 @@ qt_wrap_cpp(<VAR> src_file1 [src_file2 ...]
|
|||||||
[TARGET target]
|
[TARGET target]
|
||||||
[OPTIONS ...]
|
[OPTIONS ...]
|
||||||
[DEPENDS ...])
|
[DEPENDS ...])
|
||||||
|
|
||||||
|
qt6_wrap_cpp(<VAR> src_file1 [src_file2 ...]
|
||||||
|
[TARGET target]
|
||||||
|
[OPTIONS ...]
|
||||||
|
[DEPENDS ...])
|
||||||
\endcode
|
\endcode
|
||||||
|
|
||||||
\section1 Description
|
\section1 Description
|
||||||
|
|
||||||
\include includes/qt_wrap_cpp.qdocinc description
|
Creates rules for calling the \l{moc}{Meta-Object Compiler (moc)} on the given
|
||||||
|
source files. For each input file, an output file is generated in the build
|
||||||
|
directory. The paths of the generated files are added to \c{<VAR>}.
|
||||||
|
|
||||||
This command was introduced in Qt 5.15. You can use \l qt5_wrap_cpp in older versions of Qt.
|
\note This is a low-level macro. See the \l{CMake AUTOMOC Documentation} for a
|
||||||
|
more convenient way to let source files be processed with \c{moc}.
|
||||||
|
|
||||||
\section1 Arguments
|
\section1 Arguments
|
||||||
|
|
||||||
\include includes/qt_wrap_cpp.qdocinc arguments
|
You can set an explicit \c{TARGET}. This will make sure that the target
|
||||||
|
properties \c{INCLUDE_DIRECTORIES} and \c{COMPILE_DEFINITIONS} are also used
|
||||||
|
when scanning the source files with \c{moc}.
|
||||||
|
|
||||||
|
You can set additional \c{OPTIONS} that should be added to the \c{moc} calls.
|
||||||
|
You can find possible options in the \l{moc}{moc documentation}.
|
||||||
|
|
||||||
|
\c{DEPENDS} allows you to add additional dependencies for recreation of the
|
||||||
|
generated files. This is useful when the sources have implicit dependencies,
|
||||||
|
like code for a Qt plugin that includes a \c{.json} file using the
|
||||||
|
Q_PLUGIN_METADATA() macro.
|
||||||
|
|
||||||
\section1 Examples
|
\section1 Examples
|
||||||
|
|
||||||
@ -90,42 +77,11 @@ This command was introduced in Qt 5.15. You can use \l qt5_wrap_cpp in older ver
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\page qtcore-cmake-qt5-add-resources.html
|
\page qt_add_resources.html
|
||||||
\ingroup cmake-macros-qtcore
|
|
||||||
|
|
||||||
\title qt5_add_resources
|
|
||||||
|
|
||||||
\brief Compiles binary resources into source code.
|
|
||||||
|
|
||||||
\section1 Synopsis
|
|
||||||
|
|
||||||
\badcode
|
|
||||||
qt5_add_resources(<VAR> file1.qrc [file2.qrc ...]
|
|
||||||
[OPTIONS ...])
|
|
||||||
\endcode
|
|
||||||
|
|
||||||
\section1 Description
|
|
||||||
|
|
||||||
\include includes/qt_add_resources.qdocinc arguments
|
|
||||||
|
|
||||||
For embedding bigger resources, see \l qt5_add_big_resources.
|
|
||||||
|
|
||||||
\note For compatibility with Qt 6, the command is also available under the name \l qt_add_resources.
|
|
||||||
|
|
||||||
\section1 Arguments
|
|
||||||
|
|
||||||
\include includes/qt_add_resources.qdocinc arguments
|
|
||||||
|
|
||||||
\section1 Examples
|
|
||||||
|
|
||||||
\snippet cmake-macros/examples.cmake qt5_add_resources
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*!
|
|
||||||
\page qtcore-cmake-qt-add-resources.html
|
|
||||||
\ingroup cmake-macros-qtcore
|
\ingroup cmake-macros-qtcore
|
||||||
|
|
||||||
\title qt_add_resources
|
\title qt_add_resources
|
||||||
|
\target qt6_add_resources
|
||||||
|
|
||||||
\brief Compiles binary resources into source code.
|
\brief Compiles binary resources into source code.
|
||||||
|
|
||||||
@ -134,19 +90,26 @@ For embedding bigger resources, see \l qt5_add_big_resources.
|
|||||||
\badcode
|
\badcode
|
||||||
qt_add_resources(<VAR> file1.qrc [file2.qrc ...]
|
qt_add_resources(<VAR> file1.qrc [file2.qrc ...]
|
||||||
[OPTIONS ...])
|
[OPTIONS ...])
|
||||||
|
|
||||||
|
qt6_add_resources(<VAR> file1.qrc [file2.qrc ...]
|
||||||
|
[OPTIONS ...])
|
||||||
\endcode
|
\endcode
|
||||||
|
|
||||||
\section1 Description
|
\section1 Description
|
||||||
|
|
||||||
\include includes/qt_add_resources.qdocinc arguments
|
Creates source code from Qt resource files using the
|
||||||
|
\l{Resource Compiler (rcc)}. Paths to the generated source files are added to
|
||||||
|
\c{<VAR>}.
|
||||||
|
|
||||||
|
\note This is a low-level macro. See the \l{CMake AUTORCC Documentation} for a
|
||||||
|
more convenient way to let Qt resource files be processed with \c{rcc}.
|
||||||
|
|
||||||
For embedding bigger resources, see \l qt_add_big_resources.
|
For embedding bigger resources, see \l qt_add_big_resources.
|
||||||
|
|
||||||
This command was introduced in Qt 5.15. You can use \l qt5_add_resources in older versions of Qt.
|
|
||||||
|
|
||||||
\section1 Arguments
|
\section1 Arguments
|
||||||
|
|
||||||
\include includes/qt_add_resources.qdocinc arguments
|
You can set additional \c{OPTIONS} that should be added to the \c{rcc} calls.
|
||||||
|
You can find possible options in the \l{rcc}{rcc documentation}.
|
||||||
|
|
||||||
\section1 Examples
|
\section1 Examples
|
||||||
|
|
||||||
@ -154,40 +117,11 @@ This command was introduced in Qt 5.15. You can use \l qt5_add_resources in olde
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\page qtcore-cmake-qt5-add-big-resources.html
|
\page qt_add_bigresources.html
|
||||||
\ingroup cmake-macros-qtcore
|
|
||||||
|
|
||||||
\title qt5_add_big_resources
|
|
||||||
|
|
||||||
\brief Compiles big binary resources into object code.
|
|
||||||
|
|
||||||
\section1 Synopsis
|
|
||||||
|
|
||||||
\badcode
|
|
||||||
qt5_add_big_resources(<VAR> file1.qrc [file2.qrc ...]
|
|
||||||
[OPTIONS ...])
|
|
||||||
\endcode
|
|
||||||
|
|
||||||
\section1 Description
|
|
||||||
|
|
||||||
\include includes/qt_add_big_resources.qdocinc description
|
|
||||||
|
|
||||||
\note For compatibility with Qt 6, the command is also available under the name \l qt_add_big_resources.
|
|
||||||
|
|
||||||
\section1 Arguments
|
|
||||||
|
|
||||||
\include includes/qt_add_big_resources.qdocinc arguments
|
|
||||||
|
|
||||||
\section1 Examples
|
|
||||||
|
|
||||||
\snippet cmake-macros/examples.cmake qt5_add_big_resources
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*!
|
|
||||||
\page qtcore-cmake-qt-add-big-resources.html
|
|
||||||
\ingroup cmake-macros-qtcore
|
\ingroup cmake-macros-qtcore
|
||||||
|
|
||||||
\title qt_add_big_resources
|
\title qt_add_big_resources
|
||||||
|
\target qt6_add_big_resources
|
||||||
|
|
||||||
\brief Compiles big binary resources into object code.
|
\brief Compiles big binary resources into object code.
|
||||||
|
|
||||||
@ -196,17 +130,28 @@ qt5_add_big_resources(<VAR> file1.qrc [file2.qrc ...]
|
|||||||
\badcode
|
\badcode
|
||||||
qt_add_big_resources(<VAR> file1.qrc [file2.qrc ...]
|
qt_add_big_resources(<VAR> file1.qrc [file2.qrc ...]
|
||||||
[OPTIONS ...])
|
[OPTIONS ...])
|
||||||
|
|
||||||
|
qt6_add_big_resources(<VAR> file1.qrc [file2.qrc ...]
|
||||||
|
[OPTIONS ...])
|
||||||
\endcode
|
\endcode
|
||||||
|
|
||||||
\section1 Description
|
\section1 Description
|
||||||
|
|
||||||
\include includes/qt_add_big_resources.qdocinc description
|
Creates compiled object files from Qt resource files using the
|
||||||
|
\l{Resource Compiler (rcc)}. Paths to the generated files are added to
|
||||||
|
\c{<VAR>}.
|
||||||
|
|
||||||
This command was introduced in Qt 5.15. You can use \l qt5_add_big_resources in older versions of Qt.
|
This is similar to \l qt_add_resources, but directly
|
||||||
|
generates object files (\c .o, \c .obj) files instead of C++ source code.
|
||||||
|
This allows to embed bigger resources, where compiling to C++ sources and then
|
||||||
|
to binaries would be too time consuming or memory intensive.
|
||||||
|
|
||||||
|
\note This macro is only available if using \c{CMake} 3.9 or later.
|
||||||
|
|
||||||
\section1 Arguments
|
\section1 Arguments
|
||||||
|
|
||||||
\include includes/qt_add_big_resources.qdocinc arguments
|
You can set additional \c{OPTIONS} that should be added to the \c{rcc} calls.
|
||||||
|
You can find possible options in the \l{rcc}{rcc documentation}.
|
||||||
|
|
||||||
\section1 Examples
|
\section1 Examples
|
||||||
|
|
||||||
@ -214,41 +159,11 @@ This command was introduced in Qt 5.15. You can use \l qt5_add_big_resources in
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\page qtcore-cmake-qt5_add_binary_resources.html
|
\page qt_add_binary_resources.html
|
||||||
\ingroup cmake-macros-qtcore
|
|
||||||
|
|
||||||
\title qt5_add_binary_resources
|
|
||||||
|
|
||||||
\brief Creates an \c{RCC} file from a list of Qt resource files.
|
|
||||||
|
|
||||||
\section1 Synopsis
|
|
||||||
|
|
||||||
\badcode
|
|
||||||
qt5_add_binary_resources(target file1.qrc [file2.qrc ...]
|
|
||||||
[DESTINATION ...]
|
|
||||||
[OPTIONS ...])
|
|
||||||
\endcode
|
|
||||||
|
|
||||||
\section1 Description
|
|
||||||
|
|
||||||
\include includes/qt_add_binary_resources.qdocinc description
|
|
||||||
|
|
||||||
\note For compatibility with Qt 6, the command is also available under the name \l qt_add_binary_resources.
|
|
||||||
|
|
||||||
\section1 Arguments
|
|
||||||
|
|
||||||
\include includes/qt_add_binary_resources.qdocinc arguments
|
|
||||||
|
|
||||||
\section1 Examples
|
|
||||||
|
|
||||||
\snippet cmake-macros/examples.cmake qt5_add_binary_resources
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*!
|
|
||||||
\page qtcore-cmake-qt_add_binary_resources.html
|
|
||||||
\ingroup cmake-macros-qtcore
|
\ingroup cmake-macros-qtcore
|
||||||
|
|
||||||
\title qt_add_binary_resources
|
\title qt_add_binary_resources
|
||||||
|
\target qt6_add_binary_resources
|
||||||
|
|
||||||
\brief Creates an \c{RCC} file from a list of Qt resource files.
|
\brief Creates an \c{RCC} file from a list of Qt resource files.
|
||||||
|
|
||||||
@ -258,17 +173,24 @@ qt5_add_binary_resources(target file1.qrc [file2.qrc ...]
|
|||||||
qt_add_binary_resources(target file1.qrc [file2.qrc ...]
|
qt_add_binary_resources(target file1.qrc [file2.qrc ...]
|
||||||
[DESTINATION ...]
|
[DESTINATION ...]
|
||||||
[OPTIONS ...])
|
[OPTIONS ...])
|
||||||
|
|
||||||
|
qt6_add_binary_resources(target file1.qrc [file2.qrc ...]
|
||||||
|
[DESTINATION ...]
|
||||||
|
[OPTIONS ...])
|
||||||
\endcode
|
\endcode
|
||||||
|
|
||||||
\section1 Description
|
\section1 Description
|
||||||
|
|
||||||
\include includes/qt_add_binary_resources.qdocinc description
|
Adds a custom \c target that compiles Qt resource files into a binary \c{.rcc}
|
||||||
|
file.
|
||||||
This command was introduced in Qt 5.15. You can use \l qt5_add_binary_resources in older versions of Qt.
|
|
||||||
|
|
||||||
\section1 Arguments
|
\section1 Arguments
|
||||||
|
|
||||||
\include includes/qt_add_binary_resources.qdocinc arguments
|
\c{DESTINATION} sets the path of the generated \c{.rcc} file. The default is
|
||||||
|
\c{${CMAKE_CURRENT_BINARY_DIR}/${target}.rcc}.
|
||||||
|
|
||||||
|
You can set additional \c{OPTIONS} that should be added to the \c{rcc} calls.
|
||||||
|
You can find possible options in the \l{rcc}{rcc documentation}.
|
||||||
|
|
||||||
\section1 Examples
|
\section1 Examples
|
||||||
|
|
||||||
@ -276,40 +198,11 @@ This command was introduced in Qt 5.15. You can use \l qt5_add_binary_resources
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\page qtcore-cmake-qt5-generate-moc.html
|
\page qt_generate_moc.html
|
||||||
\ingroup cmake-macros-qtcore
|
|
||||||
|
|
||||||
\title qt5_generate_moc
|
|
||||||
|
|
||||||
\brief Calls moc on an input file.
|
|
||||||
|
|
||||||
\section1 Synopsis
|
|
||||||
|
|
||||||
\badcode
|
|
||||||
qt5_generate_moc(src_file dest_file
|
|
||||||
[TARGET target])
|
|
||||||
\endcode
|
|
||||||
|
|
||||||
\section1 Description
|
|
||||||
|
|
||||||
\include includes/qt_generate_moc.qdocinc description
|
|
||||||
|
|
||||||
\note For compatibility with Qt 6, the command is also available under the name \l qt_generate_moc.
|
|
||||||
|
|
||||||
\section1 Arguments
|
|
||||||
|
|
||||||
\include includes/qt_generate_moc.qdocinc arguments
|
|
||||||
|
|
||||||
\section1 Examples
|
|
||||||
|
|
||||||
\snippet cmake-macros/examples.cmake qt5_generate_moc
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*!
|
|
||||||
\page qtcore-cmake-qt-generate-moc.html
|
|
||||||
\ingroup cmake-macros-qtcore
|
\ingroup cmake-macros-qtcore
|
||||||
|
|
||||||
\title qt_generate_moc
|
\title qt_generate_moc
|
||||||
|
\target qt6_generate_moc
|
||||||
|
|
||||||
\brief Calls moc on an input file.
|
\brief Calls moc on an input file.
|
||||||
|
|
||||||
@ -318,17 +211,26 @@ qt5_generate_moc(src_file dest_file
|
|||||||
\badcode
|
\badcode
|
||||||
qt_generate_moc(src_file dest_file
|
qt_generate_moc(src_file dest_file
|
||||||
[TARGET target])
|
[TARGET target])
|
||||||
|
|
||||||
|
qt6_generate_moc(src_file dest_file
|
||||||
|
[TARGET target])
|
||||||
\endcode
|
\endcode
|
||||||
|
|
||||||
\section1 Description
|
\section1 Description
|
||||||
|
|
||||||
\include includes/qt_generate_moc.qdocinc description
|
Creates a rule to call the \l{moc}{Meta-Object Compiler (moc)} on \c src_file
|
||||||
|
and store the output in \c dest_file.
|
||||||
|
|
||||||
This command was introduced in Qt 5.15. You can use \l qt5_generate_moc in older versions of Qt.
|
\note This is a low-level macro. See the \l{CMake AUTOMOC Documentation} for a
|
||||||
|
more convenient way to let source files be processed with \c{moc}.
|
||||||
|
\l qt_wrap_cpp is also similar, but automatically generates a temporary file
|
||||||
|
path for you.
|
||||||
|
|
||||||
\section1 Arguments
|
\section1 Arguments
|
||||||
|
|
||||||
\include includes/qt_generate_moc.qdocinc arguments
|
You can set an explicit \c{TARGET}. This will make sure that the target
|
||||||
|
properties \c{INCLUDE_DIRECTORIES} and \c{COMPILE_DEFINITIONS} are also used
|
||||||
|
when scanning the source files with \c{moc}.
|
||||||
|
|
||||||
\section1 Examples
|
\section1 Examples
|
||||||
|
|
||||||
@ -336,50 +238,11 @@ This command was introduced in Qt 5.15. You can use \l qt5_generate_moc in older
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\page qtcore-cmake-qt5-import-plugins.html
|
\page qt_import_plugins.html
|
||||||
\ingroup cmake-macros-qtcore
|
|
||||||
|
|
||||||
\title qt5_import_plugins
|
|
||||||
|
|
||||||
\brief Specifies a custom set of plugins to import for a static Qt build
|
|
||||||
|
|
||||||
\section1 Synopsis
|
|
||||||
|
|
||||||
\badcode
|
|
||||||
qt5_import_plugins(target
|
|
||||||
[INCLUDE plugin ...]
|
|
||||||
[EXCLUDE plugin ...]
|
|
||||||
[INCLUDE_BY_TYPE plugin_type plugin ...]
|
|
||||||
[EXCLUDE_BY_TYPE plugin_type])
|
|
||||||
\endcode
|
|
||||||
|
|
||||||
\section1 Description
|
|
||||||
|
|
||||||
\include includes/qt_import_plugins.qdocinc description
|
|
||||||
|
|
||||||
\note For compatibility with Qt 6, the command is also available under the name \l qt_import_plugins.
|
|
||||||
|
|
||||||
\section1 Examples
|
|
||||||
|
|
||||||
\snippet cmake-macros/examples.cmake qt5_import_plugins
|
|
||||||
|
|
||||||
In the snippet above, the following occurs with the executable \c myapp:
|
|
||||||
|
|
||||||
\list
|
|
||||||
\li The \c Qt5::QCocoaIntegrationPlugin is imported into myapp.
|
|
||||||
\li The \c Qt5::QMinimalIntegrationPlugin plugin is
|
|
||||||
excluded from being automatically imported into myapp.
|
|
||||||
\li The default list of plugins for \c imageformats is
|
|
||||||
overridden to only include Qt5::QGifPlugin and Qt5::QJpegPlugin.
|
|
||||||
\li All \c sqldrivers plugins are excluded from automatic importing.
|
|
||||||
\endlist
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*!
|
|
||||||
\page qtcore-cmake-qt-import-plugins.html
|
|
||||||
\ingroup cmake-macros-qtcore
|
\ingroup cmake-macros-qtcore
|
||||||
|
|
||||||
\title qt_import_plugins
|
\title qt_import_plugins
|
||||||
|
\target qt6_import_plugins
|
||||||
|
|
||||||
\brief Specifies a custom set of plugins to import for a static Qt build
|
\brief Specifies a custom set of plugins to import for a static Qt build
|
||||||
|
|
||||||
@ -391,13 +254,43 @@ qt_import_plugins(target
|
|||||||
[EXCLUDE plugin ...]
|
[EXCLUDE plugin ...]
|
||||||
[INCLUDE_BY_TYPE plugin_type plugin ...]
|
[INCLUDE_BY_TYPE plugin_type plugin ...]
|
||||||
[EXCLUDE_BY_TYPE plugin_type])
|
[EXCLUDE_BY_TYPE plugin_type])
|
||||||
|
|
||||||
|
qt6_import_plugins(target
|
||||||
|
[INCLUDE plugin ...]
|
||||||
|
[EXCLUDE plugin ...]
|
||||||
|
[INCLUDE_BY_TYPE plugin_type plugin ...]
|
||||||
|
[EXCLUDE_BY_TYPE plugin_type])
|
||||||
\endcode
|
\endcode
|
||||||
|
|
||||||
\section1 Description
|
\section1 Description
|
||||||
|
|
||||||
\include includes/qt_import_plugins.qdocinc description
|
Specifies a custom set of plugins to import. The optional arguments:
|
||||||
|
\c INCLUDE, \c EXCLUDE, \c INCLUDE_BY_TYPE, and \c EXCLUDE_BY_TYPE,
|
||||||
|
can be used more than once.
|
||||||
|
|
||||||
This command was introduced in Qt 5.15. You can use \l qt5_import_plugins in older versions of Qt.
|
\list
|
||||||
|
\li \c INCLUDE -- can be used to specify a list of plugins to import.
|
||||||
|
\li \c EXCLUDE -- can be used to specify a list of plugins to exclude.
|
||||||
|
\li \c INCLUDE_BY_TYPE -- can be used to override the list of plugins to
|
||||||
|
import for a certain plugin type.
|
||||||
|
\li \c EXCLUDE_BY_TYPE -- can be used to specify a plugin type to exclude;
|
||||||
|
then no plugins of that type are imported.
|
||||||
|
\endlist
|
||||||
|
|
||||||
|
Qt provides plugin types such as \c imageformats, \c platforms,
|
||||||
|
and \c sqldrivers.
|
||||||
|
|
||||||
|
If the command isn't used the target automatically links against
|
||||||
|
a sane set of default plugins, for each Qt module that the target is linked
|
||||||
|
against. For more information, see
|
||||||
|
\l{CMake target_link_libraries Documentation}{target_link_libraries}.
|
||||||
|
|
||||||
|
Each plugin comes with a C++ stub file that automatically
|
||||||
|
initializes the plugin. Consequently, any target that links against a plugin
|
||||||
|
has this C++ file added to its \c SOURCES.
|
||||||
|
|
||||||
|
\note This command imports plugins from static Qt builds only.
|
||||||
|
On shared builds, it does nothing.
|
||||||
|
|
||||||
\section1 Examples
|
\section1 Examples
|
||||||
|
|
||||||
@ -406,11 +299,11 @@ This command was introduced in Qt 5.15. You can use \l qt5_import_plugins in old
|
|||||||
In the snippet above, the following occurs with the executable \c myapp:
|
In the snippet above, the following occurs with the executable \c myapp:
|
||||||
|
|
||||||
\list
|
\list
|
||||||
\li The \c Qt5::QCocoaIntegrationPlugin is imported into myapp.
|
\li The \c Qt6::QCocoaIntegrationPlugin is imported into myapp.
|
||||||
\li The \c Qt5::QMinimalIntegrationPlugin plugin is
|
\li The \c Qt6::QMinimalIntegrationPlugin plugin is
|
||||||
excluded from being automatically imported into myapp.
|
excluded from being automatically imported into myapp.
|
||||||
\li The default list of plugins for \c imageformats is
|
\li The default list of plugins for \c imageformats is
|
||||||
overridden to only include Qt5::QGifPlugin and Qt5::QJpegPlugin.
|
overridden to only include Qt6::QGifPlugin and Qt6::QJpegPlugin.
|
||||||
\li All \c sqldrivers plugins are excluded from automatic importing.
|
\li All \c sqldrivers plugins are excluded from automatic importing.
|
||||||
\endlist
|
\endlist
|
||||||
*/
|
*/
|
||||||
|
|||||||
@ -1,44 +0,0 @@
|
|||||||
/****************************************************************************
|
|
||||||
**
|
|
||||||
** Copyright (C) 2020 The Qt Company Ltd.
|
|
||||||
** Contact: https://www.qt.io/licensing/
|
|
||||||
**
|
|
||||||
** This file is part of the documentation of the Qt Toolkit.
|
|
||||||
**
|
|
||||||
** $QT_BEGIN_LICENSE:FDL$
|
|
||||||
** Commercial License Usage
|
|
||||||
** Licensees holding valid commercial Qt licenses may use this file in
|
|
||||||
** accordance with the commercial license agreement provided with the
|
|
||||||
** Software or, alternatively, in accordance with the terms contained in
|
|
||||||
** a written agreement between you and The Qt Company. For licensing terms
|
|
||||||
** and conditions see https://www.qt.io/terms-conditions. For further
|
|
||||||
** information use the contact form at https://www.qt.io/contact-us.
|
|
||||||
**
|
|
||||||
** GNU Free Documentation License Usage
|
|
||||||
** Alternatively, this file may be used under the terms of the GNU Free
|
|
||||||
** Documentation License version 1.3 as published by the Free Software
|
|
||||||
** Foundation and appearing in the file included in the packaging of
|
|
||||||
** this file. Please review the following information to ensure
|
|
||||||
** the GNU Free Documentation License version 1.3 requirements
|
|
||||||
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
|
|
||||||
** $QT_END_LICENSE$
|
|
||||||
**
|
|
||||||
****************************************************************************/
|
|
||||||
|
|
||||||
//! [description]
|
|
||||||
Creates compiled object files from Qt resource files using the
|
|
||||||
\l{Resource Compiler (rcc)}. Paths to the generated files are added to
|
|
||||||
\c{<VAR>}.
|
|
||||||
|
|
||||||
This is similar to \l qt5_add_resources / \l qt_add_resources, but directly
|
|
||||||
generates object files (\c .o, \c .obj) files instead of C++ source code.
|
|
||||||
This allows to embed bigger resources, where compiling to C++ sources and then
|
|
||||||
to binaries would be too time consuming or memory intensive.
|
|
||||||
|
|
||||||
\note This macro is only available if using \c{CMake} 3.9 or later.
|
|
||||||
//! [description]
|
|
||||||
|
|
||||||
//! [arguments]
|
|
||||||
You can set additional \c{OPTIONS} that should be added to the \c{rcc} calls.
|
|
||||||
You can find possible options in the \l{rcc}{rcc documentation}.
|
|
||||||
//! [arguments]
|
|
||||||
@ -1,39 +0,0 @@
|
|||||||
/****************************************************************************
|
|
||||||
**
|
|
||||||
** Copyright (C) 2020 The Qt Company Ltd.
|
|
||||||
** Contact: https://www.qt.io/licensing/
|
|
||||||
**
|
|
||||||
** This file is part of the documentation of the Qt Toolkit.
|
|
||||||
**
|
|
||||||
** $QT_BEGIN_LICENSE:FDL$
|
|
||||||
** Commercial License Usage
|
|
||||||
** Licensees holding valid commercial Qt licenses may use this file in
|
|
||||||
** accordance with the commercial license agreement provided with the
|
|
||||||
** Software or, alternatively, in accordance with the terms contained in
|
|
||||||
** a written agreement between you and The Qt Company. For licensing terms
|
|
||||||
** and conditions see https://www.qt.io/terms-conditions. For further
|
|
||||||
** information use the contact form at https://www.qt.io/contact-us.
|
|
||||||
**
|
|
||||||
** GNU Free Documentation License Usage
|
|
||||||
** Alternatively, this file may be used under the terms of the GNU Free
|
|
||||||
** Documentation License version 1.3 as published by the Free Software
|
|
||||||
** Foundation and appearing in the file included in the packaging of
|
|
||||||
** this file. Please review the following information to ensure
|
|
||||||
** the GNU Free Documentation License version 1.3 requirements
|
|
||||||
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
|
|
||||||
** $QT_END_LICENSE$
|
|
||||||
**
|
|
||||||
****************************************************************************/
|
|
||||||
|
|
||||||
//! [description]
|
|
||||||
Adds a custom \c target that compiles Qt resource files into a binary \c{.rcc}
|
|
||||||
file.
|
|
||||||
//! [description]
|
|
||||||
|
|
||||||
//! [arguments]
|
|
||||||
\c{DESTINATION} sets the path of the generated \c{.rcc} file. The default is
|
|
||||||
\c{${CMAKE_CURRENT_BINARY_DIR}/${target}.rcc}.
|
|
||||||
|
|
||||||
You can set additional \c{OPTIONS} that should be added to the \c{rcc} calls.
|
|
||||||
You can find possible options in the \l{rcc}{rcc documentation}.
|
|
||||||
//! [arguments]
|
|
||||||
@ -1,40 +0,0 @@
|
|||||||
/****************************************************************************
|
|
||||||
**
|
|
||||||
** Copyright (C) 2020 The Qt Company Ltd.
|
|
||||||
** Contact: https://www.qt.io/licensing/
|
|
||||||
**
|
|
||||||
** This file is part of the documentation of the Qt Toolkit.
|
|
||||||
**
|
|
||||||
** $QT_BEGIN_LICENSE:FDL$
|
|
||||||
** Commercial License Usage
|
|
||||||
** Licensees holding valid commercial Qt licenses may use this file in
|
|
||||||
** accordance with the commercial license agreement provided with the
|
|
||||||
** Software or, alternatively, in accordance with the terms contained in
|
|
||||||
** a written agreement between you and The Qt Company. For licensing terms
|
|
||||||
** and conditions see https://www.qt.io/terms-conditions. For further
|
|
||||||
** information use the contact form at https://www.qt.io/contact-us.
|
|
||||||
**
|
|
||||||
** GNU Free Documentation License Usage
|
|
||||||
** Alternatively, this file may be used under the terms of the GNU Free
|
|
||||||
** Documentation License version 1.3 as published by the Free Software
|
|
||||||
** Foundation and appearing in the file included in the packaging of
|
|
||||||
** this file. Please review the following information to ensure
|
|
||||||
** the GNU Free Documentation License version 1.3 requirements
|
|
||||||
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
|
|
||||||
** $QT_END_LICENSE$
|
|
||||||
**
|
|
||||||
****************************************************************************/
|
|
||||||
|
|
||||||
//! [description]
|
|
||||||
Creates source code from Qt resource files using the
|
|
||||||
\l{Resource Compiler (rcc)}. Paths to the generated source files are added to
|
|
||||||
\c{<VAR>}.
|
|
||||||
|
|
||||||
\note This is a low-level macro. See the \l{CMake AUTORCC Documentation} for a
|
|
||||||
more convenient way to let Qt resource files be processed with \c{rcc}.
|
|
||||||
//! [description]
|
|
||||||
|
|
||||||
//! [arguments]
|
|
||||||
You can set additional \c{OPTIONS} that should be added to the \c{rcc} calls.
|
|
||||||
You can find possible options in the \l{rcc}{rcc documentation}.
|
|
||||||
//! [arguments]
|
|
||||||
@ -1,42 +0,0 @@
|
|||||||
/****************************************************************************
|
|
||||||
**
|
|
||||||
** Copyright (C) 2020 The Qt Company Ltd.
|
|
||||||
** Contact: https://www.qt.io/licensing/
|
|
||||||
**
|
|
||||||
** This file is part of the documentation of the Qt Toolkit.
|
|
||||||
**
|
|
||||||
** $QT_BEGIN_LICENSE:FDL$
|
|
||||||
** Commercial License Usage
|
|
||||||
** Licensees holding valid commercial Qt licenses may use this file in
|
|
||||||
** accordance with the commercial license agreement provided with the
|
|
||||||
** Software or, alternatively, in accordance with the terms contained in
|
|
||||||
** a written agreement between you and The Qt Company. For licensing terms
|
|
||||||
** and conditions see https://www.qt.io/terms-conditions. For further
|
|
||||||
** information use the contact form at https://www.qt.io/contact-us.
|
|
||||||
**
|
|
||||||
** GNU Free Documentation License Usage
|
|
||||||
** Alternatively, this file may be used under the terms of the GNU Free
|
|
||||||
** Documentation License version 1.3 as published by the Free Software
|
|
||||||
** Foundation and appearing in the file included in the packaging of
|
|
||||||
** this file. Please review the following information to ensure
|
|
||||||
** the GNU Free Documentation License version 1.3 requirements
|
|
||||||
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
|
|
||||||
** $QT_END_LICENSE$
|
|
||||||
**
|
|
||||||
****************************************************************************/
|
|
||||||
|
|
||||||
//! [description]
|
|
||||||
Creates a rule to call the \l{moc}{Meta-Object Compiler (moc)} on \c src_file
|
|
||||||
and store the output in \c dest_file.
|
|
||||||
|
|
||||||
\note This is a low-level macro. See the \l{CMake AUTOMOC Documentation} for a
|
|
||||||
more convenient way to let source files be processed with \c{moc}.
|
|
||||||
\l qt5_wrap_cpp is also similar, but automatically generates a temporary file
|
|
||||||
path for you.
|
|
||||||
//! [description]
|
|
||||||
|
|
||||||
//! [arguments]
|
|
||||||
You can set an explicit \c{TARGET}. This will make sure that the target
|
|
||||||
properties \c{INCLUDE_DIRECTORIES} and \c{COMPILE_DEFINITIONS} are also used
|
|
||||||
when scanning the source files with \c{moc}.
|
|
||||||
//! [arguments]
|
|
||||||
@ -1,58 +0,0 @@
|
|||||||
/****************************************************************************
|
|
||||||
**
|
|
||||||
** Copyright (C) 2020 The Qt Company Ltd.
|
|
||||||
** Contact: https://www.qt.io/licensing/
|
|
||||||
**
|
|
||||||
** This file is part of the documentation of the Qt Toolkit.
|
|
||||||
**
|
|
||||||
** $QT_BEGIN_LICENSE:FDL$
|
|
||||||
** Commercial License Usage
|
|
||||||
** Licensees holding valid commercial Qt licenses may use this file in
|
|
||||||
** accordance with the commercial license agreement provided with the
|
|
||||||
** Software or, alternatively, in accordance with the terms contained in
|
|
||||||
** a written agreement between you and The Qt Company. For licensing terms
|
|
||||||
** and conditions see https://www.qt.io/terms-conditions. For further
|
|
||||||
** information use the contact form at https://www.qt.io/contact-us.
|
|
||||||
**
|
|
||||||
** GNU Free Documentation License Usage
|
|
||||||
** Alternatively, this file may be used under the terms of the GNU Free
|
|
||||||
** Documentation License version 1.3 as published by the Free Software
|
|
||||||
** Foundation and appearing in the file included in the packaging of
|
|
||||||
** this file. Please review the following information to ensure
|
|
||||||
** the GNU Free Documentation License version 1.3 requirements
|
|
||||||
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
|
|
||||||
** $QT_END_LICENSE$
|
|
||||||
**
|
|
||||||
****************************************************************************/
|
|
||||||
|
|
||||||
//! [description]
|
|
||||||
Specifies a custom set of plugins to import. The optional arguments:
|
|
||||||
\c INCLUDE, \c EXCLUDE, \c INCLUDE_BY_TYPE, and \c EXCLUDE_BY_TYPE,
|
|
||||||
can be used more than once.
|
|
||||||
|
|
||||||
This CMake command was introduced in Qt 5.14.
|
|
||||||
|
|
||||||
\list
|
|
||||||
\li \c INCLUDE -- can be used to specify a list of plugins to import.
|
|
||||||
\li \c EXCLUDE -- can be used to specify a list of plugins to exclude.
|
|
||||||
\li \c INCLUDE_BY_TYPE -- can be used to override the list of plugins to
|
|
||||||
import for a certain plugin type.
|
|
||||||
\li \c EXCLUDE_BY_TYPE -- can be used to specify a plugin type to exclude;
|
|
||||||
then no plugins of that type are imported.
|
|
||||||
\endlist
|
|
||||||
|
|
||||||
Qt provides plugin types such as \c imageformats, \c platforms,
|
|
||||||
and \c sqldrivers.
|
|
||||||
|
|
||||||
If the command isn't used the target automatically links against
|
|
||||||
a sane set of default plugins, for each Qt module that the target is linked
|
|
||||||
against. For more information, see
|
|
||||||
\l{CMake target_link_libraries Documentation}{target_link_libraries}.
|
|
||||||
|
|
||||||
Each plugin comes with a C++ stub file that automatically
|
|
||||||
initializes the plugin. Consequently, any target that links against a plugin
|
|
||||||
has this C++ file added to its \c SOURCES.
|
|
||||||
|
|
||||||
\note This command imports plugins from static Qt builds only.
|
|
||||||
On shared builds, it does nothing.
|
|
||||||
//! [description]
|
|
||||||
@ -1,49 +0,0 @@
|
|||||||
/****************************************************************************
|
|
||||||
**
|
|
||||||
** Copyright (C) 2020 The Qt Company Ltd.
|
|
||||||
** Contact: https://www.qt.io/licensing/
|
|
||||||
**
|
|
||||||
** This file is part of the documentation of the Qt Toolkit.
|
|
||||||
**
|
|
||||||
** $QT_BEGIN_LICENSE:FDL$
|
|
||||||
** Commercial License Usage
|
|
||||||
** Licensees holding valid commercial Qt licenses may use this file in
|
|
||||||
** accordance with the commercial license agreement provided with the
|
|
||||||
** Software or, alternatively, in accordance with the terms contained in
|
|
||||||
** a written agreement between you and The Qt Company. For licensing terms
|
|
||||||
** and conditions see https://www.qt.io/terms-conditions. For further
|
|
||||||
** information use the contact form at https://www.qt.io/contact-us.
|
|
||||||
**
|
|
||||||
** GNU Free Documentation License Usage
|
|
||||||
** Alternatively, this file may be used under the terms of the GNU Free
|
|
||||||
** Documentation License version 1.3 as published by the Free Software
|
|
||||||
** Foundation and appearing in the file included in the packaging of
|
|
||||||
** this file. Please review the following information to ensure
|
|
||||||
** the GNU Free Documentation License version 1.3 requirements
|
|
||||||
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
|
|
||||||
** $QT_END_LICENSE$
|
|
||||||
**
|
|
||||||
****************************************************************************/
|
|
||||||
|
|
||||||
//! [description]
|
|
||||||
Creates rules for calling the \l{moc}{Meta-Object Compiler (moc)} on the given
|
|
||||||
source files. For each input file, an output file is generated in the build
|
|
||||||
directory. The paths of the generated files are added to \c{<VAR>}.
|
|
||||||
|
|
||||||
\note This is a low-level macro. See the \l{CMake AUTOMOC Documentation} for a
|
|
||||||
more convenient way to let source files be processed with \c{moc}.
|
|
||||||
//! [description]
|
|
||||||
|
|
||||||
//! [arguments]
|
|
||||||
You can set an explicit \c{TARGET}. This will make sure that the target
|
|
||||||
properties \c{INCLUDE_DIRECTORIES} and \c{COMPILE_DEFINITIONS} are also used
|
|
||||||
when scanning the source files with \c{moc}.
|
|
||||||
|
|
||||||
You can set additional \c{OPTIONS} that should be added to the \c{moc} calls.
|
|
||||||
You can find possible options in the \l{moc}{moc documentation}.
|
|
||||||
|
|
||||||
\c{DEPENDS} allows you to add additional dependencies for recreation of the
|
|
||||||
generated files. This is useful when the sources have implicit dependencies,
|
|
||||||
like code for a Qt plugin that includes a \c{.json} file using the
|
|
||||||
Q_PLUGIN_METADATA() macro.
|
|
||||||
//! [arguments]
|
|
||||||
Loading…
x
Reference in New Issue
Block a user