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.