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.29/policy/CMP0149.html