| title | Using MSBuild | |||
|---|---|---|---|---|
| description | MSBuild supplies an extensible XML format for creating project files that fully describe project items to be built, build tasks, and build configurations. | |||
| ms.date | 11/04/2016 | |||
| ms.topic | concept-article | |||
| helpviewer_keywords |
|
|||
| author | tinaschrepfer | |||
| ms.author | tinali | |||
| ms.subservice | extensibility-integration |
MSBuild supplies a well-defined, extensible XML format for creating project files that fully describe project items to be built, build tasks, and build configurations.
MSBuild project files, for example, Visual C# .csproj and Visual Basic .vbproj files, contain data that is used at build time, but also can contain data that is used at design time. Build-time data is stored using MSBuild primitives, including Item Element (MSBuild) and Property Element (MSBuild). Design-time data, which is data specific to the project type and any related project subtypes, is stored in free-form XML reserved for it.
MSBuild does not have native support for configuration objects, but does provide conditional attributes for specifying configuration-specific data. For example:
<OutputDir Condition="'$(Configuration)'=="release'">Bin\MyReleaseConfig</OutputDir>For more information on conditional attributes, see Conditional Constructs.
MSBuild interfaces and APIs are subject to change in future versions of Visual Studio. Therefore, it is prudent to use the managed package framework (MPF) classes because they provide shielding from changes.
The Managed Package Framework for Projects (MPFProj) provides helper classes for creating and managing new project system. You can find the source code and compilation instructions at MPF for Projects - Visual Studio 2013.
The project-specific MPF classes are as follows:
| Class | Implementation |
|---|---|
Microsoft.VisualStudio.Package.ProjectNode |
xref:Microsoft.VisualStudio.Shell.Interop.IVsProject3 xref:Microsoft.VisualStudio.Shell.Interop.IVsCfgProvider2 xref:Microsoft.VisualStudio.Shell.Interop.IPersistFileFormat xref:Microsoft.VisualStudio.Shell.Interop.IVsSolutionEvents |
Microsoft.VisualStudio.Package.ProjectFactory |
xref:Microsoft.VisualStudio.Shell.Interop.IVsProjectFactory |
Microsoft.VisualStudio.Package.HierarchyNode |
xref:Microsoft.VisualStudio.Shell.Interop.IVsHierarchy |
Microsoft.VisualStudio.Package.ProjectConfig |
xref:Microsoft.VisualStudio.Shell.Interop.IVsCfg xref:Microsoft.VisualStudio.Shell.Interop.IVsProjectCfg xref:Microsoft.VisualStudio.Shell.Interop.IVsBuildableProjectCfg xref:Microsoft.VisualStudio.Shell.Interop.IVsDebuggableProjectCfg |
Microsoft.VisualStudio.Package.SettingsPage |
xref:Microsoft.VisualStudio.OLE.Interop.IPropertyPageSite |
Microsoft.VisualStudio.Package.ProjectElement class is a wrapper for MSBuild items.
Single file generators are accessible at design-time only, but MSBuild tasks can be used at design-time and build-time. For maximum flexibility, therefore, use MSBuild tasks to transform and generate code. For more information, see Custom Tools.