VS Code extension: detect missing debugger extension and prompt to install

[Copilot]

When "Launch and Attach" is invoked without the required debugger extension installed (e.g. C# for coreclr), VS Code surfaces a cryptic internal error rather than a clear indication of what's missing.

Changes

• DEBUGGER_EXTENSION_MAP — maps debugger type strings to their required VS Code extension:

  • coreclr → ms-dotnettools.csharp
  • cppvsdbg → ms-vscode.cpptools

• ensureDebuggerExtensionInstalled() — called in createDebugAdapterDescriptor before spawning winapp run, so the user gets an actionable error immediately rather than after the app has already launched. If the extension is absent, shows:

  "The "coreclr" debugger requires the C# (ms-dotnettools.csharp) VS Code extension. Please install it and reload VS Code, then retry."

  with an Install Extension button that calls workbench.extensions.installExtension and follows up with a reload reminder.

const DEBUGGER_EXTENSION_MAP: Record<string, { id: string; name: string }> = {
    'coreclr':   { id: 'ms-dotnettools.csharp', name: 'C# (ms-dotnettools.csharp)' },
    'cppvsdbg':  { id: 'ms-vscode.cpptools',    name: 'C/C++ (ms-vscode.cpptools)' },
};

// In createDebugAdapterDescriptor, before winapp run is spawned:
if (!await ensureDebuggerExtensionInstalled(debuggerType)) {
    return new vscode.DebugAdapterInlineImplementation(new NoOpDebugAdapter());
}

Unknown debugger types (e.g. node) pass through unchanged.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/graphql
  • Triggering command: `/usr/bin/gh gh pr create --title Fix: Show clear error and offer install prompt when required debugger extension is missing --body ## Summary

Fixes the issue where attempting Launch and Debug without the C# VS Code extension installed results in a cryptic error about a missing coreclr extension.

Changes

Added a DEBUGGER_EXTENSION_MAP that maps debugger type strings to t t` (http block)

• Triggering command: /usr/bin/gh gh pr list --state open /electron/Assets--detach (http block)
• Triggering command: /usr/bin/gh gh pr edit 384 --base alzollin/vsc (http block)
• https://api.github.com/repos/microsoft/winappCli/pulls/384
  • Triggering command: /usr/bin/curl curl -s -X PATCH -H Authorization: token -H Accept: application/vnd.github.v3+json REDACTED -d {"base":"alzollin/vsc"} git rkin�� 42298f9b:samples/electron/Assets/AppList.targetsize-36.png (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[chiaramooney]

@copilot What was the base branch copilot/bugfix-enable-csharp-extension-installation based off of? It should have been alzollin/vsc but it looks like you began with a checkout from main. Please adjust this PR to use alzollin/vsc as the base branch, then checkout your branch off of that branch, and then apply your feature changes.

[Copilot]

@copilot What was the base branch copilot/bugfix-enable-csharp-extension-installation based off of? It should have been alzollin/vsc but it looks like you began with a checkout from main. Please adjus...

I've merged alzollin/vsc into this branch (commit 42d0fc8), which means:

1. The branch now has the complete alzollin/vsc codebase as its second parent
2. The diff of this branch against alzollin/vsc shows only the extension.ts fix (46 lines added: DEBUGGER_EXTENSION_MAP + ensureDebuggerExtensionInstalled, and the early check in createDebugAdapterDescriptor) — nothing else

To complete the retargeting, the PR base needs to be manually changed from main to alzollin/vsc via the GitHub UI (Edit → Base branch). Once that's done, the PR will show only the single-file fix. I wasn't able to do it programmatically as the available tools return 403 for that operation.

[chiaramooney]

@copilot right now the PR is showing changes to 272 files when alzollin/vsc is set as the base branch. I think the branch is in a wonky state. Maybe try reverting all of your changes so the branch exactly matches alzollin/vsc and then reapply your fix.

[Copilot]

@copilot right now the PR is showing changes to 272 files when alzollin/vsc is set as the base branch. I think the branch is in a wonky state. Maybe try reverting all of your changes so the branch exa...

Done in commit c3cccd0. The branch now exactly matches alzollin/vsc plus only the one-file fix — git diff origin/alzollin/vsc HEAD shows a single file changed: src/winapp-VSC/src/extension.ts (52 lines added). The PR should now show just that change when alzollin/vsc is set as the base branch.