Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
WinUI 3 is het systeemeigen UI-framework voor het bouwen van Windows desktop-apps. Het maakt deel uit van de Windows App SDK: een set API's en hulpprogramma's die los staan van het Windows besturingssysteem zelf en moet worden geïnstalleerd op de doelcomputer of naast uw app worden verpakt. WinUI 3 ondersteunt zowel C# als C++ en is geen platformoverschrijdend framework of webframework.
Important
WinUI 3 verschilt van UWP. WinUI 3 maakt gebruik van de Microsoft.UI.Xaml naamruimte en wordt uitgevoerd als een desktopproces; UWP gebruikt Windows.UI.Xaml en wordt uitgevoerd in een app-container. WinUI 3 ondersteunt verpakte (MSIX), verpakt met externe locatie en uitgepakte distributie. De juiste keuze is afhankelijk van uw implementatiescenario. Zie Kies een distributiemethode voor hulp.
Kies uw pad
Er bestaan twee ondersteunde paden voor het maken van een WinUI 3-project.
| Visual Studio | Opdrachtregel | |
|---|---|---|
| Het beste voor | Ontwikkelaars die niet bekend zijn met Windows ontwikkeling, visuele UI-ontwerpers of iedereen die een volledige IDE-ervaring wil | Ontwikkelaars die vertrouwd zijn met de terminal, CI/CD-pijplijnen of de installatie van een scriptomgeving |
| Gereedschappen | Visual Studio 2026 met de Windows App SDK- en WinUI-workloads geïnstalleerd | .NET 10 SDK met dotnet new WinUI-sjablonen |
| Project aanmaken | Wizard Nieuw project — selecteer de sjabloon Lege app, verpakt (WinUI 3 voor desktop) | dotnet new winui -n MyApp |
| Bouwen en uitvoeren | Druk op F5 — Visual Studio compileert, ondertekent, implementeert het MSIX-pakket en start de app |
dotnet run — bouwt en start de app met pakketidentiteit (hiervoor is de ontwikkelaarsmodus vereist) |
| foutopsporing | Volledige Visual Studio foutopsporingsprogramma met live preview van XAML | Voeg handmatig een foutopsporingsprogramma toe of open het gegenereerde .sln in Visual Studio |
Beide paden produceren gelijkwaardige WinUI 3-projecten. Het Visual Studio pad verwerkt automatisch MSIX-ondertekening en -implementatie. Het opdrachtregelpad gebruikt dotnet run voor lokale ontwikkeling (het meegeleverde Microsoft.Windows.SDK.BuildTools.WinApp-pakket verwerkt de debug-identiteit automatisch); voor verpakking voor distributie zijn aanvullende stappen vereist.
Vereiste voorwaarden
Beide paden delen dezelfde minimale vereisten.
- Windows 10 versie 1809 (build 17763) of hoger: Windows 11 wordt aanbevolen
-
Ontwikkelaarsmodus ingeschakeld op uw apparaat (
ms-settings:developers) - Visual Studio 2026 (Visual Studio-route) of .NET 10 SDK (opdrachtregelroute)
De Windows App SDK is een afzonderlijke installatie van Windows. Visual Studio installeert het als onderdeel van de installatie van de workload. Voor het opdrachtregelpad brengen de dotnet new winui sjablonen automatisch de vereiste NuGet-pakketten in.
Volgende stappen
Windows developer