You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This PR updates the debugger to 1.23.17. This includes:
* All the bug fixes that went into Visual Studio 17 GA
* Updating the debugger to run on .NET 6 RC2
* Enhanced support for launchSettings.json ([#3121](#3121))
* Now that most users will not need to download the debugger themselves (it comes pre-packaged in a platform specific .vsix), this changes back to the Azure CDN instead of https://download.visualstudio.microsoft.com
This also updates `gulp updatePackageDependencies` to support updating packages when the primary URL just has a simple version number.
Copy file name to clipboardExpand all lines: CHANGELOG.md
+5Lines changed: 5 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,8 +12,13 @@
12
12
* As a workaround, make an edit within the file before using Rename Symbol.
13
13
14
14
## 1.23.17 (Not released yet)
15
+
* Greatly improved download experience: when the C# extension is downloaded from the VS Code Marketplace, it will include all of its dependencies already ([#4775](https://github.com/OmniSharp/omnisharp-vscode/issues/4775))
* Fix typo in Readme.md (PR: [#4819](https://github.com/OmniSharp/omnisharp-vscode/pull/4819))
18
+
* Debugger changes:
19
+
* The debugger itself runs on .NET 6 RC2
20
+
* Enhanced support for launchSettings.json ([#3121](https://github.com/OmniSharp/omnisharp-vscode/issues/3121))
21
+
* Fixed process listing on Windows 11 (PR: [#4848](https://github.com/OmniSharp/omnisharp-vscode/pull/4848)) _(Many thanks to [@eternalphane](https://github.com/eternalphane))_
17
22
18
23
## 1.23.16 (Oct 12th, 2021)
19
24
* Show decompilation authorization once per install. ([#3982](https://github.com/OmniSharp/omnisharp-vscode/issues/3982), PR: [#4760](https://github.com/OmniSharp/omnisharp-vscode/pull/4760))
Copy file name to clipboardExpand all lines: debugger-launchjson.md
+28-9Lines changed: 28 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -108,9 +108,26 @@ Environment variables may be passed to your program using this schema:
108
108
"myVariableName":"theValueGoesHere"
109
109
}
110
110
111
-
NOTE: Environment variables can also be configured through a `${cwd}/Properties/launchSettings.json` file, which is useful for environment variables that should be set in all development scenarios -- when the project is started from the command line (`dotnet run`), from Visual Studio Code, or Visual Studio.
111
+
## Console (terminal) window
112
+
113
+
The `"console"` setting controls what console (terminal) window the target app is launched into. It can be set to any of these values --
114
+
115
+
`"internalConsole"` (default) : the target process's console output (stdout/stderr) goes to the VS Code Debug Console. This is useful for executables that take their input from the network, files, etc. But this does **NOT** work for applications that want to read from the console (ex: `Console.ReadLine`).
116
+
117
+
`"integratedTerminal"` : the target process will run inside [VS Code's integrated terminal](https://code.visualstudio.com/docs/editor/integrated-terminal). Click the 'Terminal' tab in the tab group beneath the editor to interact with your application. Alternatively add `"internalConsoleOptions": "neverOpen"` to make it so that the default foreground tab is the terminal tab.
118
+
119
+
`"externalTerminal"`: the target process will run inside its own external terminal.
120
+
121
+
## launchSettings.json support
112
122
113
-
Example Properties/launchSettings.json file:
123
+
In addition to launch.json, launch options can be configured through a {cwd}/Properties/launchSettings.json file. The advantage of
124
+
launchSettings.json is that it allows settings to be shared between Visual Studio Code, full Visual Studio, and `dotnet run`.
125
+
126
+
To configure which launchSettings.json profile to use (or to prevent it from being used), set the `launchSettingsProfile` option:
127
+
128
+
"launchSettingsProfile": "ProfileNameGoesHere"
129
+
130
+
Which would then, for example, use `myVariableName` from this example launchSettings.json file:
114
131
115
132
```json
116
133
{
@@ -125,15 +142,17 @@ Example Properties/launchSettings.json file:
125
142
}
126
143
```
127
144
128
-
## Console (terminal) window
129
-
130
-
The `"console"` setting controls what console (terminal) window the target app is launched into. It can be set to any of these values --
145
+
If `launchSettingsProfile` is NOT specified, the first profile with `"commandName": "Project"` will be used.
131
146
132
-
`"internalConsole"` (default) : the target process's console output (stdout/stderr) goes to the VS Code Debug Console. This is useful for executables that take their input from the network, files, etc. But this does **NOT** work for applications that want to read from the console (ex: `Console.ReadLine`).
147
+
If `launchSettingsProfile` is set to null/an empty string, then Properties/launchSettings.json will be ignored.
133
148
134
-
`"integratedTerminal"` : the target process will run inside [VS Code's integrated terminal](https://code.visualstudio.com/docs/editor/integrated-terminal). Click the 'Terminal' tab in the tab group beneath the editor to interact with your application. Alternatively add `"internalConsoleOptions": "neverOpen"` to make it so that the default foreground tab is the terminal tab.
135
-
136
-
`"externalTerminal"`: the target process will run inside its own external terminal.
149
+
Restrictions:
150
+
1. The launchSettings.json file must be in {cwd}/Properties/launchSettings.json
151
+
2. Only profiles with `"commandName": "Project"` are supported.
152
+
3. Only `environmentVariables`, `applicationUrl` and `commandLineArgs` properties are supported
153
+
4. Settings in launch.json will take precedence over settings in launchSettings.json, so for example, if `args`
154
+
is already set to something other than an empty string/array in `launch.json` then the launchSettings.json
155
+
content will be ignored.
137
156
138
157
## Source File Map
139
158
You can optionally configure how source files are opened by providing a map using this form:
"description": "Attribute 'externalConsole' is deprecated, use 'console' instead.",
1239
1232
"default": false
1240
1233
},
1234
+
"launchSettingsProfile": {
1235
+
"anyOf": [
1236
+
{
1237
+
"type": "string"
1238
+
},
1239
+
{
1240
+
"type": "null"
1241
+
}
1242
+
],
1243
+
"description": "If specified, indicates the name of the profile in {cwd}/Properties/launchSettings.json to use. This is ignored if launchSettings.json is not found. If this is set to null or an empty string then launchSettings.json is ignored. If this value is not specified the first 'Project' profile will be used.",
1244
+
"default": "<insert-profile-name>"
1245
+
},
1241
1246
"sourceFileMap": {
1242
1247
"type": "object",
1243
1248
"description": "Optional source file mappings passed to the debug engine. Example: '{ \"C:\\foo\":\"/home/user/foo\" }'",
@@ -2344,6 +2349,18 @@
2344
2349
"description": "Attribute 'externalConsole' is deprecated, use 'console' instead.",
2345
2350
"default": false
2346
2351
},
2352
+
"launchSettingsProfile": {
2353
+
"anyOf": [
2354
+
{
2355
+
"type": "string"
2356
+
},
2357
+
{
2358
+
"type": "null"
2359
+
}
2360
+
],
2361
+
"description": "If specified, indicates the name of the profile in {cwd}/Properties/launchSettings.json to use. This is ignored if launchSettings.json is not found. If this is set to null or an empty string then launchSettings.json is ignored. If this value is not specified the first 'Project' profile will be used.",
2362
+
"default": "<insert-profile-name>"
2363
+
},
2347
2364
"sourceFileMap": {
2348
2365
"type": "object",
2349
2366
"description": "Optional source file mappings passed to the debug engine. Example: '{ \"C:\\foo\":\"/home/user/foo\" }'",
Copy file name to clipboardExpand all lines: src/tools/OptionsSchema.json
+12Lines changed: 12 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -323,6 +323,18 @@
323
323
"description": "Attribute 'externalConsole' is deprecated, use 'console' instead.",
324
324
"default": false
325
325
},
326
+
"launchSettingsProfile": {
327
+
"anyOf": [
328
+
{
329
+
"type": "string"
330
+
},
331
+
{
332
+
"type": "null"
333
+
}
334
+
],
335
+
"description": "If specified, indicates the name of the profile in {cwd}/Properties/launchSettings.json to use. This is ignored if launchSettings.json is not found. If this is set to null or an empty string then launchSettings.json is ignored. If this value is not specified the first 'Project' profile will be used.",
336
+
"default": "<insert-profile-name>"
337
+
},
326
338
"sourceFileMap": {
327
339
"type": "object",
328
340
"description": "Optional source file mappings passed to the debug engine. Example: '{ \"C:\\foo\":\"/home/user/foo\" }'",
0 commit comments