Kom igång med WinUI

WinUI 3 är det interna användargränssnittsramverket för att skapa Windows skrivbordsappar. Det är en del av Windows App SDK – en uppsättning API:er och verktyg som är separata från själva Windows operativsystem och måste installeras på måldatorn eller paketeras tillsammans med din app. WinUI 3 stöder både C# och C++ och är inte ett plattformsoberoende eller webbaserat ramverk.

Important

WinUI 3 skiljer sig från UWP. WinUI 3 använder Microsoft.UI.Xaml namnområdet och körs som en skrivbordsprocess. UWP använder Windows.UI.Xaml och körs i en appcontainer. WinUI 3 stöder paketerad distribution (MSIX), paketerad distribution med extern lagringsplats och opaketerad distribution – rätt val beror på ditt distributionsscenario. Se Välj en distributionsmetod för vägledning.

Välj sökväg

Det finns två sökvägar som stöds för att skapa ett WinUI 3-projekt.

	Visual Studio	Kommandorad
Bäst för	Utvecklare som är nya för att Windows utveckling, visuella användargränssnittsdesigners eller någon som vill ha en fullständig IDE-upplevelse	Utvecklare som är bekväma med terminalen, CI/CD-pipelines eller skriptmiljökonfiguration
Verktyg	Visual Studio 2026 installerat med Windows App SDK- och WinUI-arbetsbelastningarna	.NET 10 SDK med dotnet new WinUI-mallar
Skapa projekt	Guiden Nytt projekt – välj mallen Tom app, paketerad (WinUI 3 för skrivbordet)	dotnet new winui -n MyApp
Skapa och köra	Tryck på F5 – Visual Studio bygger, signerar, distribuerar MSIX-paketet och startar appen	dotnet run – skapar och startar appen med paketidentitet (kräver utvecklarläge)
Debugging	Komplett felsökning i Visual Studio med liveförhandsgranskning i XAML	Koppla ett felsökningsprogram manuellt eller öppna det genererade .sln i Visual Studio

Båda sökvägarna skapar motsvarande WinUI 3-projekt. Den Visual Studio sökvägen hanterar MSIX-signering och distribution automatiskt. Kommandoradssökvägen använder dotnet run för lokal utveckling (det inkluderade Microsoft.Windows.SDK.BuildTools.WinApp paketet hanterar felsökningsidentitet automatiskt). Paketering för distribution kräver ytterligare steg.

Förutsättningar

Båda sökvägarna har samma minimikrav.

• Windows 10 version 1809 (version 17763) eller senare – Windows 11 rekommenderas
• Utvecklarläge aktiverat på enheten (ms-settings:developers)
• Visual Studio 2026 (Visual Studio sökväg) eller .NET 10 SDK (kommandoradssökväg)

Windows App SDK är en separat installation från Windows. Visual Studio installerar den som en del av arbetsbelastningskonfigurationen. För kommandoradssökvägen dotnet new winui tar mallarna in de nödvändiga NuGet-paketen automatiskt.

Nästa steg

Snabbstart: Visual Studio

Snabbstart: Kommandorad