CMAKE_VS_USE_DEBUG_LIBRARIES

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

Настройка «Использовать отладочные библиотеки» в проектах Visual Studio, несмотря на свое конкретное название, является общим индикатором того, какие конфигурации считаются отладочными. В автономных проектах это может повлиять на выбор MSBuild по умолчанию для библиотеки времени выполнения MSVC, флагов оптимизации, проверок времени выполнения и аналогичных настроек. В проектах CMake эти настройки обычно генерируются явно на основе спецификаций проекта, например, библиотека времени выполнения MSVC управляется 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>")

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

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

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