Changer le répertoire de sortie de build

Vous pouvez spécifier l’emplacement de sortie généré par votre projet en fonction de la configuration (pour Debug, Release ou les deux).

Changer le répertoire de sortie de build

Visual Studio 2022 propose différentes interfaces utilisateur du Concepteur de projet selon le type de votre projet. Les projets C# .NET Framework et tous les projets Visual Basic utilisent le Concepteur de projet .NET hérité, mais les projets C# .NET Core et .NET 5 (ou version ultérieure) utilisent le Concepteur de projet .NET actuel. Les projets C++ utilisent leur propre interface utilisateur de pages de propriétés. Les étapes décrites dans cette section dépendent du Concepteur de projet que vous utilisez.

Pour modifier le répertoire de sortie de build à l’aide du Concepteur de projet .NET actuel

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet, puis sélectionnez Propriétés.

2. Développez la section Build, puis défilez vers le bas la sous-section Sortie.

3. Recherchez la section Chemin de sortie de base pour C# et tapez le chemin vers lequel générer la sortie (absolu ou relatif par rapport au répertoire racine du projet) ou choisissez Parcourir pour accéder à ce dossier. Notez que le nom de la configuration est ajouté au chemin de sortie de base pour générer le chemin de sortie réel.

   

   Remarque

   Certains projets incluent le framework et le runtime dans le chemin de build par défaut. Pour modifier cela, cliquez avec le bouton droit sur le nœud du projet dans l’Explorateur de solutions, sélectionnez Modifier le fichier projet, puis ajoutez ce qui suit :

   <PropertyGroup>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
     <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
   </PropertyGroup>
   

Conseil

Si la sortie n’est pas générée à l’emplacement que vous avez spécifié, vérifiez que vous créez la configuration correspondante (par exemple, Debug ou Release) en la sélectionnant dans la barre de menus de Visual Studio.

Pour modifier le répertoire de sortie de build à l’aide du Concepteur de projet .NET hérité ou des pages de propriétés C++

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet, puis sélectionnez Propriétés.

2. Sélectionnez l’onglet approprié en fonction du type de votre projet :

   • Pour C#, sélectionnez l’onglet Générer.
   • Pour Visual Basic, sélectionnez l’onglet Compiler.
   • Pour C++ ou JavaScript, sélectionnez l’onglet Général.

3. Dans la liste déroulante de configuration située dans la partie supérieure, choisissez la configuration pour laquelle vous voulez changer l’emplacement du fichier de sortie (Debug, Release ou Toutes les configurations).

4. Recherchez l’entrée du chemin de sortie dans la page. Elle varie en fonction du type de votre projet :

   • Chemin de sortie pour les projets C# et JavaScript
   • Chemin de sortie de la génération pour les projets Visual Basic
   • Répertoire de sortie pour les projets Visual C++

   Tapez le chemin vers lequel générer la sortie (absolu ou relatif au répertoire racine du projet) ou choisissez Parcourir pour accéder à ce dossier.

   

   Remarque

   Certains projets incluent le framework et le runtime dans le chemin de build par défaut. Pour modifier cela, cliquez avec le bouton droit sur le nœud du projet dans l’Explorateur de solutions, sélectionnez Modifier le fichier projet, puis ajoutez ce qui suit :

   <PropertyGroup>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
     <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
   </PropertyGroup>
   

Créer un répertoire de sortie commun

Par défaut, Visual Studio génère chaque projet dans une solution dans son propre dossier au sein de la solution. Vous pouvez changer les chemins de sortie de build de vos projets pour imposer que toutes les sorties soient placées dans le même dossier.

Pour placer toutes les sorties de solution dans un répertoire commun

1. Cliquez sur un projet dans la solution.

2. Dans le menu Projet , cliquez sur Propriétés.

3. Dans chaque projet, en fonction de son type, sélectionnez Compiler ou Build, puis spécifiez un dossier à utiliser pour tous les projets de la solution sous Chemin de sortie ou Chemin de sortie de base.

4. Ouvrez le fichier projet du projet et ajoutez la déclaration de propriété suivante au premier groupe de propriétés.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <UseCommonOutputDirectory>true</UseCommonOutputDirectory>
   </PropertyGroup>
   

   La définition de UseCommonOutputDirectory sur true indique à Visual Studio et à son moteur de génération sous-jacent (MSBuild) que vous placez plusieurs sorties de projet dans le même dossier. Ainsi, MSBuild omet l’étape de copie qui se produit normalement quand des projets dépendent d’autres projets.

5. Répétez les étapes 1 à 4 pour tous les projets de la solution. Vous pouvez ignorer exceptionnellement certains projets qui ne doivent pas utiliser le répertoire de sortie commun.

Pour définir le répertoire de sortie intermédiaire pour un projet (projets .NET)

1. Ouvrez le fichier projet.

2. Ajoutez la déclaration de propriété suivante au premier groupe de propriétés.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <IntermediateOutputPath>path</IntermediateOutputPath>
   </PropertyGroup>
   

   Le chemin est relatif par rapport au fichier projet. Vous pouvez également utiliser un chemin absolu. Si vous souhaitez insérer le nom du projet dans le chemin, vous pouvez le référencer à l’aide des propriétés MSBuild $(MSBuildProjectName)et $(MSBuildProjectDirectory). Pour plus d’informations sur les propriétés que vous pouvez utiliser, consultez Propriétés réservées et connues de MSBuild.

3. Visual Studio crée toujours le dossier obj sous le dossier du projet quand vous effectuez une génération, mais il est vide. Vous pouvez le supprimer dans le cadre du processus de génération. Pour cela, vous pouvez, par exemple, ajouter un événement post-build pour exécuter la commande suivante :

   rd "$(ProjectDir)obj" /s /q
   

   Consultez Spécifier des événements de build personnalisés.

Contenu connexe

• Générer, page du Concepteur de projets (C#)
• Général, page de propriétés (projet)
• Compiler et générer