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>")

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

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

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