CMP0162ΒΆ
New in version 3.30.
Visual Studio Generators add UseDebugLibraries indicators by default.
The "Use Debug Libraries" setting in Visual Studio projects indicates what
configurations are considered debug configurations. In standalone projects,
this may affect MSBuild's default selection of MSVC runtime library,
optimization flags, runtime checks, and similar settings. CMake typically
generates all those settings explicitly based on the project's specification,
so CMake 3.29 and below do not write any UseDebugLibraries indicators to
.vcxproj files.
CMake 3.30 and above prefer to write UseDebugLibraries indicators because
they are useful for reference by both humans and tools, and may also affect
the behavior of platform-specific SDKs. The indicator for each configuration
of a target is determined as follows:
If the target compiles sources for a known MSVC runtime library (such as that specified by
MSVC_RUNTIME_LIBRARY), thenUseDebugLibrariesistruefor configurations that compile for a "Debug" runtime library, andfalsefor others.Otherwise, such as in targets created by
add_custom_target(),UseDebugLibrariesistruefor theDebugconfiguration, andfalsefor others.
This policy provides compatibility for projects that have not been updated to
expect the indicators. The policy setting is recorded by each target as it is
created and used to determine the default behavior for that target's
.vcxproj file.
The OLD behavior for this policy is to not generate UseDebugLibraries
indicators by default. The NEW behavior for this policy is to generate
UseDebugLibraries indicators by default.
If the CMAKE_VS_USE_DEBUG_LIBRARIES variable and/or
VS_USE_DEBUG_LIBRARIES target property is set, it explicitly
controls UseDebugLibraries generation regardless of this policy.
This policy was introduced in CMake version 3.30.
It may be set by cmake_policy() or cmake_minimum_required().
If it is not set, CMake does not warn, and uses OLD behavior.
Note
The OLD behavior of a policy is
deprecated by definition
and may be removed in a future version of CMake.