Winui Dev Workflow

Bygge-og-kjøre-løkke for WinUI 3-apper: BuildAndRun.ps1, winapp run, byggefeil-fikse-tabell

Krever oppsett ★ 8.0/10

Hva den gjør

Microsofts ferdighet for WinUI 3 / Windows App SDK indre løkke: stillaser et prosjekt med `dotnet new winui-mvvm`, bygger og starter via den medfølgende BuildAndRun.ps1 (utviklermodus-sjekk, x64/ARM64 auto-deteksjon, `winapp run --debug-output`), og diagnostiserer krasj via WinUI stowed-exception triage. Inkluderer en oppslagstabell som mapper konkrete feilkoder (XLS0414, MSB3073, 0x8000FFFF, 0x8007000B, blankt vindu fra x:Bind OneTime) til løsninger. Utløses når du bygger, kjører eller fikser bygge-/startfeil i et WinUI 3-prosjekt. Kun Windows: krever PowerShell, .NET SDK og winapp CLI.

Testrapport

Klonet repoet og fant ferdigheten på plugins/winui/skills/winui-dev-workflow; frontmatter parses rent via yaml.safe_load med nøyaktig navn + beskrivelse, og kopiering av mappen til en midlertidig HOME plasserte SKILL.md på ~/.claude/skills/winui-dev-workflow/SKILL.md. Rå-hentet SKILL.md, BuildAndRun.ps1 og analyzer/Microsoft.WindowsAppSDK.Analyzers.targets — alle HTTP 200; jeg leste alle 267 linjene i BuildAndRun.ps1 og bekreftet hver av de seks atferdene SKILL.md hevder for den (AppModelUnlock registry Developer-Mode check, single-csproj discovery, PROCESSOR_ARCHITECTURE platform detect, dotnet build with /restore, bin\<Platform>\<Config>\net*\win-<rid> output lookup, `winapp run --debug-output`), pluss en `finally`-blokk som sletter den midlertidige Directory.Build.props og en vakt som nekter å overskrive en eksisterende. Ingen curl|sh, ingen base64, ingen nettverkskall, ingen hemmeligheter, ingen hardkodede maskinstier — kun en 49KB forhåndsbygd analysator-DLL hvis kilde ligger i repoet på src/tools/winui-analyzer. UTDATA-fasen kunne ikke utføres: denne Macen har ingen pwsh/powershell, ingen dotnet, ingen winapp (`pwsh -File ./BuildAndRun.ps1 -SkipRun` → "command not found"), og Developer-Mode-sjekken leser HKLM, så ingen bygging kjørte; jeg skrev i stedet to tekst-artefakter (scratchpad/wdw_baseline.md vs wdw_skill.md) for en blank-vindu + 0x8000FFFF diagnose — baseline nådde for Visual Studio F5, Add-AppxPackage og try/catch rundt InitializeComponent og listet fire spekulative blank-vindu-årsaker, mens ferdighetsversjonen erstatter hele løkken med ett asynkront BuildAndRun.ps1-kall, navngir den eneste rotårsaken "x:Bind defaults to OneTime — add Mode=OneWay", og legger til fakta baseline aldri produserte (WINAPP_DBGTOOLS_DIR for å hoppe over den første krasj-debugger-verktøy-nedlastingen, MSB3073 XamlCompiler exit-1 = oppdater Microsoft.WindowsAppSDK til >= 2.1.3). Dette er dokumenterte innholdsforskjeller, ikke verifisert kjøretidsatferd, så outputMeasured forblir falsk og dommen er oppsett. Utløserfraser vurdert: SKAL lastes — "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); SKAL IKKE — "Sign my MSIX and submit it to the Microsoft Store" (nei, det er søskenferdigheten winui-packaging), "My React Native Windows app fails to build on x64" (nei, ikke WinUI 3). 5/5 korrekt.

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

Installer

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-kjøre-løkke for WinUI 3-apper: BuildAndRun.ps1, winapp run, byggefeil-fikse-tabell

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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

Full rapport →