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.