Créer et modifier des configurations
Vous pouvez créer plusieurs configurations de build pour une solution, en plus des configurations intégrées Débogage et Mise en production. Par exemple, vous pouvez créer une configuration Test pour les builds de test internes, et vous pouvez configurer différents types de builds que vous pouvez distribuer à différents clients.
Créer des configurations de build
Vous pouvez utiliser la boîte de dialogue Configuration Manager pour sélectionner ou modifier des configurations de build existantes ou en créer de nouvelles.
Pour ouvrir la boîte de dialogue Configuration Manager, dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud de la solution pour ouvrir le menu contextuel de la solution, puis choisissez Configuration Manager.
Vous pouvez également ouvrir le Gestionnaire de configuration en cliquant sur la liste déroulante de la barre d’outils Visual Studio qui vous permet de choisir la configuration actuelle (par exemple, Déboguer ou Version Finale).
Il existe deux niveaux de configuration, la configuration de la solution et la configuration du projet. La configuration de la solution est ce que vous choisissez lorsque vous changez de configurations actives à l’aide de la barre d’outils dans Visual Studio. La configuration du projet est la configuration spécifique de chaque projet.
Dans la boîte de dialogue Configuration Manager, vous pouvez utiliser la liste déroulante configuration de solution active pour sélectionner une configuration de build à l’échelle de la solution, modifier une configuration existante ou créer une nouvelle configuration. Vous pouvez utiliser la plateforme de solution active liste déroulante pour sélectionner la plateforme cible, modifier une plateforme existante ou ajouter une plateforme. Si vous ajoutez une plateforme de solution, elle doit être prise en charge par au moins l’un des projets.
Le volet contextes de projet répertorie les projets dans la solution. Pour chaque projet, vous pouvez sélectionner une configuration et une plateforme spécifiques au projet, modifier des configurations existantes ou créer une nouvelle configuration ou ajouter une nouvelle plateforme à partir d’une liste de plateformes prises en charge par Visual Studio. Vous pouvez également cocher des cases qui indiquent si chaque projet est inclus lorsque vous utilisez la configuration à l’échelle de la solution pour générer ou déployer la solution.
Avertissement
Visual Studio n’applique aucune exigence que les plateformes de projet que vous choisissez dans cette boîte de dialogue correspondent à la plateforme de solution. Par exemple, il n’y a rien qui vous empêche de définir toutes les plateformes de projet sur x86
lorsque la plateforme de solution active est x64
. Veillez donc à éviter toute confusion et à choisir des plateformes de projet qui correspondent à la plateforme de solution chaque fois que possible.
Définir des propriétés basées sur des configurations
Pour définir des propriétés basées sur des configurations, dans Explorateur de solutions, ouvrez le menu contextuel d’un projet, puis choisissez Propriétés.
La plupart des propriétés du projet ne dépendent pas de la configuration ou de la plateforme, mais certaines sont. Pour une configuration Release, vous pouvez spécifier que le code est optimisé lorsque la solution est générée et pour une configuration débogage, vous pouvez spécifier que le symbole de compilation conditionnelle DEBUG
est défini. Vous pouvez également choisir les avertissements que vous souhaitez supprimer, ou élever vers des erreurs, différemment en fonction de la configuration ou de la plateforme, ainsi que contrôler certains paramètres qui affectent certaines options du compilateur, dépassement arithmétique, l’alignement des fichierset l’option de compilateur /deterministic
.
Dans les pages de propriétés du projet, les pages qui ont des paramètres qui dépendent de la configuration et de la plateforme ont des zones de liste déroulante qui vous permettent de choisir la configuration et la plateforme auxquelles les valeurs actuelles des paramètres s’appliquent.
La plupart des propriétés du projet ne dépendent pas de la configuration ou de la plateforme, mais certaines sont. Pour une configuration Release, vous pouvez spécifier que le code est optimisé lorsque la solution est générée et pour une configuration débogage, vous pouvez spécifier que le symbole de compilation conditionnelle DEBUG
est défini. Vous pouvez également choisir les avertissements que vous souhaitez supprimer, ou élever vers des erreurs, différemment en fonction de la configuration ou de la plateforme, ainsi que contrôler certains paramètres qui affectent certaines options du compilateur, dépassement arithmétique, l’alignement des fichierset l’option de compilateur /deterministic
.
Les propriétés que vous pouvez définir différemment en fonction de la configuration et de la plateforme ont une icône d’engrenage en regard de celles-ci sur la page des paramètres du projet. Si vous cliquez sur l’icône d’engrenage, un menu s’affiche pour vous donner des options pour avoir les mêmes valeurs ou différentes en fonction de la configuration, de la plateforme ou des deux.
Pour plus d’informations sur les paramètres de page de propriétés, consultez Gérer les propriétés de projet et de solution.
Créer une configuration de projet
Vous créez une configuration de projet lorsque vous souhaitez ajouter un nouveau type de build. Par exemple, au lieu de Debug et Release, vous pouvez créer les configurations Développement, Testet Production.
Ouvrez la boîte de dialogue Configuration Manager.
Sélectionnez un projet dans la colonne Projet.
Dans la liste déroulante Configuration de ce projet, choisissez Nouveau.
La boîte de dialogue nouvelle configuration de projet s’ouvre.
Dans la zone Nom, entrez un nom pour la nouvelle configuration.
Pour utiliser les paramètres de propriété d'une configuration de projet existante, dans la liste déroulante Copier les paramètres de, choisissez une configuration. Vous pouvez personnaliser les paramètres ultérieurement dans les pages de propriétés du projet.
Pour créer une configuration à l’échelle de la solution en même temps, cochez la case Créer une configuration de solution.
Renommer une configuration de projet
Ouvrez la boîte de dialogue Configuration Manager.
Dans la colonne Project, sélectionnez le projet dont vous souhaitez renommer la configuration du projet.
Dans la liste déroulante Configuration pour ce projet, choisissez Modifier.
La boîte de dialogue Modifier les configurations de projet s’ouvre.
Sélectionnez le nom de configuration du projet que vous souhaitez modifier.
Sélectionnez Renommer, puis entrez un nouveau nom.
Créer et modifier des configurations de build à l’échelle de la solution
Pour créer une configuration de build à l’échelle de la solution
Ouvrez la boîte de dialogue Configuration Manager.
Dans la liste déroulante Configuration de la solution active, choisissez Nouveau.
La boîte de dialogue Nouvelle configuration de solution s’ouvre.
Dans la zone de texte Nom, entrez un nom pour la nouvelle configuration.
Pour utiliser les paramètres d’une configuration de solution existante, dans la liste déroulante Copier les paramètres de, choisissez une configuration.
Si vous souhaitez créer des configurations de projet simultanément, activez la case à cocher Créer de nouvelles configurations de projet.
Pour renommer une configuration de build à l’échelle de la solution
Ouvrez la boîte de dialogue Configuration Manager.
Dans la liste déroulante Configuration de la solution active, choisissez Modifier.
La boîte de dialogue Modifier les configurations de solution s’ouvre.
Sélectionnez le nom de configuration de la solution que vous souhaitez modifier.
Sélectionnez Renommer, puis entrez un nouveau nom.
Pour modifier une configuration de build à l’échelle de la solution
Ouvrez la boîte de dialogue Configuration Manager.
Dans la liste déroulante configuration de solution active, sélectionnez la configuration souhaitée.
Dans le volet Contextes des projets, pour chaque projet, sélectionnez la Configuration et la Plateforme de votre choix, puis choisissez entre Générer ou Déployer.