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.