Fichiers MSBuild .targets

  • Article

MSBuild inclut plusieurs .targets fichiers qui contiennent des éléments, des propriétés, des cibles et des tâches pour les scénarios courants. Ces fichiers sont importés automatiquement dans la plupart des fichiers projet Visual Studio pour en simplifier la maintenance et la lisibilité.

Les projets de style SDK (projets avec quelque chose comme <Project Sdk="Microsoft.NET.Sdk">) importent .targets des fichiers différemment par rapport aux projets qui ne font pas référence à un SDK. Pour les projets de style SDK, vous ne voyez pas le fichier importé .targets dans le fichier projet, car ces importations sont gérées par le SDK que vous référencez. Toutefois, les projets de style SDK sont équivalents à des projets de style non SDK avec des importations standard avant et après le corps principal du fichier. Il est donc toujours exact de dire que les fichiers standard .targets sont importés dans ces projets.

Les cibles du Kit de développement logiciel (SDK) .NET sont installées avec le Kit de développement logiciel (SDK) .NET, par exemple, sur C:\Program Files\dotnet\sdk\{version}\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk Windows. Pour obtenir la liste complète des kits SDK et du .targets fichier qu’ils importent, consultez les kits SDK de projet .NET.

Les projets qui ne spécifient pas de KIT de développement logiciel (SDK) importent généralement explicitement un ou plusieurs .targets fichiers pour définir leur processus de génération. Par exemple, les projets C# créés par des versions antérieures de Visual Studio importent Microsoft.CSharp.targets, qui importe Microsoft.Common.targets. Le projet C# lui-même définit les éléments et les propriétés spécifiques à ce projet, mais les règles de génération standard d’un projet C# sont définies dans les fichiers importés .targets .

La $(MSBuildToolsPath) valeur spécifie le chemin d’accès de ces fichiers communs .targets . Pour les projets .NET, le chemin d’accès est généralement {Visual Studio installation folder}\MSBuild\Current\Bin\{architecture}.

Remarque

Pour plus d’informations sur la création de vos propres cibles, consultez l’article Targets (Cibles MSBuild). Pour plus d’informations sur l’utilisation de l’élément Import pour insérer un fichier projet dans un autre fichier projet, consultez les articles Import, élément (MSBuild) et Guide pratique pour utiliser la même cible dans plusieurs fichiers projet.

Fichiers courants .targets

Fichier .targets Description
Microsoft.Common.targets Définit les étapes du processus de génération standard pour les projets Visual Basic et C#.

Importé par les fichiers Microsoft.CSharp.targets et Microsoft.VisualBasic.targets, qui incluent l’instruction suivante : <Import Project="Microsoft.Common.targets" />
Microsoft.CSharp.targets Définit les étapes du processus de génération standard pour les projets Visual C#.

Importé par les fichiers projet Visual C# (.csproj).
Microsoft.VisualBasic.targets Définit les étapes du processus de génération standard pour les projets Visual Basic.

Importé par les fichiers projet Visual Basic (.vbproj).

Si vous ouvrez et affichez des fichiers, vous voyez qu’ils sont plutôt des wrappers minces autour d’autres .targets fichiers, généralement Microsoft.{language}.CurrentVersion.targets, ou pour les scénarios de ciblage croisé, Microsoft.{language}.CrossTargeting.targets.

Directory.Build.targets

Directory.Build.targets est un fichier défini par l’utilisateur qui fournit des personnalisations aux projets situés dans un répertoire. Ce fichier est automatiquement importé depuis Microsoft.Common.targets, sauf si la propriété ImportDirectoryBuildTargets a la valeur false. Pour plus d’informations, consultez Personnaliser votre build.

Voir aussi