Snel aan de slag: Uw eerste WinUI 3-app maken

Uw eerste WinUI 3-app maken, bouwen en uitvoeren. Kies Visual Studio voor een volledige IDE-ervaring met visual designer-ondersteuning of dotnet nieuw om vanaf de opdrachtregel in elke editor te werken. Gebruik de onderstaande tabbladen om te schakelen tussen de twee benaderingen.

Visual Studio

Uw ontwikkelomgeving instellen

Als u WinUI 3-apps wilt ontwikkelen met Visual Studio, hebt u Visual Studio 2026 nodig met de vereiste workloads en de ontwikkelaarsmodus ingeschakeld.

Instellen met WinGet (aanbevolen)

Open Windows Terminal en voer de volgende opdracht uit in PowerShell om automatisch Visual Studio 2026 te installeren met de vereiste workloads en de ontwikkelaarsmodus in te schakelen met behulp van een WinGet-configuratiebestand:

winget configure -f https://aka.ms/winui-config

Zie de README op GitHub voor meer informatie over het configuratiebestand.

Note

Als WinGet niet beschikbaar is in uw omgeving, installeert u deze eerst:

Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers

Zie WinGet gebruiken voor meer informatie.

Handmatig instellen

Als u liever hulpprogramma's handmatig installeert:

1. Ontwikkelaarsmodus inschakelen: open Windows Instellingen, ga naar System > Advanced en schakel de ontwikkelaarsmodus in op Aan.

2. Download en installeer Visual Studio 2026. Zie Install Visual Studio voor meer informatie.

3. Selecteer in het Visual Studio Installer de winUI-toepassingsontwikkelingsworkload op het tabblad Workloads. Voor C++-ontwikkeling selecteert u ook C++ WinUI-hulpprogramma's voor app-ontwikkeling onder die workload in het deelvenster Installatiedetails.

   

Aanbeveling

Als u WinUI-sjablonen niet ziet nadat u Visual Studio hebt geïnstalleerd, opent u het Visual Studio Installer, selecteert u Modify en controleert u of de workload WinUI-toepassingsontwikkeling is ingeschakeld. Start Visual Studio opnieuw nadat u de installatie hebt gewijzigd.

Uw eerste WinUI 3-app maken en starten

1. Open Visual Studio 2026 en selecteer Een nieuw project maken.

2. Zoek naar WinUI, selecteer de WinUI Blank App (Packaged) C#-projectsjabloon en selecteer Volgende.

   

3. Voer een projectnaam in en selecteer Maken.

   

4. Druk op Start (F5) om uw app te bouwen en uit te voeren.

   

   Uw app bouwt, implementeert en start in de foutopsporingsmodus:

   

   U hebt uw eerste WinUI 3-app gebouwd en gestart. 🎉

Opdrachtregel

Vereiste voorwaarden

• Windows 10 versie 1809 (build 17763) of hoger
• Ontwikkelaarsmodus ingeschakeld (ms-settings:developers)
• .NET 10 SDK of hoger (controleer metdotnet --version)

Uw eerste WinUI 3-app maken en uitvoeren

1. Installeer de WinUI 3-projectsjablonen voor dotnet new (eenmaal uitvoeren):

   dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates
   

2. Maak een nieuw project en navigeer ernaartoe:

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. Bouw het project:

   dotnet build
   

4. De app uitvoeren:

   dotnet run
   

   De sjabloon bevatMicrosoft.Windows.SDK.BuildTools.WinApp, die wordt gekoppeld aan het .NET CLI-doel run om een foutopsporingsidentiteit te registreren en de app te starten met msiX-pakketidentiteit. Er is geen handmatige implementatiestap vereist.

   Er wordt een leeg app-venster geopend. U hebt uw eerste WinUI 3-app gebouwd en gestart. 🎉

Probleemoplossingsproces

Als u problemen ondervindt bij het bouwen of uitvoeren van uw eerste app, kunt u deze veelvoorkomende oplossingen proberen:

Probleem	Solution
WinUI-sjablonen worden niet weergegeven in Visual Studio	Open het Visual Studio-installatieprogramma, selecteer Wijzigen en controleer of de workload voor het ontwikkelen van WinUI-toepassingen is gecontroleerd. Start Visual Studio opnieuw nadat u de installatie hebt gewijzigd. Zie de tip in Uw ontwikkelomgeving instellen voor meer informatie.
Build mislukt met SDK-versiefouten	Open het Visual Studio Installer en selecteer Afzonderlijke onderdelen. Controleer of de Windows SDK-versie van uw projectdoelen is geïnstalleerd. Controleer in het projectbestand of deze TargetFramework overeenkomt met de geïnstalleerde SDK (bijvoorbeeld net10.0-windows10.0.26100.0).
NuGet-herstelfouten	Wis de lokale NuGet-cache en herstel opnieuw. Voer in een terminal de volgende opdracht uit: dotnet nuget locals all --clear vervolgens dotnet restore.
Fout 'Ontwikkelaarsmodus niet ingeschakeld'	Open Windows Settings >System > Advanced en schakel de ontwikkelaarsmodus in op Aan. Zie De ontwikkelaarsmodus inschakelen voor meer informatie.
Wijzigingen die niet worden herkend na de eerste SDK-installatie	Nadat u de Windows App SDK of Visual Studio workloads voor het eerst hebt geïnstalleerd of bijgewerkt, start u Visual Studio opnieuw op, zodat de nieuwe onderdelen worden opgehaald.

Aanbeveling

Als geen van de bovenstaande problemen uw probleem oplost, zoekt u de Windows App SDK GitHub problemen of vraagt u dit op Microsoft Q& A.

Volgende stappen

Uw eerste WinUI-app bouwen
Klaar om verder te gaan? Volg de stapsgewijze zelfstudie om een volledige WinUI-app te bouwen.

WinUI 3 Gallery
Bekijk interactieve voorbeelden van WinUI-besturingselementen, -functies en -functionaliteit.

Voorbeelden en hulpmiddelen
Blader door codevoorbeelden, startersprojecten en hulpprogramma's om uw ontwikkeling te versnellen.