CMP0162 — CMake 4.4.20260621-gcc70e9e-dirty Documentation

# CMP0162

Added 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`), then `UseDebugLibraries` is `true` for configurations that compile for a "Debug" runtime library, and `false` for others.

- Otherwise, such as in targets created by `add_custom_target()`, `UseDebugLibraries` is `true` for the `Debug` configuration, and `false` for 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.