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() или cmake_minimum_required(). Если она не задана, CMake не выдаёт предупреждение и использует поведение OLD.