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 считает свои конфигурации «Отладка» и «Пользовательская» отладочными, а остальные — нет.

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