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>

Указывает точную 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.