CMAKE_VS_USE_DEBUG_LIBRARIES

Укажите генераторам Visual Studio, какие конфигурации считаются отладочными. Это контролирует значение UseDebugLibraries в каждой конфигурации файла .vcxproj.

Настройка «Использовать библиотеки отладки» в проектах Visual Studio, несмотря на свое конкретное название, является общим индикатором, какие конфигурации считаются отладочными. В автономных проектах это может повлиять на стандартный выбор MSBuild библиотеки MSVC runtime, флагов оптимизации, проверок во время выполнения и аналогичных настроек. В проектах CMake эти настройки обычно генерируются явно на основе спецификации проекта, например, библиотека MSVC runtime контролируется CMAKE_MSVC_RUNTIME_LIBRARY. Однако индикатор UseDebugLibraries полезен для справки как для человека, так и для инструментов, а также может повлиять на поведение платформенно-специфических SDK.

Установите CMAKE_VS_USE_DEBUG_LIBRARIES в значение true или false, чтобы указать, является ли каждая конфигурация отладочной. Значение также может быть пустой строкой (""), в этом случае CMake не будет добавлять явно UseDebugLibraries, а MSBuild будет использовать своё значение по умолчанию false.

Используйте generator expressions для указания конфигураций. Например, код:

set(CMAKE_VS_USE_DEBUG_LIBRARIES "$<CONFIG:Debug,Custom>")

указывает, что все последующие целевые объекты рассматривают свои конфигурации «Debug» и «Custom» как отладочные, а другие конфигурации — как не отладочные.

Эта переменная используется для инициализации свойства VS_USE_DEBUG_LIBRARIES для всех целевых объектов по мере их создания. Также она передаётся командой try_compile() в её тестовый проект.

Если эта переменная не задана, то свойство VS_USE_DEBUG_LIBRARIES не будет автоматически установлено. Если это свойство не задано, CMake генерирует UseDebugLibraries с помощью эвристик для определения, какие конфигурации являются отладочными. См. политику CMP0162.