Présentation des configurations de build

Vous avez besoin de configurations de build lorsque vous devez générer vos projets avec différents paramètres. Par exemple, Déboguer et Release sont des configurations de build, et différentes options de compilation sont utilisées en conséquence lors de leur génération. Une configuration est active, comme indiqué dans la barre de commande en haut de l'environnement IDE.

Note

Cette rubrique s’applique à Visual Studio sur Windows. Pour Visual Studio pour Mac, consultez Créer des configurations dans Visual Studio pour Mac.

La configuration et la plate-forme déterminent l'emplacement où sont stockés les fichiers de sortie générés. Normalement, lorsque Visual Studio génère votre projet, la sortie est placée dans un sous-dossier du projet nommé avec la configuration active (par exemple, bin/Debug/x86), mais vous pouvez modifier cet emplacement.

Vous pouvez créer vos propres configurations de build au niveau de la solution et du projet. La configuration de la solution détermine quels projets sont inclus dans le build lorsque cette configuration est active. Seuls les projets spécifiés dans la configuration active de la solution seront générés. Si plusieurs plateformes cibles sont sélectionnées dans Configuration Manager, tous les projets qui s'appliquent à cette plateforme sont générés. La configuration du projet détermine les paramètres de génération et les options du compilateur utilisés lorsque vous générez le projet.

Pour créer, sélectionner, modifier ou supprimer une configuration, vous pouvez utiliser le Gestionnaire de configurations. Pour l’ouvrir, dans la barre de menus, choisissez Générer>Gestionnaire de configurations, ou tapez simplement Configuration dans la zone de recherche. Vous pouvez également utiliser la liste Configurations de solutions dans la barre d’outils Standard pour sélectionner une configuration ou ouvrir le Gestionnaire de configurations.

Note

Si les paramètres de configuration de solution ne figurent pas dans la barre d’outils et si vous ne pouvez pas accéder à Configuration Managervous utilisez peut-être les paramètres de développement Visual Basic. Pour plus d’informations, consultez Guide pratique pour gérer les configurations de build en appliquant les paramètres du développeur Visual Basic.

Par défaut, les configurations Debug et Release sont incluses dans les projets créés à l'aide des modèles Visual Studio. Une configuration Debug prend en charge le débogage d’une application, et une configuration Release génère une version de l’application qui peut être déployée. Pour plus d’informations, consultez Guide pratique pour définir des configurations Debug et Release. Vous pouvez également créer des configurations de solution et des configurations de projet personnalisées. Pour plus d’informations, consultez Guide pratique pour créer et modifier des configurations.

Configurations de solution

Une configuration de solution spécifie comment les projets de la solution doivent être générés et déployés. Pour modifier une configuration de solution ou en définir une nouvelle, dans le Gestionnaire de configurations, sous Configuration de la solution active, choisissez Modifier ou Nouveau.

Chaque entrée dans la zone Contextes des projets d’une configuration de solution représente un projet dans la solution. Pour chaque combinaison de Configuration de la solution active et de Plateforme de la solution active, vous pouvez définir la façon dont chaque projet est utilisé.

Quand vous définissez une nouvelle configuration de solution et que vous cochez la case Créer des configurations de projet, Visual Studio crée une configuration de projet dans tous les projets. De la même manière, quand vous définissez une nouvelle plateforme de solution et que vous cochez la case Créer des plateformes de projet, Visual Studio crée l’option de plateforme dans tous les projets. En outre, si vous ajoutez un projet ciblant une nouvelle plateforme, Visual Studio ajoute cette plateforme à la liste des plateformes de solution et la rend disponible en tant qu’option dans tous les projets. Vous pouvez modifier les paramètres de chaque projet, dans les cas où des plateformes ne sont pas nécessaires ou prises en charge par certains projets.

La configuration de solution active fournit également le contexte à l'IDE. Par exemple, si vous travaillez sur un projet et que la configuration indique qu’il doit être généré pour un appareil mobile, la Boîte à outils n’affiche que les éléments qui peuvent être utilisés dans un projet d’appareil mobile.

