Back to Cmake

DEBUG_CONFIGURATIONS

Help/prop_gbl/DEBUG_CONFIGURATIONS.rst

4.3.21.2 KB
Original Source

DEBUG_CONFIGURATIONS

This property specifies which :ref:Build Configurations are for debugging.

The value must be a :ref:semicolon-separated list <CMake Language Lists> of build configuration names. Currently this property is used only by the :command:target_link_libraries command. Additional uses may be defined in the future.

This property must be set at the top level of the project and before the first :command:target_link_libraries command invocation. If any entry in the list does not match a valid configuration for the project, the behavior is undefined.

By default, this property is not set.

Examples ^^^^^^^^

The following example adds a custom configuration to non-optimized debug configurations while preserving any existing ones. If the project uses the default Debug configuration, it should be included as well.

.. code-block:: cmake

set_property(GLOBAL APPEND PROPERTY DEBUG_CONFIGURATIONS Debug CustomBuild)

See Also ^^^^^^^^

  • The :prop_tgt:MAP_IMPORTED_CONFIG_<CONFIG> target property, which maps build configurations when linking to :ref:Imported Targets that have the :prop_tgt:IMPORTED_CONFIGURATIONS property set.