Skip to content

[docs] Document unpackaged WinUI 3 debugging fix in VS Code extension - #1616

Draft
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.6from
docs/pr-19877-33814652846-1-1de311c56fd421f3
Draft

[docs] Document unpackaged WinUI 3 debugging fix in VS Code extension#1616
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.6from
docs/pr-19877-33814652846-1-1de311c56fd421f3

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#19877

@ellahathaway

Targeting release/13.6 based on the source PR milestone 13.6.

Why

microsoft/aspire#19877 fixes a crash (0xC000027B in Microsoft.UI.Xaml.Application.Start()) when debugging unpackaged WinUI 3 projects through the Aspire VS Code extension. The PR body includes a "User-facing usage" section explaining that the extension now launches the generated apphost executable (RunCommand) instead of the managed DLL, with no project configuration changes required. This is a user-visible behavior change to the existing debugging experience described on the VS Code extension docs page, so it needed to be captured there.

What changed

  • Added a note under Language coverage in src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx explaining that unpackaged WinUI 3 resources (added via a normal Project launch profile, e.g. builder.AddProject<Projects.WinUIApp>("winui")) are launched via their generated apphost executable rather than the managed DLL, and that no project configuration changes, debugger attach behavior, launch-profile arguments, environment variables, or cleanup behavior are affected.

Files modified

  • src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx (updated existing page, no new pages created)

Generated by PR Documentation Check for #19877 · auto · 38.8 AIC · ⌖ 8.27 AIC · ⊞ 19.7K ·

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label Sep 3, 2026
@aspire-repo-bot

Copy link
Copy Markdown
Contributor Author

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #1616. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #1616 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants