Winui Dev Workflow

Build-and-run loop voor WinUI 3 apps: BuildAndRun.ps1, winapp run, build-error fix tabel

Door microsoft · microsoft/win-dev-skills

Werkt met setup ★ 8.0/10

Winui Dev Workflow — Build-and-run loop voor WinUI 3 apps: BuildAndRun.ps1, winapp run, build-error fix tabel

Wat het doet

Microsoft's skill voor de WinUI 3 / Windows App SDK inner loop: een project scaffolden met `dotnet new winui-mvvm`, bouwen en lanceren via de gebundelde BuildAndRun.ps1 (Developer Mode check, x64/ARM64 auto-detectie, `winapp run --debug-output`), en crashes diagnosticeren via WinUI stowed-exception triage. Bevat een opzoektabel die concrete foutcodes (XLS0414, MSB3073, 0x8000FFFF, 0x8007000B, leeg venster van x:Bind OneTime) koppelt aan oplossingen. Activeert wanneer u een WinUI 3 project bouwt, uitvoert of build-/opstartfouten oplost. Alleen Windows: vereist PowerShell, .NET SDK en de winapp CLI.

Testrapport

De repo gekloond en de skill gevonden op plugins/winui/skills/winui-dev-workflow; frontmatter netjes geparset via yaml.safe_load met exact naam + beschrijving, en het kopiëren van de map naar een tijdelijke HOME plaatste SKILL.md op ~/.claude/skills/winui-dev-workflow/SKILL.md. Raw-fetched SKILL.md, BuildAndRun.ps1 en analyzer/Microsoft.WindowsAppSDK.Analyzers.targets — allemaal HTTP 200; ik las alle 267 regels van BuildAndRun.ps1 en bevestigde elk van de zes gedragingen die SKILL.md ervoor claimt (AppModelUnlock registry Developer-Mode check, single-csproj discovery, PROCESSOR_ARCHITECTURE platform detect, dotnet build met /restore, bin\<Platform>\<Config>\net*\win-<rid> output lookup, `winapp run --debug-output`), plus een `finally` blok dat de tijdelijke Directory.Build.props verwijdert en een beveiliging die weigert een reeds bestaande te overschrijven. Geen curl|sh, geen base64, geen netwerkoproepen, geen geheimen, geen hardgecodeerde machinepaden — alleen een 49KB voorgebouwde analyzer DLL waarvan de bron zich in de repo bevindt op src/tools/winui-analyzer. OUTPUT-fase kon niet worden uitgevoerd: deze Mac heeft geen pwsh/powershell, geen dotnet, geen winapp (`pwsh -File ./BuildAndRun.ps1 -SkipRun` → "command not found"), en de Developer-Mode check leest HKLM, dus er is nooit een build uitgevoerd; ik schreef in plaats daarvan twee tekst-artefacten (scratchpad/wdw_baseline.md vs wdw_skill.md) voor een leeg-venster + 0x8000FFFF diagnose — baseline greep naar Visual Studio F5, Add-AppxPackage en try/catch rond InitializeComponent en lijstte vier speculatieve oorzaken voor een leeg venster op, terwijl de skill-versie de hele loop vervangt door één asynchrone BuildAndRun.ps1 aanroep, de enige hoofdoorzaak "x:Bind defaults to OneTime — add Mode=OneWay" noemt, en feiten toevoegt die baseline nooit produceerde (WINAPP_DBGTOOLS_DIR om de eerste-crash debugger-tools download over te slaan, MSB3073 XamlCompiler exit-1 = update Microsoft.WindowsAppSDK naar >= 2.1.3). Dit zijn gedocumenteerde inhoudelijke verschillen, geen geverifieerd runtimegedrag, dus outputMeasured blijft false en het oordeel is setup. Triggerzinnen beoordeeld: MOET laden — "My WinUI 3 app won't build, I'm getting XLS0414 on a custom control" (ja), "Scaffold a new WinUI 3 desktop app and get it running" (ja), "The Windows App SDK app launches then instantly closes with 0x8000FFFF" (ja); MOET NIET — "Sign my MSIX and submit it to the Microsoft Store" (nee, dat is de zuster skill winui-packaging), "My React Native Windows app fails to build on x64" (nee, geen WinUI 3). 5/5 correct.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/microsoft/win-dev-skills.git /tmp/winui-dev-workflow-src
mkdir -p ~/.claude/skills
cp -R /tmp/winui-dev-workflow-src/plugins/winui/skills/winui-dev-workflow ~/.claude/skills/winui-dev-workflow
# Windows-only skill. Runtime prerequisites (not installed by the copy above):
#   .NET SDK >= 8.0 (10 recommended): winget install Microsoft.DotNet.SDK.10
#   winapp CLI >= 0.3:                winget install Microsoft.WinAppCLI
#   WinUI templates:                  dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates
#   Developer Mode: Settings > System > For developers > On
# The skill ships BuildAndRun.ps1 plus a prebuilt analyzer/Microsoft.WindowsAppSDK.Analyzers.dll
# (source in the same repo at src/tools/winui-analyzer) that the script injects into your build
# via a temporary Directory.Build.props and removes afterwards.
# Plugin-marketplace alternative (installs all 7 winui skills + agents):
#   claude plugin marketplace add microsoft/win-dev-skills && claude plugin install winui@win-dev-skills

Commando's en voorbeeldprompts

/winui-dev-workflowBuild-and-run loop voor WinUI 3 apps: BuildAndRun.ps1, winapp run, build-error fix tabel

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

Fix this WinUI 3 build error
Run my WinUI app with BuildAndRun.ps1
Diagnose why winapp run is failing

Volledig rapport (Engels) →