Utiliser l’API MSBuild

MSBuild fournit une surface d’API publique qui permet à votre programme d’effectuer des builds et d’inspecter des projets. Les versions récentes des API MSBuild se trouvent dans les packages NuGet suivants :

Nom du package	Description
Microsoft.Build	Contient l’assembly Microsoft.Build qui est utilisé pour créer, modifier et évaluer des projets MSBuild.
Microsoft.Build.Framework	Contient l’assembly d’infrastructure MSBuild commun utilisé par d’autres assemblys MSBuild.
Microsoft.Build.Runtime	Fournit une copie exécutable complète de MSBuild. Référencez ce package uniquement si votre application doit charger des projets ou exécuter des builds in-process sans nécessiter l’installation de MSBuild. L’évaluation des projets à l’aide de ce package nécessite l’agrégation de composants supplémentaires (comme les compilateurs) dans un répertoire d’application.
Microsoft.Build.Tasks.Core	Contient l’assembly Microsoft.Build.Tasks qui implémente les tâches couramment utilisées de MSBuild.
Microsoft.Build.Utilities.Core	Contient l’assembly Microsoft.Build.Utilities qui est utilisé pour implémenter des tâches MSBuild personnalisées.

En outre, NuGet héberge également un assembly hérité, Microsoft.Build.Engine, qui est déconseillé.

Il existe plusieurs versions différentes de l’API MSBuild, et pour les versions 15 et 16, il existe deux formes distinctes des assemblys dans les packages NuGet, l’une compilée avec .NET Framework, et l’autre compilée avec .NET Core, qui est un sous-ensemble de la surface de l’API .NET Framework. La version .NET Core de MSBuild est utilisée lorsque vous appelez la commande dotnet et lorsque vous utilisez MSBuild sur des systèmes Mac et Linux.

Vous trouverez la documentation de l’API MSBuild à l’aide du navigateur d’API .NET ou en parcourant les espaces de noms dans la liste suivante.

Espace de noms	S'applique à	Description
Microsoft.Build.Construction	Tous	Contient les types que le modèle objet MSBuild utilise pour construire des racines du projet avec des valeurs non-évaluées. Chaque racine du projet correspond à un fichier de projet ou de cibles.
Microsoft.Build.Definition	Tous	Contient la classe ProjectOptions, qui prend en charge la construction de projet.
Microsoft.Build.Evaluation	Tous	Contient les types que le modèle objet MSBuild utilise pour évaluer des projets. Chaque projet est associé à une ou plusieurs racines de projet.
Microsoft.Build.Evaluation.Context	Tous	Contient la classe EvaluationContext utilisée pour stocker l’état d’évaluation entre les appels.
Microsoft.Build.Exceptions	Tous	Contient les types d'exceptions susceptibles d'être levés pendant le processus de génération.
Microsoft.Build.Execution	Tous	Contient les types que le modèle objet MSBuild utilise pour générer des projets.
Microsoft.Build.Framework	Tous	Contient les types qui définissent comment les tâches et les enregistreurs d’événements interagissent avec le moteur MSBuild.
Microsoft.Build.Framework.Profiler	Tous	Contient les types qui prennent en charge le profilage des performances.
Microsoft.Build.Framework.XamlTypes	.NET Framework uniquement	Contient les classes utilisées pour représenter les types XAML analysés dans les fichiers, les règles et d’autres sources.
Microsoft.Build.Globbing	Tous	Contient les classes qui prennent en charge le traitement de caractères génériques.
Microsoft.Build.Globbing.Extensions	Tous	Contient les types qui prennent en charge les extensions pour le traitement des caractères génériques.
Microsoft.Build.Graph	Tous	Contient des types qui prennent en charge le commutateur MSBuild -graph.
Microsoft.Build.Logging	Tous	Contient les types utilisés pour l'enregistrement de la progression d'une build.
Microsoft.Build.ObjectModelRemoting	Tous	Contient les types qui prennent en charge la communication à distance dans MSBuild.
Microsoft.Build.Tasks	Tous	Contient l’implémentation de toutes les tâches livrées avec MSBuild.
Microsoft.Build.Tasks.Deployment.Bootstrapper	.NET Framework uniquement	Contient des classes utilisées en interne par MSBuild.
Microsoft.Build.Tasks.Deployment.ManifestUtilities	.NET Framework uniquement	Contient des classes utilisées par MSBuild.
Microsoft.Build.Tasks.Hosting	Tous	Contient des classes utilisées en interne par MSBuild.
Microsoft.Build.Tasks.Xaml	.NET Framework uniquement	Contient les classes liées aux tâches de génération XAML.
Microsoft.Build.Utilities	Tous	Contient des classes d’assistance que vous pouvez utiliser pour créer vos propres enregistreurs d’événements et tâches MSBuild.

Dans le tableau précédent, Tous dans la colonne S’applique à signifie que les types de l’espace de noms sont disponibles dans les versions .NET Framework et .NET Core de l’API MSBuild.