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.