debug: allow adapters to be deprecated (#151973)

For #151910

src/vs/workbench/contrib/debug/common/debug.ts

@@ -779,6 +779,7 @@ export interface IDebuggerContribution extends IPlatformSpecificAdapterContribut
 	configurationSnippets?: IJSONSchemaSnippet[];
 	variables?: { [key: string]: string };
 	when?: string;
+	deprecated?: string;
 	uiMessages?: { [key in DebuggerUiMessage]: string };
 }
 

src/vs/workbench/contrib/debug/common/debugSchemas.ts

@@ -72,6 +72,11 @@ export const debuggersExtPoint = extensionsRegistry.ExtensionsRegistry.registerE
 					type: 'string',
 					default: ''
 				},
+				deprecated: {
+					description: nls.localize('vscode.extension.contributes.debuggers.deprecated', "Optional message to mark this debug type as being deprecated."),
+					type: 'string',
+					default: ''
+				},
 				windows: {
 					description: nls.localize('vscode.extension.contributes.debuggers.windows', "Windows specific settings."),
 					type: 'object',

src/vs/workbench/contrib/debug/common/debugger.ts

@@ -236,7 +236,8 @@ export class Debugger implements IDebugger, IDebuggerMetadata {
 				enumDescriptions: [this.label],
 				description: nls.localize('debugType', "Type of configuration."),
 				pattern: '^(?!node2)',
-				deprecationMessage: this.enabled ? undefined : debuggerDisabledMessage(this.type),
+				deprecationMessage: this.debuggerContribution.deprecated || (this.enabled ? undefined : debuggerDisabledMessage(this.type)),
+				doNotSuggest: !!this.debuggerContribution.deprecated,
 				errorMessage: nls.localize('debugTypeNotRecognised', "The debug type is not recognized. Make sure that you have a corresponding debug extension installed and that it is enabled."),
 				patternErrorMessage: nls.localize('node2NotSupported', "\"node2\" is no longer supported, use \"node\" instead and set the \"protocol\" attribute to \"inspector\".")
 			};