CMAKE_GENERATOR_TOOLSET

Набор инструментов системной сборки, предоставленный пользователем.

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

Значение этой переменной не должно изменяться кодом проекта. Файл цепочки инструментов, указанный переменной CMAKE_TOOLCHAIN_FILE, может инициализировать CMAKE_GENERATOR_TOOLSET. После того, как дерево сборки было инициализировано с определённым значением для этой переменной, изменение значения приведёт к неопределённому поведению.

Поддержка указания набора инструментов реализована только для определённых генераторов:

• Генераторы Visual Studio для VS 2010 и выше
• Генератор Xcode для Xcode 3.0 и выше
• Генератор Green Hills MULTI

См. документацию системы сборки для списка разрешённых имён наборов инструментов.

Выбор набора инструментов Visual Studio

Генераторы Visual Studio поддерживают указание набора инструментов в одном из следующих форматов:

• toolset
• toolset[,key=value]*
• key=value[,key=value]*

toolset указывает имя набора инструментов. Выбранное имя набора инструментов предоставляется в переменной CMAKE_VS_PLATFORM_TOOLSET.

key=value пары представляют собой список опций через запятую для указания деталей выбора набора инструментов, специфичных для генератора. Поддерживаемые пары:

cuda=<version>|<path>

Указывает версию CUDA Toolkit или путь к автономному каталогу CUDA Toolkit. Поддерживается VS 2010 и выше. Версия может использоваться только с глобально установленной интеграцией CUDA Toolkit в VS. См. переменные CMAKE_VS_PLATFORM_TOOLSET_CUDA и CMAKE_VS_PLATFORM_TOOLSET_CUDA_CUSTOM_DIR.

host=<arch>

Указывает архитектуру инструментария хоста как x64 или x86. Поддерживается VS 2013 и выше. См. переменную CMAKE_VS_PLATFORM_TOOLSET_HOST_ARCHITECTURE.

version=<version>

Указывает версию набора инструментов для использования. Поддерживается VS 2017 и выше при условии установки указанного набора инструментов. См. переменную CMAKE_VS_PLATFORM_TOOLSET_VERSION.

VCTargetsPath=<path>

Указывает альтернативное VCTargetsPath значение для файлов проектов Visual Studio. Это позволяет использовать конфигурационные файлы расширения платформы VS (.props и .targets) не установленные с VS.