Présentation des configurations de buildUnderstanding Build Configurations

Vous pouvez enregistrer différentes configurations de propriétés de solution et de projet à utiliser dans différents types de builds.You can store different configurations of solution and project properties to use in different kinds of builds. Pour créer, sélectionner, modifier ou supprimer une configuration, vous pouvez utiliser le Gestionnaire de configurations.To create, select, modify, or delete a configuration, you can use the Configuration Manager. Pour l’ouvrir, dans la barre de menus, choisissez Générer, Gestionnaire de configurations, ou tapez simplement Configuration dans la zone Lancement rapide.To open it, on the menu bar, choose Build, Configuration Manager, or just type Configuration in the Quick Launch box. 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.You can also use the Solution Configurations list on the Standard toolbar to select a configuration or open the Configuration Manager.

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 au Gestionnaire de configurations, les paramètres de développement de Visual BasicVisual Basic peuvent être appliqués.If you can't find solution configuration settings on the toolbar and can't access the Configuration Manager, Visual BasicVisual Basic development settings may be applied. Pour plus d’informations, consultez Guide pratique pour gérer les configurations de build en appliquant les paramètres du développeur Visual Basic.For more information, see How to: Manage Configurations with Visual Basic Developer Settings Applied.

Par défaut, les configurations Debug et Release sont incluses dans les projets créés à l'aide des modèles Visual StudioVisual Studio.By default, Debug and Release configurations are included in projects that are created by using Visual StudioVisual Studio templates. 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.A Debug configuration supports the debugging of an app, and a Release configuration builds a version of the app that can be deployed. Pour plus d’informations, consultez Guide pratique pour définir des configurations Debug et Release.For more information, see How to: Set Debug and Release Configurations. Vous pouvez également créer des configurations de solution et des configurations de projet personnalisées.You can also create custom solution configurations and project configurations. Pour plus d’informations, consultez Guide pratique pour créer et modifier des configurations.For more information, see How to: Create and Edit Configurations.

Configurations de solutionsSolution Configurations

Une configuration de solution spécifie comment les projets de la solution doivent être générés et déployés.A solution configuration specifies how projects in the solution are to be built and deployed. 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.To modify a solution configuration or define a new one, in the Configuration Manager, under Active solution configuration, choose Edit or New.

Chaque entrée dans la zone Contextes des projets d’une configuration de solution représente un projet dans la solution.Each entry in the Project contexts box in a solution configuration represents a project in the 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é.For every combination of Active solution configuration and Active solution platform, you can set how each project is used. (Pour plus d’informations concernant les plateformes de solution, consultez Présentation des plateformes de génération.)(For more information about solution platforms, see Understanding Build Platforms.)

Note

Quand vous définissez une nouvelle configuration de solution et que vous cochez la case Créer des configurations de projet, Visual StudioVisual Studio attribue automatiquement la nouvelle configuration à tous les projets.When you define a new solution configuration and select the Create new project configurations check box, Visual StudioVisual Studio automatically assigns the new configuration to all of the projects. 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 StudioVisual Studio attribue automatiquement la nouvelle plateforme à tous les projets.Likewise, when you define a new solution platform and select the Create new project platforms check box, Visual StudioVisual Studio automatically assigns the new platform to all of the projects. En outre, si vous ajoutez un projet ciblant une nouvelle plateforme, Visual Studio ajoute cette plateforme à la liste des plateformes de solution et l'attribue à tous les projets.Also, if you add a project that targets a new platform, Visual Studio adds that platform to the list of solution platforms and assigns it to all of the projects.

Vous pouvez toujours modifier les paramètres de chaque projet.You can still modify the settings for each project.

La configuration de solution active fournit également le contexte à l'IDE.The active solution configuration also provides context to the 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.For example, if you're working on a project and the configuration specifies that it will be built for a mobile device, the Toolbox displays only items that can be used in a mobile device project.

Configurations de projetProject Configurations

La configuration et la plateforme ciblées par un projet sont utilisées ensemble pour spécifier les propriétés à utiliser lors de sa génération.The configuration and platform that a project targets are used together to specify the properties to use when it's built. Un projet peut avoir un ensemble différent de définitions de propriété pour chaque combinaison de configuration et de plateforme.A project can have a different set of property definitions for each combination of configuration and platform. Pour modifier les propriétés d'un projet, vous pouvez utiliser ses pages de propriétés.To modify the properties of a project, you can use its Property Pages. (Dans l’Explorateur de solutions, ouvrez le menu contextuel du projet, puis choisissez Propriétés.)(In Solution Explorer, open the shortcut menu for the project and then choose Properties.)

