Command Palette
Search for a command to run...
Comments
Join the discussionNo comments yet. Be the first to comment.
Search for a command to run...
No comments yet. Be the first to comment.
MSBuild est souvent perçu comme une boîte noire dans les projets .NET. Pourtant, le comprendre permet d'automatiser, personnaliser et optimiser vos builds. Voici un tour d'horizon structuré, avec des exemples pratiques.
MSBuild (Microsoft Build Engine) est l’outil utilisé par .NET et Visual Studio pour compiler, packager, tester et déployer vos projets. Il lit les fichiers .csproj ou .vbproj, qui sont en réalité des fichiers XML définissant les étapes du build.
.csprojVoici un exemple simple de fichier .csproj moderne :
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net8.0</TargetFramework>
</PropertyGroup>
</Project>
Vous pouvez définir vos propres propriétés dans le fichier .csproj :
<PropertyGroup>
<MyCustomProperty>HelloWorld</MyCustomProperty>
</PropertyGroup>
Ensuite, vous pouvez utiliser cette propriété dans un Target personnalisé comme suit :
<Target Name="AfficherMessage">
<Message Text="Valeur : $(MyCustomProperty)" Importance="high" />
</Target>
Target)Un Target représente une action ou un groupe d’actions que MSBuild peut exécuter.
<Target Name="AfficherMessage">
<Message Text="Build en cours..." Importance="high" />
</Target>
Exécution depuis la ligne de commande :
dotnet msbuild -target:AfficherMessage
Target à une étape du buildPour exécuter une cible avant le build, utilisez BeforeTargets :
<Target Name="LogAvantBuild" BeforeTargets="Build">
<Message Text="Préparation du build..." Importance="high" />
</Target>
ItemGroupLes ItemGroup servent à gérer des collections de fichiers ou d’éléments.
<ItemGroup>
<FichiersTexte Include="docs\*.txt" />
</ItemGroup>
Puis plus loin :
<Target Name="ListerFichiers">
<Message Text="Fichier : %(FichiersTexte.Identity)" />
</Target>
Avec l’attribut Condition, vous pouvez conditionner l’exécution :
<PropertyGroup>
<DoAction>true</DoAction>
</PropertyGroup>
<Target Name="Conditionnel" Condition="'$(DoAction)' == 'true'">
<Message Text="Action activée !" />
</Target>
MSBuild permet d’écrire ses propres tâches en C# :
using Microsoft.Build.Framework;
using Microsoft.Build.Utilities;
public class HelloTask : Task
{
public override bool Execute()
{
Log.LogMessage("Salut depuis C#!");
return true;
}
}
Ensuite, référence cette tâche compilée dans ton projet via une DLL MSBuild.
MSBuild fonctionne aussi en ligne de commande avec le SDK .NET :
dotnet msbuild MonProjet.csproj
Utile pour les environnements CI/CD et multiplateformes.
✅ Maîtriser MSBuild permet de :
Même si l’interface de Visual Studio cache ces détails, MSBuild reste le vrai moteur sous le capot.