Nettoyer une build

  • Article

Quand vous nettoyez une build, tous les fichiers intermédiaires et de sortie sont supprimés ; seuls les fichiers projet et de composants sont conservés. De nouvelles instances des fichiers intermédiaires et de sortie peuvent alors être générées à partir des fichiers projet et de composants.

Créer un répertoire pour les éléments de sortie

Par défaut, le fichier .exe qui est créé quand vous compilez un projet est placé dans le même répertoire que les fichiers projet et les fichiers sources. En général, les éléments de sortie sont cependant créés dans un répertoire distinct.

Pour créer un répertoire pour les éléments de sortie

  1. Utilisez l’élément Property pour définir l’emplacement et le nom du répertoire. Par exemple, créez un répertoire nommé BuiltApp dans le répertoire qui contient les fichiers projet et les fichiers sources :

    <builtdir>BuiltApp</builtdir>

  2. Utilisez la tâche MakeDir pour créer le répertoire s’il n’existe pas. Par exemple :

    <MakeDir Directories = "$(builtdir)"
 Condition = "!Exists('$(builtdir)')" />

Supprimer les éléments de sortie

Avant de créer de nouvelles instances des fichiers intermédiaires et de sortie, vous pouvez si nécessaire effacer toutes les instances précédentes de ces fichiers. Utilisez la tâche RemoveDir pour supprimer d’un disque un répertoire, ainsi que tous les fichiers et répertoires qu’il contient.

Pour supprimer un répertoire et tous les fichiers contenus dans le répertoire

  • Utilisez la tâche RemoveDir pour supprimer le répertoire. Par exemple :

    <RemoveDir Directories="$(builtdir)" />

Exemple

L’exemple de projet de code suivant contient une nouvelle cible Clean, qui utilise la tâche RemoveDir pour supprimer un répertoire, ainsi que tous les fichiers et répertoires qu’il contient. De plus, dans cet exemple, la cible Compile crée un répertoire distinct pour les éléments de sortie qui sont supprimés quand la build est nettoyée.

Compile est défini comme cible par défaut et est donc utilisée automatiquement, sauf si vous spécifiez une ou plusieurs cibles différentes. Vous utilisez le commutateur de ligne de commande -target pour spécifier une autre cible. Par exemple :

msbuild <file name>.proj -target:Clean

Le commutateur -target peut être abrégé en -t et vous pouvez spécifier plusieurs cibles. Par exemple, pour utiliser la cible Clean, puis la cible Compile, tapez :

msbuild <file name>.proj -t:Clean;Compile

<Project DefaultTargets = "Compile"
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003" >

    <PropertyGroup>
        <!-- Set the application name as a property -->
        <name>HelloWorldCS</name>

        <!-- Set the output folder as a property -->
        <builtdir>BuiltApp</builtdir>
    </PropertyGroup>

    <ItemGroup>
        <!-- Specify the inputs by type and file name -->
        <CSFile Include = "consolehwcs1.cs"/>
    </ItemGroup>

    <Target Name = "Compile">
        <!-- Check whether an output folder exists and create
        one if necessary -->
        <MakeDir Directories = "$(builtdir)"
            Condition = "!Exists('$(builtdir)')" />

        <!-- Run the Visual C# compiler -->
        <CSC Sources = "@(CSFile)"
            OutputAssembly = "$(BuiltDir)\$(appname).exe">
            <Output TaskParameter = "OutputAssembly"
                ItemName = "EXEFile" />
        </CSC>

        <!-- Log the file name of the output file -->
        <Message Text="The output file is @(EXEFile)"/>
    </Target>

    <Target Name = "Clean">
        <RemoveDir Directories="$(builtdir)" />
    </Target>
</Project>

Contenu connexe