Winui Dev Workflow

Bygge- og køre-loop for WinUI 3-apps: BuildAndRun.ps1, winapp run, tabel for løsning af byggefejl

Af microsoft · microsoft/win-dev-skills

Virker med opsætning ★ 8.0/10

Winui Dev Workflow — Bygge- og køre-loop for WinUI 3-apps: BuildAndRun.ps1, winapp run, tabel for løsning af byggefejl

Hvad det gør

Microsofts skill for WinUI 3 / Windows App SDKs indre loop: scaffolding af et projekt med `dotnet new winui-mvvm`, bygning og lancering via den medfølgende BuildAndRun.ps1 (Developer Mode-kontrol, x64/ARM64 auto-detektion, `winapp run --debug-output`), og diagnosticering af nedbrud via WinUI stowed-exception triage. Inkluderer en opslagstabel, der mapper konkrete fejlkoder (XLS0414, MSB3073, 0x8000FFFF, 0x8007000B, blankt vindue fra x:Bind OneTime) til løsninger. Udløses, når du bygger, kører eller retter bygge-/startfejl i et WinUI 3-projekt. Kun Windows: kræver PowerShell, .NET SDK og winapp CLI.

Testrapport

Klonede repoet og fandt skillen i plugins/winui/skills/winui-dev-workflow; frontmatter parsed rent via yaml.safe_load med præcis navn + beskrivelse, og kopiering af mappen til en midlertidig HOME placerede SKILL.md i ~/.claude/skills/winui-dev-workflow/SKILL.md. Rå-hentede SKILL.md, BuildAndRun.ps1 og analyzer/Microsoft.WindowsAppSDK.Analyzers.targets — alle HTTP 200; jeg læste alle 267 linjer af BuildAndRun.ps1 og bekræftede hver af de seks adfærd, SKILL.md hævder for den (AppModelUnlock registry Developer-Mode check, single-csproj discovery, PROCESSOR_ARCHITECTURE platform detect, dotnet build med /restore, bin\<Platform>\<Config>\net*\win-<rid> output lookup, `winapp run --debug-output`), plus en `finally`-blok, der sletter den midlertidige Directory.Build.props og en beskyttelse, der nægter at overskrive en eksisterende. Ingen curl|sh, ingen base64, ingen netværkskald, ingen hemmeligheder, ingen hardkodede maskinstier — kun en 49KB forudbygget analyzer DLL, hvis kilde ligger i repoet i src/tools/winui-analyzer. OUTPUT-fasen kunne ikke udføres: denne Mac har ingen pwsh/powershell, ingen dotnet, ingen winapp (`pwsh -File ./BuildAndRun.ps1 -SkipRun` → "command not found"), og Developer-Mode-kontrollen læser HKLM, så ingen build kørte nogensinde; jeg skrev i stedet to tekst-artefakter (scratchpad/wdw_baseline.md vs wdw_skill.md) for en blank-vindue + 0x8000FFFF diagnose — baseline rakte ud efter Visual Studio F5, Add-AppxPackage og try/catch omkring InitializeComponent og listede fire spekulative blank-vindue årsager, mens skill-versionen erstatter hele loopet med ét asynkront BuildAndRun.ps1-kald, navngiver den enkelte rodårsag "x:Bind defaults to OneTime — add Mode=OneWay", og tilføjer fakta, baseline aldrig producerede (WINAPP_DBGTOOLS_DIR for at springe den første-nedbrud debugger-værktøjsdownload over, MSB3073 XamlCompiler exit-1 = opdater Microsoft.WindowsAppSDK til >= 2.1.3). Disse er dokumenterede indholdsforskelle, ikke verificeret runtime-adfærd, so outputMeasured forbliver falsk, og dommen er opsætning. Udløsningsfraser bedømt: SKULLE indlæses — "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); SKULLE IKKE — "Sign my MSIX and submit it to the Microsoft Store" (nej, det er den beslægtede winui-packaging skill), "My React Native Windows app fails to build on x64" (nej, ikke WinUI 3). 5/5 korrekt.

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

Installation

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

Kommandoer og eksempelprompter

  • /winui-dev-workflowBygge- og køre-loop for WinUI 3-apps: BuildAndRun.ps1, winapp run, tabel for løsning af byggefejl

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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