99546ef425
This adds a short example demonstrating how to set this property. Additionally, a paragraph is added to the target_link_libraries() and its debug/optimized keywords to mention that imported targets with IMPORTED_CONFIGURATIONS property may provide better alternative for linking.
35 lines
1.2 KiB
ReStructuredText
35 lines
1.2 KiB
ReStructuredText
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.
|