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 из 4 компонентов, например, 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.