Imported targets

Each Qt module that is loaded defines a CMake library target. The target names start with Qt6::, followed by the module name. For example: Qt6::Core, Qt6::Gui. Pass the name of the library target to target_link_libraries to use the respective library.

Note: The targets are also available with a Qt:: prefix: Qt::Core, Qt::Gui, and so on. See also Qt 5 and Qt 6 compatibility.

Imported targets are created with the same configurations as when Qt was configured. That is:

  • If Qt was configured with the -debug switch, an imported target with the DEBUG configuration is created.
  • If Qt was configured with the -release switch, an imported target with the RELEASE configuration is created.
  • If Qt was configured with the -debug-and-release switch, then imported targets are created with both RELEASE and DEBUG configurations.

If your project has custom CMake build configurations, you have to map your custom configuration to either the debug or the release Qt configuration.

find_package(Qt6 REQUIRED COMPONENTS Core)

set(CMAKE_CXX_FLAGS_COVERAGE "${CMAKE_CXX_FLAGS_RELEASE} -fprofile-arcs -ftest-coverage")

# set up a mapping so that the Release configuration for the Qt imported target is
# used in the COVERAGE CMake configuration.
set_target_properties(Qt6::Core PROPERTIES MAP_IMPORTED_CONFIG_COVERAGE "RELEASE")

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.