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.