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. 🎉

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.