Skip to content

Commit b546b2b

Browse files
committed
Add multi project launch doc
1 parent a833b57 commit b546b2b

8 files changed

+47
-1
lines changed

docs/ide/how-to-set-multiple-startup-projects.md

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: 'Set multiple startup projects'
33
description: Discover the Visual Studio process that allows you to specify how more than one project is run when you start the debugger.
4-
ms.date: 11/01/2023
4+
ms.date: 10/21/2024
55
ms.topic: how-to
66
helpviewer_keywords:
77
- startup projects, setting multiple startup projects
@@ -28,6 +28,52 @@ Some project templates include multiple projects that are already configured to
2828

2929
4. Choose the **Multiple Startup Projects** option and set the appropriate actions.
3030

31+
## Multi-project launch profiles
32+
33+
You can set up and save profiles for launching specific projects within a multi-project solution in predefined states for debugging. This simplifies the process of working with complex solutions, improves debugging efficiency, and enables easy sharing of configurations among team members.
34+
35+
### Enable multi-project launch profile
36+
37+
Multi-project launch profiles are available in Visual Studio 2022 17.11 and later. To enable or disable the **Multi-project Launch Profiles** feature, go to **Tools > Options > Preview Features** and toggle the checkbox for **Enable Multi Launch Profiles**.
38+
39+
:::image type="content" source="media/launch-multiple-projects/tools-options-enable-multi-project-launch.png" alt-text="Screenshot showing the option to enable Multi-project Launch Profiles in the Tools > Options dialog." border="true":::
40+
41+
### Create a multi-project launch profile
42+
43+
1. Open your Visual Studio solution that contains multiple projects.
44+
1. In Solution Explorer, right-click on your solution, and select **Configure Startup Projects...**.
45+
46+
:::image type="content" source="media/launch-multiple-projects/configure-startup-projects-menu-item.jpg" alt-text="Screenshot showing the Configure startup projects menu item." border="true":::
47+
48+
You can also press **Ctrl**+**Q** (Quick Launch) and search for "Configure startup projects" in Feature Search.
49+
50+
:::image type="content" source="media/launch-multiple-projects/quick-launch-configure-startup-projects.png" alt-text="Screenshot showing searching for configure startup projects in Feature Search." border="true" :::
51+
52+
The **Solution Property Pages** dialog appears.
53+
54+
1. In the Solution Property Pages, click on the **Common Properties** tab, and select **Configure Startup Projects**.
55+
1. In the **Configure Startup Projects** section, choose the **Multiple startup projects** radio button.
56+
57+
:::image type="content" source="media/launch-multiple-projects/solution-property-pages.jpg" alt-text="Screenshot showing the Multiple startup projects radio button." border="true":::
58+
59+
Below the radio button, you'll see a list of all the projects in your solution, and whether they are set to be launched or not when you press **F5**, and whether each project is started under the debugger or without debugging.
60+
61+
You can use the up and down arrows to control the order in which projects will be launched.
62+
63+
1. Set the action for each project to either **Start**, **Start without debugging**, or **None**, and select a debug target depending on your requirements.
64+
65+
![Screenshot showing the options for starting a project.](media/launch-multiple-projects/launch-profiles-start-options.png)
66+
67+
1. Enable the **Share Profile** checkbox if you want to share the profile with other Visual Studio users by checking it into the `.config` file in the Source Control repo.
68+
Launch profiles are saved to a JSON file in the same directory as the solution. The **Share Profile** checkbox determines whether the profile is saved to a user-specific file (unchecked) or to a file intended for source control tracking, such as in Git (checked).
69+
70+
:::image type="content" source="media/launch-multiple-projects/share-profile.png" alt-text="{alt-text}" border="true":::
71+
72+
1. Once you've configured the startup action for each project, click the **OK** or **Apply** button to save the profile.
73+
The created launch profile appears in the toolbar dropdown list, allowing you to select the profile you want to debug.
74+
75+
:::image type="content" source="media/launch-multiple-projects/profile-in-toolbar.png" alt-text="Screenshot showing launch profile in toolbar.":::
76+
3177
## With Docker Compose
3278

3379
When you're using Docker Compose to launch containerized projects on a local machine, you use a different method (launch profiles) to start multiple projects.
130 KB
Loading
405 KB
Loading
138 KB
Loading
148 KB
Loading
295 KB
Loading
42.1 KB
Loading
68.7 KB
Loading

0 commit comments

Comments
 (0)