CMP0149
Новое в версии 3.27.
Генераторы 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.
Примечание
Эта политика должна быть установлена до первого вызова команды project() или enable_language() в верхней части проекта. Именно тогда Генераторы Visual Studio выбирают Windows SDK.
Поведение OLD для этой политики заключается в использовании точного значения CMAKE_SYSTEM_VERSION, если это возможно. Поведение NEW для этой политики заключается в его игнорировании.
Эта политика была введена в CMake версии 3.27. Она может быть установлена с помощью cmake_policy() или cmake_minimum_required(). Если она не установлена, CMake не выводит предупреждение и использует поведение OLD.
Примечание
Поведение OLD политики — deprecated by definition, и может быть удалено в будущих версиях CMake.
© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.30/policy/CMP0149.html