Configurations de projet

La configuration et la plateforme ciblées par un projet sont utilisées ensemble pour spécifier les paramètres de build et les options de compilateur à utiliser lors de sa génération. Un projet peut avoir des paramètres différents pour chaque combinaison de configuration et de plateforme. Pour modifier les propriétés d'un projet, ouvrez le menu contextuel du projet dans l'Explorateur de solutions, puis choisissez Propriétés. En haut de l'onglet Build du concepteur de projet, choisissez une configuration active pour modifier ses paramètres de build.

Comment Visual Studio associe les configurations de projet aux configurations de solutions

Lorsque vous définissez une nouvelle configuration de solution sans copier les paramètres d'une configuration existante, Visual Studio utilise les critères suivants pour associer les configurations de projet existantes à la nouvelle configuration de solution. Les critères sont évalués dans l'ordre indiqué.

1. Si un projet a un nom de configuration (<nom de la configuration><nom de la plateforme>) qui correspond au nom de la nouvelle configuration de solution, cette configuration est utilisée. Les noms de configuration ne respectent pas la casse.

2. Si le projet a un nom de configuration dont une partie indique un nom de configuration identique à la nouvelle configuration de solution, cette configuration est utilisée, même si l’autre partie du nom indique une plateforme différente.

3. Si aucun nom ne correspond en partie au nom de configuration, la première configuration répertoriée dans le projet est utilisée.

Comment Visual Studio associe des configurations de solution aux nouvelles configurations de projet

Quand vous créez une configuration de projet (dans le Gestionnaire de configurations, en choisissant Nouveau dans le menu déroulant de la colonne Configuration de ce projet) et que vous cochez la case Créer des configurations de solutions, Visual Studio recherche une configuration de solution du même nom pour générer le projet sur chaque plateforme prise en charge. Dans certains cas, Visual Studio renomme des configurations de solution existantes ou en définit de nouvelles.

Visual Studio utilise les critères suivants pour associer des configurations de solution à des configurations de projet :

• Si une configuration de projet ne spécifie pas de plateforme ou spécifie seulement une plateforme, une configuration de solution portant le même nom que la nouvelle configuration de projet est utilisée si elle existe déjà, ou ajoutée dans le cas contraire. Le nom par défaut de cette configuration de solution n’inclut pas le nom d’une plateforme ; il prend la forme <nom de la configuration de projet>.

• Si un projet prend en charge plusieurs plateformes, une configuration de solution est trouvée ou ajoutée pour chaque plateforme prise en charge. Le nom de chaque configuration de solution comprend le nom de la configuration de projet et celui de la plateforme, et se présente sous la forme <nom de la configuration de projet><nom de la plateforme>.

Dans quelle mesure les configurations affectent la build

Lorsque vous créez une solution à l'aide de la commande Générer>Générer la solution, Visual Studio ne crée que la configuration active. Tous les projets spécifiés dans cette configuration de solution sont générés, et la seule configuration de projet créée est celle spécifiée dans la configuration de solution active et la plateforme de solution active, affichée dans la barre d'outils de Visual Studio. Par exemple, Déboguer et x86. Les autres configurations et plateformes définies ne sont pas générées.

Si vous souhaitez générer plusieurs configurations et plateformes en une seule action, vous pouvez utiliser l'option Générer>Générer par lots de Visual Studio. Pour accéder à cette fonctionnalité, appuyez sur Ctrl+Q pour ouvrir la zone de recherche, puis entrez Batch build. La génération par lots n'est pas disponible pour tous les types de projets. Consultez Comment : créer plusieurs configurations simultanément.

Contenu connexe

• Procédure pas à pas : Générer une application
• Compiler et générer
• Solutions et projets
• Informations de référence sur les builds C/C++
• Configurer des projets pour des plateformes cibles
• Créer des configurations (Visual Studio pour Mac)