MSBuild в командной строке — C++

Как правило, для установки свойств проекта и вызова системы MSBuild рекомендуется использовать Visual Studio. Однако вы можете использовать инструмент MSBuild напрямую из командной строки. Процесс сборки управляется сведениями, указанными в файле проекта (с расширением VCXPROJ). Этот файл можно создавать и редактировать. Файл проекта устанавливает параметры сборки в зависимости от этапов, условий и событий сборки. Кроме того, вы можете указывать аргументы командной строки (параметры) — сколько потребуется.

msbuild.exe [ файл_проекта ] [ параметры ]

С помощью параметров командной строки /target (или /t) и /property (или /p) можно переопределять конкретные свойства и целевые объекты, заданные в файле проекта.

Важная функция файла проекта является указание целевой, который является конкретной операцией, применяемой для проекта и входов и выходов, которые требуются для выполнения этой операции. Файл проекта можно указать один или несколько целевых объектов, включая целевой объект по умолчанию.

Каждый целевой объект состоит из последовательности из одной или нескольких задачи. Каждая задача представляется классом .NET Framework, содержащим одну исполняемую команду. Например CL-задача содержит cl.exe команды.

A параметр задачи свойство класса задачи, обычно представляет параметр командной строки исполняемой команды. Например FavorSizeOrSpeed параметр CL Задача соответствует /Os и /Ot Параметры компилятора.

Дополнительные параметры задачи поддерживают инфраструктуру MSBuild. Например Sources параметр задачи указывает набор задач, которые могут быть использованы другими задачами. Дополнительные сведения о задачах MSBuild см. в разделе Справочные сведения о задачах.

Для большинства задач требуются входные и выходные данные, такие как имена файлов, пути и строки, числовые или логические параметры. Например часто к входным данным — имя исходного CPP-файла для компиляции. Важный входной параметр — это строка, указывающая конфигурацию сборки и платформу, например "Отладка|Win32". Входные и выходные данные задаются один или несколько определяемых пользователем XML Item элементов, содержащихся в ItemGroup элемент.

Файл проекта также может указывать определяемые пользователем свойства и ItemDefinitionGroupэлементы. Свойства и элементы формируют пары имя/значение, которые можно использовать в качестве переменных при построении. Компонент имени пары определяет макрос, а компонент значения объявляет значение макроса. Макрос свойств осуществляется с помощью $(имя) нотации и макрос элемента осуществляется с помощью %(имя) нотации.

Другие элементы XML в файле проекта можно тестировать макросы и затем условно значение любого макроса или контролировать выполнение построения. Имена макросов и строковые литералы можно сцепить для создания конструкций, таких как путь и имя файла. В командной строке /property Задает или переопределяет свойства проекта. Элементы нельзя ссылаться в командной строке.

Система MSBuild может условно выполнить целевой объект до или после другого целевого объекта. Кроме того эта система может построить целевой объект на основании ли целевой объект использует файлы новее, чем выдаваемые им файлы.

Дополнительные сведения о MSBuild см. в следующих статьях.

• MSBuild — обзор основных понятий MSBuild.

• Справочник по MSBuild — справочные сведения о системе MSBuild.

• Справочник по схеме файла проекта — список XML-элементов схемы MSBuild, а также их атрибутов и родительских и дочерних элементов. Обратите внимание, особенно ItemGroup, PropertyGroup, целевой, и задачи элементы.

• Справочник по командной строке — описание аргументов и параметров командной строки, которые можно использовать при работе с msbuild.exe.

• Справочник по задачам — описание задач MSBuild. Особенно обратите внимание на эти задачи, относящиеся к Visual C++: задача BscMake, задача CL, задача CPPClean, ЗАДАЧА LIB, задача link, MIDL Task, MT Task, RC Task, SetEnv Task, VCMessage Task

В этом разделе

Термин	Определение
Пошаговое руководство. Создание проекта C++ с помощью MSBuild	Демонстрируется создание проекта Visual Studio C++ с помощью MSBuild.
Практическое руководство. Использование событий сборки в проектах MSBuild	Демонстрируется, как следует указывать действие, выполняемое на определенном этапе сборки: до запуска сборки, перед началом этапа компоновки или после завершения сборки.
Практическое руководство. Добавление пользовательского шага сборки в проекты MSBuild	Демонстрируется добавление пользовательского этапа в последовательность сборки.
Практическое руководство. Добавление пользовательских средств сборки в проекты MSBuild	Демонстрируется, как можно связать инструмент сборки с определенным файлом.
Практическое руководство. Интеграция пользовательских средств в свойства проекта	Демонстрируется добавление параметров для пользовательского инструмента в свойства проекта.
Практическое руководство. Изменение требуемой версии .NET Framework и набора инструментов платформы	Демонстрируется компиляция проекта для нескольких платформ или наборов инструментов.

См. также

Использование набора инструментов MSVC из командной строки