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.

1. Qu’est-ce que MSBuild ?

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.

2. Structure d’un fichier .csproj

Voici un exemple simple de fichier .csproj moderne :

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>

</Project>

3. Ajout de propriétés personnalisées

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>

4. Cibles personnalisées (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

5. Déclencher un Target à une étape du build

Pour exécuter une cible avant le build, utilisez BeforeTargets :

<Target Name="LogAvantBuild" BeforeTargets="Build">
  <Message Text="Préparation du build..." Importance="high" />
</Target>

6. Utilisation des ItemGroup

Les 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>

7. Exemple d’un build conditionnel

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>

8. Exécution de code C# en tâche personnalisée

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.

9. Exécution sans Visual Studio

MSBuild fonctionne aussi en ligne de commande avec le SDK .NET :

dotnet msbuild MonProjet.csproj

Utile pour les environnements CI/CD et multiplateformes.

10. Conclusion

✅ Maîtriser MSBuild permet de :

• Personnaliser votre pipeline de build
• Intégrer des étapes d’analyse statique, tests, packaging
• Créer des builds reproductibles
• Automatiser vos déploiements

Même si l’interface de Visual Studio cache ces détails, MSBuild reste le vrai moteur sous le capot.

📚 Pour aller plus loin

• 📘 Docs officielles MSBuild
• 🧠 Tâches personnalisées en C#