Задача ClangCompile
Примечание.
Эта задача доступна только при использовании системы сборки C++.
Создает программу-оболочку для компилятора Microsoft C++ (clang.exe).
Параметры
В следующей таблице приводятся параметры задачи ClangCompile.
| Параметр | Описание |
|---|---|
| AdditionalIncludeDirectories | Необязательный параметр типа string[]. Задает один или несколько каталогов для добавления в качестве пути включения; несколько значений разделяются точками с запятой. Используйте -I[path]. |
| AdditionalOptions | Необязательный параметр типа string. |
| BufferSecurityCheck | Необязательный параметр типа string. Проверка безопасности помогает обнаруживать переполнения буфера стека, что является обычной попыткой обхода защиты программы. Используйте fstack-protector. |
| BuildingInIde | Необязательный параметр типа bool. |
| CLanguageStandard | Необязательный параметр типа string. Определяет стандарт языка C. Используйте std=[value] со значением c89, c99, c11, gnu99 или gnu11. |
| ClangVersion | Необязательный параметр типа string. |
| CompileAs | Необязательный параметр типа string. Выбор языка компиляции C-файлов и CPP-файлов. Значение по умолчанию определяется на основе расширения C или .cpp. Используйте -x c, -x c++. |
| CppLanguageStandard | Необязательный параметр типа string. Определяет стандарт языка C++. Используйте std=[value] со значением c++98, c++11, c++1y, gnu++98, gnu++11 или gnu++1y. |
| DataLevelLinking | Необязательный параметр типа bool. Разрешает операциям оптимизации компоновщика удалять неиспользуемые данные, порождая каждый элемент данных в отдельном разделе. |
| DebugInformationFormat | Необязательный параметр типа string. Определяет тип отладочной информации, создаваемой компилятором. None — отладочная информация не создается для ускорения компиляции (используйте g0).FullDebug — создается отладочная информация DWARF2 (используйте g2 -gdwarf-2).LineNumber — создается только информация о номерах строк (используйте gline-tables-only). |
| EnableNeonCodegen | Необязательный параметр типа bool. Включает создание кода для оборудования NEON с плавающей запятой. Применимо только к архитектуре ARM. |
| ExceptionHandling | Необязательный параметр типа string. Задает модель обработки исключений, используемую компилятором. Disabled — отключение обработки исключений (используйте fno-exceptions).Enabled — включение обработки исключений (используйте fexceptions).UnwindTables — создает нужные статические данные, не затрагивая создаваемый код (используйте funwind-tables). |
| FloatABI | Необязательный параметр типа string. Параметр для выбора ABI с плавающей запятой. soft — выходные данные компилятора содержат вызовы библиотек для операций с плавающей запятой (используйте mfloat-abi=soft).softfp — код создается с помощью аппаратных инструкций с плавающей запятой, но с соблюдением соглашений о вызове программных операций с плавающей запятой (используйте mfloat-abi=softfp).hard — позволяет создавать инструкции с плавающей запятой и использовать соглашения о вызовах для конкретных FPU (используйте mfloat-abi=hard). |
| ForcedIncludeFiles | Необязательный параметр типа string[]. Один или несколько принудительно включаемых файлов. Используйте -include [name]. |
| FunctionLevelLinking | Необязательный параметр типа bool. Компилятор может упаковывать отдельные функции в форме упакованных функций (COMDAT). Требуется для изменения и продолжения работы. Используйте ffunction-sections. |
| GccToolChain | Необязательный параметр типа string. Путь к папке с цепочкой инструментов Gcc. |
| GNUMode | Необязательный параметр типа bool. |
| MSCompatibility | Необязательный параметр типа bool. Включение полной совместимости с Microsoft C++. |
| MSCompatibilityVersion | Необязательный параметр типа string. Значение с разделителями-точками, представляющее номер версии компилятора Майкрософт, который указывается в _MSC_VER (по умолчанию 0 — не задавать значение). |
| MSExtensions | Необязательный параметр типа bool. Прием некоторых нестандартных конструкций, поддерживаемых компилятором корпорации Майкрософт. |
| MSCompilerVersion | Необязательный параметр типа string. Номер версии компилятора Майкрософт, который указывается в _MSC_VER (по умолчанию 0 — не задавать значение). |
| MSVCErrorReport | Необязательный параметр типа bool. Отчеты об ошибках, которые Visual Studio может проанализировать для получения данных о файле и строке. |
| ObjectFileName | Необязательный параметр типа string. Задает имя, переопределяющее имя объектного файла по умолчанию; может быть именем файла или каталога. Используйте /Fo[name]. |
| OmitFramePointers | Необязательный параметр типа bool. Отменяет создание указателей на фреймы в стеке вызовов. |
| Оптимизация | Необязательный параметр типа string. Указывает уровень оптимизации для приложения. Custom — настраиваемая оптимизация. Disabled — отключить оптимизацию (используйте O0).MinSize — оптимизировать по размеру (используйте Os).MaxSpeed — оптимизировать по скорости (используйте O2).Full — дорогостоящие оптимизации (используйте O3). |
| PositionIndependentCode | Необязательный параметр типа bool. Создать позиционно-независимый код (PIC) для использования в общей библиотеке. |
| PrecompiledHeader | Необязательный параметр типа string. Разрешает создание или использование предварительно скомпилированного заголовка во время сборки. |
| PrecompiledHeaderFile | Необязательный параметр типа string. Задает имя, используемое для файла предкомпилированных заголовков. Во время сборки этот файл будет также добавлен в принудительно включенные файлы. |
| PrecompiledHeaderOutputFileDirectory | Необязательный параметр типа string. Указывает каталог для создаваемого предкомпилированного заголовка. Во время сборки этот каталог также добавляется в дополнительные каталоги включаемых файлов. |
| PrecompiledHeaderCompileAs | Необязательный параметр типа string. Выбор языка компиляции для файла предкомпилированных заголовков. Используйте -x c-header, -x c++-header. |
| PreprocessorDefinitions | Необязательный параметр типа string[]. Определяет символы предварительной обработки в исходном файле. Используйте -D. |
| RuntimeLibrary | Необязательный параметр типа string. Определяет библиотеку среды выполнения для компоновки. Используйте параметры MSVC /MT, /MTd, /MD, /MDd.MultiThreaded — предписывает приложению использовать многопоточную, статичную версию библиотеки среды выполнения. MultiThreadedDebug — определяет параметры _DEBUG и _MT. Этот параметр также предписывает компилятору размещение имени библиотеки LIBCMTD.lib в .obj-файле, чтобы компоновщик использовал LIBCMTD.lib для разрешения внешних символов. MultiThreadedDLL — предписывает приложению использовать специальную многопоточную версию библиотеки среды выполнения для конкретной библиотеки DLL. Определяет параметры _MT и _DLL и предписывает компилятору размещать имя библиотеки MSVCRT.lib в OBJ-файле. MultiThreadedDebugDLL — определяет параметры _DEBUG, _MT и_DLL и предписывает приложению использовать специальную многопоточную версию библиотеки среды выполнения для конкретной библиотеки DLL. Также предписывает компилятору размещение имени библиотеки MSVCRTD.lib в .obj-файле. |
| RuntimeTypeInfo | Необязательный параметр типа bool. Добавляет код для проверки типов объектов C++ во время выполнения (информация о типах времени выполнения). Используйте frtti, fno-rtti. |
| ShowIncludes | Необязательный параметр типа bool. Создает список включаемых файлов с выводом компилятора. Используйте -H. |
| Источники | Обязательный параметр ITaskItem[]. |
| StrictAliasing | Необязательный параметр типа bool. Использовать самые строгие правила присвоения псевдонима. Объект одного типа никогда не будет считаться находящимся по тому же адресу, что и объект другого типа. |
| Sysroot | Необязательный параметр типа string. Путь к корневому каталогу с заголовками и библиотеками. |
| TargetArch | Необязательный параметр типа string. Целевая архитектура. |
| ThumbMode | Необязательный параметр типа string. Создайте код, выполняемый для микроархитектуры Thumb. Применимо только к архитектуре ARM. Thumb — создание кода Thumb (используйте mthumb).ARM — создание кода Arm (используйте marm).Disabled — вариант недоступен для выбранной платформы. |
| TrackerLogDirectory | Необязательный параметр типа string. Каталог журнала отслеживания. |
| TreatWarningAsError | Необязательный параметр типа bool. Интерпретирует все предупреждения компилятора как ошибки. Для нового проекта мы рекомендуем использовать параметр /WX во всех компиляциях. Разрешение всех предупреждений снизит число трудновыявляемых дефектов кода. |
| UndefinePreprocessorDefinitions | Необязательный параметр типа string[]. Задает одну или несколько отмен определений препроцессора. Используйте -U [macro]. |
| UndefineAllPreprocessorDefinitions | Необязательный параметр типа bool. Отменить все объявленные ранее определения препроцессора. Используйте -undef. |
| UseMultiToolTask | Необязательный параметр типа bool. Многопроцессорная компиляция. |
| UseShortEnums | Необязательный параметр типа bool. Тип перечисления использует столько байт, сколько требует входной набор возможных значений. |
| Подробный | Необязательный параметр типа bool. Отображение команд для выполнения и использования подробного вывода. |
| WarningLevel | Необязательный параметр типа string. Выберите, как строго компилятор должен воспринимать ошибки в коде. Другие флаги следует добавлять непосредственно в раздел дополнительных параметров (используйте /w, /Weverything).TurnOffAllWarnings — отключает все предупреждения компилятора (используйте w).EnableAllWarnings — включает все предупреждения, в том числе отключенные по умолчанию (используйте Wall). |