Présentation des configurations de buildUnderstanding build configurations

Vous pouvez stocker différentes configurations de propriétés de solution et de projet à utiliser dans différents genres de builds pendant le processus de développement.You can store different configurations of solution and project properties to use in different kinds of builds during the development process. Les projets créés par Visual Studio pour Mac à l’aide d’un modèle incluent généralement des configurations Debug et Release qui prennent en charge le débogage d’une application et le déploiement d’une application, respectivement.Projects created by Visual Studio for Mac using a template will typically include Debug and Release configurations that support debugging of an app and deployment of an app, respectively.

Si vous souhaitez créer des configurations personnalisées, consultez création et modification des configurations de build.If you'd like to create custom configurations, see Creating and editing build configurations.

Notes

Cette rubrique s’applique à Visual Studio pour Mac.This topic applies to Visual Studio for Mac. Pour Visual Studio sur Windows, consultez Présentation des configurations de build.For Visual Studio on Windows, see Understand build configurations.

Configurations de solutionSolution configurations

Les configurations de solution sont utilisées pour spécifier des configurations pour tous les projets d’une solution.Solution configurations are used to specify configurations for all projects in a solution. À l’aide de l’onglet mappages de configuration sous l’élément de configuration > de builds , vous pouvez affecter une configuration cible pour chaque élément de la solution ouverte.By using the Configuration Mappings tab under the Build > Configurations item, you can assign a target configuration for each item in the opened solution. Cela est illustré dans l’image suivante :This is demonstrated in the following image:

Options de mappage de configuration

Pour plus d’informations sur les configurations, reportez-vous à la vidéo Configuration Manager de James Montemagno.For more information about configurations, see the Configuration Manager video by James Montemagno.

Configurations de build d’un projetProject build configurations

Les projets ont tendance à avoir plusieurs configurations.Projects tend to have multiple 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 a project targets are used together to specify the properties to use when it's built. Le basculement entre les configurations permet des sorties différentes au moment de la génération.Switching between configurations allows for different outputs at build time. Par exemple, la sortie d’une configuration Debug comprend des symboles de débogage, ce qui permet au débogueur de résoudre les noms de fonction, les paramètres ou les variables à partir de la trace de la pile d’une application qui s’est bloquée.For example, a Debug configuration will output debugging symbols, allowing the debugger to resolve function names, parameters, or variables from a crashed application's stack trace. Bien que ces informations supplémentaires soient utiles lors du développement, elles entraînent l’augmentation de la taille d’un fichier, ce qui n’est pas idéal pour la distribution.While this additional information is useful during development, it leads to an inflated file size and isn't ideal for distribution.

Chaque plateforme a des configurations spécifiques pour sa génération.Each platform has specific configurations for its build. Les pages de configuration de build pour les projets sont accessibles en accédant à la section générer de la boîte de dialogue Options du projet .The build configuration pages for projects can be accessed by navigating to the Build section in the Project Options dialog. Pour ouvrir cette boîte de dialogue, cliquez avec le bouton droit sur le projet et sélectionnez options ou double-cliquez sur le projet dans l’Explorateur de solutions.Open up this dialog by right-clicking the project and selecting Options or by double-clicking the project in the solution explorer.

Configuration de série de testsRun configuration

Visual Studio pour Mac vous permet de définir une configuration de série de tests.Visual Studio for Mac allows you to set a run configuration. Les configurations d’exécution sont présentées dans une liste déroulante dans la barre d’outils, en regard du sélecteur de configuration de build, comme illustré ci-dessous :The run configurations are presented in a drop-down list in the toolbar, next to the build configuration selector as illustrated below:

Listé déroulante Configuration d’exécution

Une configuration d’exécution est un ensemble d’options d’exécution avec un nom et plusieurs configurations qui sont définies dans un projet à des fins différentes.A run configuration is a set of execution options with a name and several configurations that are defined in a project for different purposes. Les configurations d’exécution sont définies au niveau du projet, et une valeur par défaut est créée automatiquement pour chaque projet exécutable, bien qu’il soit possible d’en ajouter autant que nécessaire.Run configurations are defined at the project level, and a default will be created automatically for each executable project, although it's possible to add as many as needed. Certains types de projets génèrent automatiquement des configurations d’exécution supplémentaires.Certain project types automatically generate additional run configurations. Par exemple, les projets Watchos peuvent générer des aperçus et des configurations de notification.For example, watchOS projects may generate Glance and Notification configurations.

Les configurations peuvent être partagées avec d’autres développeurs (dans ce cas, les configurations sont stockées dans le fichier. csproj) ou conservées localement (dans ce cas, elles sont stockées dans un fichier. User).Configurations can be shared with other developers (in which case the configurations will be stored in the .csproj file) or kept locally (in which case they'll be stored in a .user file).

Configurations d’exécution AndroidAndroid run configurations

Les configurations d’exécution pour les projets Android autorisent la spécification d’une activité, d’un service ou d’un récepteur de diffusion particulier à lancer lors de l’exécution ou du débogage du projet.Run configurations for Android projects allow specification of a particular activity, service, or broadcast receiver to launch when running or debugging the project. Vous pouvez transmettre des données Intent supplémentaires et définir des indicateurs d’intention pour tester vos composants dans différentes conditions de lancement.You can pass intent extra data and set intent flags to test your components under different launch conditions.

Pour le débogage sur un appareil physique, vous devez ajouter Exported=true à l’attribut Activity pour les activités autres que MainLauncher ou définir des filtres intentionnels.Activities other than the MainLauncher will need to have Exported=true added to the Activity attribute for debugging on a physical device, or have Intent filters defined.

Exemples de données pouvant être incluses dans les configurations d’exécutionExamples of data that might be included in run configurations

La liste ci-dessous fournit quelques exemples de données qui peuvent être incluses dans les configurations d’exécution :The following list provides some examples of data that could be included in run configurations:

  • Projet .NET normalRegular .NET project
    • Application de démarrage alternativeAlternative startup app
    • Arguments du démarrageStart arguments
    • Répertoire de travailWorking directory
    • Variables d'environnementEnvironment variables
    • Options de runtime Mono (à utiliser uniquement lors de l’exécution sur Mono)Mono runtime options (to be used only when running on Mono)
  • Projet AndroidAndroid project
    • Point d’entrée (activité, service, récepteur)Entry point (activity, service, receiver)
    • Arguments et données intentionnelsIntent arguments and data
  • Projet iOSiOS project
    • Mode (Normal, Récupération en arrière-plan)Mode (Normal, Background Fetch)
  • Projet d’extension iOSiOS extension project
    • Application de démarrage : par défaut ou personnaliséeStartup app: default or custom
  • Projet WatchKitWatchKit project
    • Mode (Coup d’œil, Notification)Mode (Glance, Notification)
    • Charge utile de la notificationNotification payload

Voir aussiSee also