Pour chaque configuration de projet, vous pouvez définir des propriétés dépendantes de la configuration si nécessaire.For each project configuration, you can define configuration-dependent properties as needed. Les propriétés du projet servent à déterminer, par exemple, les éléments de projet à inclure dans une version particulière ainsi que les fichiers de sortie à créer, leur emplacement et leur niveau d'optimisation.For example, for a particular build, you can set which project items will be included, and what output files will be created, where they will be put, and how they will be optimized.

Les configurations de projet peuvent varier considérablement.Project configurations can differ considerably. Par exemple, les propriétés d'une configuration peuvent indiquer que son fichier de sortie est optimisé pour occuper le moins d'espace possible, tandis qu'une autre configuration peut indiquer que son fichier exécutable s'exécute à la vitesse maximale.For example, the properties of one configuration might specify that its output file be optimized to occupy the minimum space, while another configuration might specify that its executable runs at the maximum speed.

Les configurations de projet sont enregistrées par solution, et non par utilisateur, afin qu'elles puissent être partagées par une équipe.Project configurations are stored by solution—not by user—so that they can be shared by a team.

Bien que les dépendances d'un projet ne soient pas liées à la configuration, seuls les projets spécifiés dans la configuration de solution active seront générés.Although project dependencies are configuration-independent, only the projects that are specified in the active solution configuration will be built.

Comment Visual Studio assigne des configurations de projetHow Visual Studio Assigns Project Configurations

Lorsque vous définissez une nouvelle configuration de solution sans copier les paramètres d'une configuration existante, Visual Studio utilise les critères ci-après pour assigner des configurations de projet par défaut.When you define a new solution configuration and don't copy settings from an existing one, Visual Studio uses the following criteria to assign default project configurations. Les critères sont évalués dans l'ordre indiqué.The criteria are evaluated in the order shown.

  1. Si un projet a un nom de configuration (<nom de la configuration> <nom de la plateforme>) qui correspond exactement au nom de la nouvelle configuration de solution, cette configuration est attribuée.If a project has a configuration name (<configuration name> <platform name>) that exactly matches the name of the new solution configuration, that configuration is assigned. Les noms de configuration ne respectent pas la casse.Configuration names are not case-sensitive.

  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 assignée, même si l'autre partie du nom indique une plateforme différente.If the project has a configuration name in which the configuration-name part matches the new solution configuration, that configuration is assigned, whether the platform portion matches or not.

  3. Si aucun nom ne correspond en partie au nom de configuration, la première configuration répertoriée dans le projet est assignée.If there is still no match, the first configuration that's listed in the project is assigned.

Comment Visual Studio assigne des configurations de solutionHow Visual Studio Assigns Solution Configurations

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.When you create a project configuration (in the Configuration Manager, by choosing New on the drop-down menu in the Configuration column for that project) and select the Create new solution configurations check box, Visual Studio looks for a like-named solution configuration to build the project on each platform it supports. Dans certains cas, Visual Studio renomme des configurations de solution existantes ou en définit de nouvelles.In some cases, Visual Studio renames existing solution configurations or defines new ones.

Visual Studio utilise les critères ci-après pour assigner des configurations de solution.Visual Studio uses the following criteria to assign solution configurations.

  • 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.If a project configuration doesn't specify a platform or specifies just one platform, then a solution configuration whose name matches that of the new project configuration is either found or added. 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.The default name of this solution configuration does not include a platform name; it takes the form <project configuration name>.

  • Si un projet prend en charge plusieurs plateformes, une configuration de solution est trouvée ou ajoutée pour chaque plateforme prise en charge.If a project supports multiple platforms, a solution configuration is either found or added for each supported platform. 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.The name of each solution configuration includes both the project configuration name and the platform name, and has the form <project configuration name> <platform name>.

Voir aussiSee Also

Procédure pas à pas : génération d’une application Walkthrough: Building an Application
Compilation et génération Compiling and Building
Projets et solutions Solutions and Projects
Référence à la génération C/C++ C/C++ Building Reference
Commutateurs de la ligne de commande DevenvDevenv Command Line Switches