Skip to content

Commit e02678f

Browse files
gregg-miskellygregg-miskelly
authored
Debugger: Update configuration snippets and 'hiddenWhen' (#6456)
This PR makes a few tweaks to package.json to hopefully further improve the experience configuring projects to launch -- 1. This adds a launch.json configuration snippet that uses the `dotnet` type to aid folks in using `dotnet` debugger type in polygot workspaces 2. Update the various launch.json configuration snippets so that: A. The new 'Launch C# Project' snippet stands out more B. Localization is enabled C. They are better grouped (ex: remote debugging ones are together) D. They have better descriptions 4. This hides the `dotnet` configuration provider if you try and bring up an action that will show you available debuggers when DevKit is not available, as it will do nothing if selected 5. This hides the `clr` configuration provider in all cases, as it will do nothing if selected
1 parent 1c109e8 commit e02678f

File tree

2 files changed

+73
-16
lines changed

2 files changed

+73
-16
lines changed

‎package.json

Lines changed: 28 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3283,8 +3283,8 @@
32833283
},
32843284
"configurationSnippets": [
32853285
{
3286-
"label": ".NET: Launch .NET Core Console App",
3287-
"description": "Launch a .NET Core Console App with a debugger.",
3286+
"label": "%debuggers.coreclr.configurationSnippets.label.console-local%",
3287+
"description": "%debuggers.coreclr.configurationSnippets.description.console-local%",
32883288
"body": {
32893289
"name": ".NET Core Launch (console)",
32903290
"type": "coreclr",
@@ -3298,17 +3298,17 @@
32983298
}
32993299
},
33003300
{
3301-
"label": ".NET: Attach to local .NET Core Console App",
3302-
"description": "Attach a debugger to a .NET Core Console App.",
3301+
"label": "%debuggers.coreclr.configurationSnippets.label.attach-local%",
3302+
"description": "%debuggers.coreclr.configurationSnippets.description.attach%",
33033303
"body": {
33043304
"name": ".NET Core Attach",
33053305
"type": "coreclr",
33063306
"request": "attach"
33073307
}
33083308
},
33093309
{
3310-
"label": ".NET: Launch a local .NET Core Web App",
3311-
"description": "Launch a .NET Core Web App with both a browser and a debugger.",
3310+
"label": "%debuggers.coreclr.configurationSnippets.label.web-local%",
3311+
"description": "%debuggers.coreclr.configurationSnippets.description.web-local%",
33123312
"body": {
33133313
"name": ".NET Core Launch (web)",
33143314
"type": "coreclr",
@@ -3331,8 +3331,8 @@
33313331
}
33323332
},
33333333
{
3334-
"label": ".NET: Launch a remote .NET Core Console App",
3335-
"description": "Launch a .NET Core Console App on a remote machine.",
3334+
"label": "%debuggers.coreclr.configurationSnippets.label.console-remote%",
3335+
"description": "%debuggers.coreclr.configurationSnippets.description.remote%",
33363336
"body": {
33373337
"name": ".NET Core Launch (console)",
33383338
"type": "coreclr",
@@ -3352,8 +3352,8 @@
33523352
}
33533353
},
33543354
{
3355-
"label": ".NET: Attach to remote .NET Core Console App",
3356-
"description": "Attach a debugger to a .NET Core Console App on a remote machine.",
3355+
"label": "%debuggers.coreclr.configurationSnippets.label.attach-remote%",
3356+
"description": "%debuggers.coreclr.configurationSnippets.description.remote%",
33573357
"body": {
33583358
"name": ".NET Core Attach",
33593359
"type": "coreclr",
@@ -3367,8 +3367,8 @@
33673367
}
33683368
},
33693369
{
3370-
"label": ".NET: Launch and Debug Hosted Blazor WebAssembly App",
3371-
"description": "Launches a Hosted Blazor WebAssembly App with a debugger",
3370+
"label": "%debuggers.coreclr.configurationSnippets.label.blazor-hosted%",
3371+
"description": "%debuggers.coreclr.configurationSnippets.description.blazor-hosted%",
33723372
"body": {
33733373
"name": "Launch and Debug Hosted Blazor WebAssembly App",
33743374
"type": "blazorwasm",
@@ -3379,8 +3379,8 @@
33793379
}
33803380
},
33813381
{
3382-
"label": ".NET: Launch and Debug Standalone Blazor WebAssembly App",
3383-
"description": "Launches Standalone Blazor WebAssembly App with a debugger",
3382+
"label": "%debuggers.coreclr.configurationSnippets.label.blazor-standalone%",
3383+
"description": "%debuggers.coreclr.configurationSnippets.description.blazor-standalone%",
33843384
"body": {
33853385
"name": "Launch and Debug Standalone Blazor WebAssembly App",
33863386
"type": "blazorwasm",
@@ -3393,7 +3393,7 @@
33933393
{
33943394
"type": "clr",
33953395
"when": "workspacePlatform == windows",
3396-
"hiddenWhen": "dotnet.debug.serviceBrokerAvailable",
3396+
"hiddenWhen": "true",
33973397
"label": ".NET Framework 4.x",
33983398
"languages": [
33993399
"csharp",
@@ -4766,6 +4766,7 @@
47664766
{
47674767
"type": "dotnet",
47684768
"label": "C#",
4769+
"hiddenWhen": "!dotnet.debug.serviceBrokerAvailable",
47694770
"languages": [
47704771
"csharp",
47714772
"razor",
@@ -4792,7 +4793,18 @@
47924793
}
47934794
}
47944795
},
4795-
"configurationSnippets": []
4796+
"configurationSnippets": [
4797+
{
4798+
"label": "%debuggers.dotnet.configurationSnippets.label%",
4799+
"description": "%debuggers.dotnet.configurationSnippets.description%",
4800+
"body": {
4801+
"name": "C#: ${1:<project-name>} Debug",
4802+
"type": "dotnet",
4803+
"request": "launch",
4804+
"projectPath": "^\"\\${workspaceFolder}/${2:<relative-path-to-project-folder>}${1:<project-name>}.csproj\""
4805+
}
4806+
}
4807+
]
47964808
}
47974809
],
47984810
"semanticTokenTypes": [

‎package.nls.json

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,53 @@
7575
"configuration.razor.trace.off": "Does not log messages from the Razor extension",
7676
"configuration.razor.trace.messages": "Logs only some messages from the Razor extension",
7777
"configuration.razor.trace.verbose": "Logs all messages from the Razor extension",
78+
"debuggers.coreclr.configurationSnippets.label.console-local": ".NET: Launch Executable file (Console)",
79+
"debuggers.coreclr.configurationSnippets.label.web-local": ".NET: Launch Executable file (Web)",
80+
"debuggers.coreclr.configurationSnippets.label.attach-local": ".NET: Attach to a .NET process",
81+
"debuggers.coreclr.configurationSnippets.label.console-remote": ".NET: Remote debugging - Launch Executable file (Console)",
82+
"debuggers.coreclr.configurationSnippets.label.attach-remote": ".NET: Remote debugging - Attach to a .NET process",
83+
"debuggers.coreclr.configurationSnippets.label.blazor-hosted": ".NET: Web Assembly - Launch hosted Blazor project",
84+
"debuggers.coreclr.configurationSnippets.label.blazor-standalone": ".NET: Web Assembly - Launch standalone Blazor project",
85+
"debuggers.coreclr.configurationSnippets.description.console-local": {
86+
"message" : "This snippet is used to launch a new process under the .NET debugger (coreclr), specifying the path to the executable to launch. In most cases, the \".NET: Launch C# project\" snippet is a better choice. This snippet is useful when the project was built outside this VS Code instance or you want to host your .NET Code in a custom executable, such as a specific version of 'dotnet.exe'/'dotnet' or the .NET Code is hosted by a native application. This snippet is for console applications.",
87+
"comment": [
88+
"'coreclr' is the name of the debugger 'type', and should not be localized",
89+
"{Locked='(coreclr)'}"
90+
]
91+
},
92+
"debuggers.coreclr.configurationSnippets.description.web-local": {
93+
"message": "This snippet is used to launch a new process under the .NET debugger (coreclr), specifying the path to the executable to launch. In most cases, the \".NET: Launch C# project\" snippet is a better choice. This snippet is useful when the project was built outside this VS Code instance or you want to host your .NET Code in a custom executable, such as a specific version of 'dotnet.exe'/'dotnet' or the .NET Code is hosted by a native application. This snippet is for web (ASP.NET Core) applications.",
94+
"comment": [
95+
"'coreclr' is the name of the debugger 'type', and should not be localized",
96+
"{Locked='(coreclr)'}"
97+
]
98+
},
99+
"debuggers.coreclr.configurationSnippets.description.attach": {
100+
"message": "Attach the .NET debugger (coreclr) to a running process. This can also be done using the 'Attach to a .NET 5+ or .NET Core process' command.",
101+
"comment": [
102+
"'coreclr' is the name of the debugger 'type', and should not be localized",
103+
"{Locked='(coreclr)'}"
104+
]
105+
},
106+
"debuggers.coreclr.configurationSnippets.description.remote": "This snippet shows how to remote debug .NET Code **without** using VS Code remoting. It should be used in cases where you want to build your project locally but run it on another computer.",
107+
"debuggers.coreclr.configurationSnippets.description.blazor-hosted": {
108+
"message": "This snippet is used to launch a new process under the Blazor WebAssembly debugger (blazorwasm), specifying the path to the executable to launch. In most cases, the \".NET: Launch C# project\" snippet is a better choice, but this snippet can be used to have full control over all launch options. This snippet is for hosted Blazor projects, which is a project that has a backend ASP.NET Core app to serve its files.",
109+
"comment": [
110+
"'blazorwasm' is the name of the debugger 'type', and should not be localized",
111+
"{Locked='(blazorwasm)'}"
112+
]
113+
},
114+
"debuggers.coreclr.configurationSnippets.description.blazor-standalone": {
115+
"message": "This snippet is used to launch a new process under the Blazor WebAssembly debugger (blazorwasm). In most cases, the \".NET: Launch C# project\" snippet is a better choice, but this snippet can be used to have full control over all launch options. This snippet is for standalone Blazor projects, which is a project that does not have a backend ASP.NET Core app to serve its files.",
116+
"comment": [
117+
"'blazorwasm' is the name of the debugger 'type', and should not be localized",
118+
"{Locked='(blazorwasm)'}"
119+
]
120+
},
78121
"debuggers.dotnet.launch.projectPath.description": "Path to the .csproj file.",
79122
"debuggers.dotnet.launch.launchConfigurationId.description": "The launch configuration id to use. Empty string will use the current active configuration.",
123+
"debuggers.dotnet.configurationSnippets.label": ".NET: Launch C# project",
124+
"debuggers.dotnet.configurationSnippets.description": "This snippet configures VS Code to debug a C# project. Debug options (example: arguments to the executable) can be configured through the '<project-directory>/Properties/launchSettings.json' file.",
80125
"viewsWelcome.debug.contents": {
81126
"message": "[Generate C# Assets for Build and Debug](command:dotnet.generateAssets)\n\nTo learn more about launch.json, see [Configuring launch.json for C# debugging](https://aka.ms/VSCode-CS-LaunchJson).",
82127
"comment": [

0 commit comments

Comments
 (0)