Partager via

Définir plusieurs projets de démarrage

  • Article

Visual Studio vous permet de spécifier la façon dont plusieurs projets sont exécutés quand vous appuyez sur F5 (Démarrer avec le débogage) ou Ctrl+F5 (Démarrer sans débogage) ou quand vous utilisez le bouton de barre d’outils pour lancer votre application. Vous pouvez ainsi démarrer plusieurs sites, applications ou services qui dépendent les uns des autres pour fonctionner correctement pendant une session de débogage ou simplement pour une exécution et des tests locaux.

Certains modèles de projet incluent plusieurs projets déjà configurés pour être démarrés lors du lancement. Par exemple, le type de projet React et ASP.NET Core inclut à la fois un projet JavaScript côté client et un projet ASP.NET Core côté serveur qui démarrent tous les deux lors du lancement.

Pour définir plusieurs projets de démarrage

  1. Dans l’Explorateur de solutions, sélectionnez la solution (nœud supérieur).

  2. Choisissez le menu de contexte (clic droit) du nœud de la solution, puis choisissez Propriétés. La boîte de dialogue Pages de propriétés de Solution s’affiche.

    Pages de propriétés de Solution

  3. Développez le nœud Propriétés communes et choisissez Projet de démarrage.

  4. Choisissez l’option Plusieurs projets de démarrage et définissez les actions appropriées.

Profils de lancement à plusieurs projets

Vous pouvez configurer et enregistrer des profils pour lancer des projets spécifiques au sein d’une solution comprenant plusieurs projets dans des états prédéfinis pour le débogage. Cela simplifie le processus de travail avec des solutions complexes, améliore l’efficacité du débogage et permet le partage facile des configurations entre les membres de l’équipe.

Activer le profil de lancement à plusieurs projets

Les profils de lancement à plusieurs projets sont disponibles dans Visual Studio 2022 17.11 et les versions ultérieures. Pour activer ou désactiver la fonctionnalité Profils de lancement à plusieurs projets, accédez à Outils > Options > Fonctionnalités en préversion et cochez la case pour Activer des profils de lancement multiples.

Capture d’écran montrant l’option permettant d’activer les profils de lancement à plusieurs projets dans la boîte de dialogue Outils Options.

Créer un profil de lancement à plusieurs projets

  1. Ouvrez votre solution Visual Studio qui contient plusieurs projets.

  2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur votre solution, puis sélectionnez Configurer les projets de démarrage....

    Vous pouvez également appuyer sur Ctrl+Q (Lancement rapide) et rechercher « Configurer les projets de démarrage » dans la recherche de fonctionnalités.

    Capture d’écran montrant la recherche pour configurer des projets de démarrage dans la recherche de fonctionnalités.

    La boîte de dialogue Pages de propriétés de Solution s’affiche.

  3. Dans les pages de propriétés de Solution, cliquez sur l’onglet Propriétés communes, puis sélectionnez Configurer les projets de démarrage.

  4. Dans la section Configurer les projets de démarrage, sélectionnez la case d’option Plusieurs projets de démarrage.

    Capture d’écran montrant la case d’option « Plusieurs projets de démarrage ».

    Sous la case d’option, une liste s'affiche avec tous les projets de votre solution, en indiquant s'ils sont définis pour être lancés ou non lorsque vous appuyez sur F5, et si chaque projet est démarré sous le débogueur ou sans débogage.

    Vous pouvez utiliser les flèches haut et bas pour contrôler l’ordre dans lequel les projets seront lancés.

  5. Définissez l’action de chaque projet sur Démarrer, Démarrer sans débogage ou Aucun, puis sélectionnez une cible de débogage en fonction de vos besoins.

    Capture d’écran montrant les options de démarrage d’un projet.

  6. Cochez la case Partager le profil si vous souhaitez partager le profil avec d’autres utilisateurs de Visual Studio en le cochant dans le fichier de configuration dans le dépôt de contrôle de code source. Les profils de lancement sont enregistrés dans un fichier JSON avec l’extension .slnLaunch dans le même répertoire que la solution. La case à cocher Partager le profil détermine si le profil est enregistré dans un fichier spécifique à l’utilisateur (non cochée) ou dans un fichier destiné au suivi du contrôle de code source, par exemple dans Git (cochée).

    Capture d’écran montrant la case à cocher « Partager le profil » dans la boîte de dialogue « Pages de propriétés de Solution ».

    Voici un exemple du profil dans le fichier .slnLaunch :

    [
   {
      "Name": "Feature Profile",
      "Projects": [
         {
         "Path": "src\\OrchardCore.Cms.Web\\OrchardCore.Cms.Web.csproj",
         "Action": "Start"
         },
         {
         "Path": "src\\OrchardCore\\OrchardCore.DisplayManagement\\OrchardCore.DisplayManagement.csproj",
         "Action": "Start"
         },
         {
         "Path": "src\\OrchardCore\\OrchardCore.Data\\OrchardCore.Data.csproj",
         "Action": "StartWithoutDebugging"
         },
         {
         "Path": "src\\OrchardCore\\OrchardCore.ContentManagement.Display\\OrchardCore.ContentManagement.Display.csproj",
         "Action": "Start"
         }
      ]
   }
]

  7. Une fois que vous avez configuré l’action de démarrage pour chaque projet, cliquez sur le bouton OK ou Appliquer pour enregistrer le profil. Le profil de lancement créé apparaît dans la liste déroulante de la barre d’outils, ce qui vous permet de sélectionner le profil que vous souhaitez déboguer.

    Capture d’écran montrant le profil de lancement dans la barre d’outils.

Avec Docker Compose

Quand vous utilisez Docker Compose pour lancer des projets conteneurisés sur un ordinateur local, vous utilisez une méthode différente (profils de lancement) pour démarrer plusieurs projets.

L’exemple suivant montre une solution WebFrontEndA avec trois projets : un site web front-end, un projet d’API web et un projet Docker Compose. La capture d’écran suivante montre comment démarrer deux des trois projets, l’un avec le débogage et l’autre sans :

Capture d’écran - Pages de propriétés de Solution.

Dans le cadre de cet exemple et dans tout autre scénario Docker Compose, vous choisissez docker-compose comme projet de démarrage unique, mais vous utiliserez ensuite une autre façon de spécifier les projets ou services à démarrer. Vous utiliserez un profil de lancement Docker Compose pour déterminer les services à démarrer et s’il faut ou non attacher le débogueur. Il existe une autre boîte de dialogue dans Visual Studio pour le configurer. Consultez Démarrer un sous-ensemble de services. La boîte de dialogue Pages de propriétés de Solution est utilisée uniquement pour les solutions non conteneurisées ou quand vous n’utilisez pas Docker Compose pour gérer le démarrage.

Contenu connexe