Задачи MSBuild, относящиеся к C++

  • Статья

Задачи содержат код, который выполняется в процессе сборки. После установки C++ доступны следующие задачи, помимо тех, которые устанавливаются вместе с MSBuild. Дополнительные сведения см. в обзоре MSBuild (C++).

Помимо общих для всех задач параметров, у каждой задачи есть следующие параметры.

Параметр Описание
Condition Необязательный параметр String.

Выражение Boolean, на основании которого механизм MSBuild определяет, будет ли выполняться эта задача. Сведения о поддерживаемых в MSBuild условиях см. в статье об условиях.
ContinueOnError Необязательный параметр. Может содержать одно из следующих значений:

- WarnAndContinue или true. При сбое одной задачи продолжается выполнение сборки и всех последующих задач в элементе Target, а все ошибки из задачи рассматриваются как предупреждения.
- ErrorAndContinue. При сбое задачи последующие задачи в элементе Target и сборке продолжают выполняться, а все ошибки из задачи рассматриваются как ошибки.
- ErrorAndStop или false (значение по умолчанию). При сбое задачи отменяется выполнение сборки и последующих задач в элементе Target, и фиксируется сбой для выполнения элемента Target и всей сборки.

Версии платформы .NET Framework, предшествовавшие 4.5, поддерживали только значения true и false.

Дополнительные сведения см. в руководстве по игнорированию ошибок в задачах.
Обращение Description
Задача BscMake Заключает в оболочку средство "Программа управления сведениями о просмотре Майкрософт" (bscmake.exe).
Задача CL Использует оболочку компилятора C++ (cl.exe).
Задача CPPClean Удаляет временные файлы, которые MSBuild создает при сборке проекта C++.
Задача ClangCompile Использует оболочку компилятора C++ (clang.exe).
Задача CustomBuild Использует оболочку компилятора C++ (cmd.exe).
Задача FXC Позволяет применять компиляторы шейдеров HLSL в процессе сборки.
GetOutOfDateItems Считывает старые журналы отслеживания, записывает новые журналы отслеживания и возвращает набор неактуальных элементов (задача вспомогательного приложения).
GetOutputFileName Извлекает имя выходного файла для cl и других средств, которые позволяют указывать только выходной каталог или полное имя файла (задача вспомогательного приложения).
Задача LIB Заключает в оболочку 32-разрядный диспетчер библиотек Майкрософт (lib.exe).
Задача Link Использует оболочку компоновщика C++ (link.exe).
Задача MIDL Является оболочкой для компилятора с языка MIDL (midl.exe).
Задача MT Является оболочкой для инструмента манифеста Майкрософт (mt.exe).
Задача MultiToolTask Нет описания.
Задача ParallelCustomBuild Выполняет параллельные экземпляры задачи CustomBuild.
Задача RC Является оболочкой для средства компиляции ресурсов Microsoft Windows (rc.exe).
Задача SetEnv Задает или удаляет значение указанной переменной среды.
Базовый класс TrackedVCToolTask Наследует от класса VCToolTask.
Задача VCMessage Заносит в журнал предупреждения и сообщения об ошибках, возникшие при сборке. (Невозможно расширить. Только для внутреннего использования.)
Базовый класс VCToolTask Наследует от класса ToolTask.
Задача XDCMake Является оболочкой для средства XML-документации (xdcmake.exe), которая помещает в XML-файл файлы комментариев (XDC-файлы) для файла XML.
Задача XSD Создает оболочку для инструмента определения схемы XML (xsd.exe), который создает файлы схемы или класса из источника. См. примечание ниже.
Справочные сведения о MSBuild Описывает элементы системы MSBuild.
Задачи Описывает задачи, представляющие собой блоки кода, которые можно объединять для выполнения сборки.
Написание задач Создание задачи.

Примечание.

Начиная с версии Visual Studio 2017 поддержка проектов C++ для xsd.exe отмечена как нерекомендуемая. Вы можете продолжать использовать API Microsoft.VisualC.CppCodeProvider, вручную добавив CppCodeProvider.dll в глобальный кэш сборок.