Schnellstart: Erstellen Ihrer ersten WinUI 3-App

Einrichten Ihrer Entwicklungsumgebung

Um WinUI 3-Apps mit Visual Studio zu entwickeln, benötigen Sie Visual Studio 2026, wobei die erforderlichen Workloads und der Entwicklermodus aktiviert sind.

Einrichten mit WinGet (empfohlen)

Öffnen Sie Windows-Terminal, und führen Sie den folgenden Befehl in PowerShell aus, um Visual Studio 2026 automatisch mit den erforderlichen Workloads zu installieren und den Entwicklermodus mithilfe einer WinGet-Konfigurationsdatei zu aktivieren:

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

Wenn Sie die Konfigurationsdatei überprüfen und mehr erfahren möchten, lesen Sie README auf GitHub.

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

Manuelles Einrichten

Wenn Sie Tools lieber manuell installieren möchten:

1. Entwicklermodus aktivieren: Öffnen Sie Windows Einstellungen, navigieren Sie zum Erweiterten System>, und schalten Sie den Entwicklermodus auf "Ein" um.

2. Laden Sie Visual Studio 2026 herunter, und installieren Sie es. Ausführliche Informationen finden Sie unter Install Visual Studio.

3. Wählen Sie im Visual Studio Installer die WinUI-Anwendungsentwicklungsauslastung auf der Registerkarte "Workloads" aus. Wählen Sie für die C++-Entwicklung auch C++-WinUI-App-Entwicklungstools unter dieser Workload im Detailbereich "Installation" aus.

   

Erstellen und Starten Ihrer ersten WinUI 3-App

1. Öffnen Sie Visual Studio 2026, und wählen Sie "Neues Projekt erstellen" aus.

2. Suchen Sie nach WinUI, wählen Sie die C#-Projektvorlage WinUI Blank App (Verpackt) aus, und wählen Sie Weiter aus.

   

3. Geben Sie einen Projektnamen ein, und wählen Sie "Erstellen" aus.

   

4. Drücken Sie start (F5), um Ihre App zu erstellen und auszuführen.

   

   Ihre App wird erstellt, bereitgestellt und im Debugmodus gestartet.

   

   Sie haben Ihre erste WinUI 3-App erstellt und gestartet! 🎉

Voraussetzungen

• Windows 10 Version 1809 (Build 17763) oder höher
• Entwicklermodus aktiviert (ms-settings:developers)
• .NET 10 SDK oder höher (Überprüfen mit dotnet --version)

Erstellen und Ausführen Ihrer ersten WinUI 3-App

1. Installieren Sie die WinUI 3-Projektvorlagen für dotnet new (einmal ausführen):

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

2. Erstellen Sie ein neues Projekt, und navigieren Sie zu diesem Projekt:

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. Erstellen Sie das Projekt:

   dotnet build
   

4. Führen Sie die App aus:

   dotnet run
   

   Die Vorlage enthält Microsoft.Windows.SDK.BuildTools.WinApp, das in das .NET CLI-Ziel run eingebunden ist, um eine Debug-Identität zu registrieren und die App mit MSIX-Paketidentität zu starten — ein manueller Bereitstellungsschritt ist nicht erforderlich.

   Ein leeres App-Fenster wird geöffnet. Sie haben Ihre erste WinUI 3-App erstellt und gestartet! 🎉