CMAKE_GENERATOR_PLATFORM

Спецификация целевой платформы, зависящая от генератора и заданная пользователем.

Некоторые генераторы CMake поддерживают указание имени целевой платформы для передачи в нативную систему сборки, чтобы выбрать цепочку инструментов компилятора. Если пользователь указывает имя платформы (например, с помощью параметра cmake -A или переменной среды CMAKE_GENERATOR_PLATFORM), это значение становится доступным в данной переменной.

Код проекта не должен изменять значение этой переменной. Файл цепочки инструментов, указанный переменной CMAKE_TOOLCHAIN_FILE, может инициализировать CMAKE_GENERATOR_PLATFORM. После инициализации дерева сборки с определённым значением этой переменной изменение значения приводит к неопределённому поведению.

Спецификация платформы поддерживается только некоторыми генераторами:

• Для генераторов Visual Studio с VS 2005 и более поздними версиями указывает целевую архитектуру.
• Для Green Hills MULTI указывает целевую архитектуру.

Допустимые имена платформ см. в документации нативной системы сборки.

Выбор платформы Visual Studio

Генераторы Visual Studio поддерживают спецификацию платформы в одной из следующих форм:

• platform
• platform[,key=value]*
• key=value[,key=value]*

platform указывает целевую платформу (целевую архитектуру VS), например x64, ARM64 или Win32. Выбранное имя платформы сохраняется в переменной CMAKE_VS_PLATFORM_NAME.

Пары key=value образуют разделённый запятыми список параметров, задающих специфические для генератора детали выбора платформы. Поддерживаются следующие пары:

version=<version>

Добавлено в версии 3.27.

Указывает версию Windows SDK, которую следует использовать. Поддерживается в VS 2015 и более поздних версиях при нацеливании на Windows или Windows Store. CMake присвоит переменной CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION выбранную версию SDK.

Значением <version> может быть:

10.0

Указывает, что можно использовать любую версию SDK 10.0, и позволяет Visual Studio выбрать её. Поддерживается в VS 2019 и более поздних версиях.

10.0.<build>.<increment>

Указывает точную версию SDK из четырёх компонентов, например 10.0.19041.0. Указанная версия SDK должна быть установлена. Она не может превышать значение CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM, если эта переменная задана.

8.1

Указывает версию SDK 8.1. Она всегда поддерживается в VS 2015. В VS 2017 и более поздних версиях SDK 8.1 должен быть установлен.

Если поле version не указано, CMake выбирает версию, как описано в документации переменной CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION.