CMAKE_GENERATOR_PLATFORM

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

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

Значение этой переменной не должно изменяться кодом проекта. Файл toolchain, указанный переменной 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>

Указывает точную 4-компонентную версию 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.