CMP0149

Генераторы Visual Studio по умолчанию выбирают последнюю версию Windows SDK.

Генераторы Visual Studio выбирают версию Windows SDK, которую необходимо поместить в WindowsTargetPlatformVersion настройку в .vcxproj файлах. CMake устанавливает переменную CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION в выбранную версию SDK.

До CMake 3.27 версия SDK всегда выбиралась по значению переменной CMAKE_SYSTEM_VERSION. Пользователи или файлы инструментальной цепочки могли установить эту переменную на одну из точных версий Windows SDK, доступных на системе-хосте. Поскольку CMAKE_SYSTEM_VERSION по умолчанию устанавливается в CMAKE_HOST_SYSTEM_VERSION, и нет гарантии, что соответствующая версия Windows SDK доступна, CMake должен был использовать последнюю версию Windows SDK, если точного совпадения не было. Этот подход был проблематичен:

• Последняя версия Windows SDK могла или не могла быть выбрана в зависимости от того, соответствует ли версия Windows на хосте доступной версии SDK.
• Могла быть выбрана старая версия Windows SDK, которая не была обновлена для новых стандартов языка, таких как C11.

CMake 3.27 и выше предпочитает игнорировать точное значение CMAKE_SYSTEM_VERSION и по умолчанию выбирает последнюю доступную версию SDK. Точная версия SDK может быть явно указана с помощью поля version= в переменной CMAKE_GENERATOR_PLATFORM. См. Выбор платформы Visual Studio.

Этот параметр обеспечивает совместимость для проектов, файлов инструментальной цепочки и скриптов сборки, которые не были переведены с использования CMAKE_SYSTEM_VERSION для указания точной версии SDK.

Поведение OLD для этого параметра заключается в использовании точного значения CMAKE_SYSTEM_VERSION, если это возможно. Поведение NEW для этого параметра заключается в его игнорировании.

Этот параметр был введён в версии CMake 3.27. Используйте команду cmake_policy(), чтобы установить его в OLD или NEW явно. В отличие от многих параметров, CMake версии 3.28.6 не выводит предупреждение, когда этот параметр не установлен, и просто использует поведение OLD.