VS_USE_DEBUG_LIBRARIES

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

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

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

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

add_executable(foo foo.c)
set_property(TARGET foo PROPERTY
  VS_USE_DEBUG_LIBRARIES "$<CONFIG:Debug,Custom>")

указывает, что целевой foo считает свои конфигурации «Debug» и «Custom» отладочными, а остальные — нет.

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