Spec-Zone.ru › CMake 3.31

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API