Erste Schritte mit WinUI

WinUI 3 ist das systemeigene Benutzeroberflächenframework zum Erstellen Windows Desktop-Apps. Sie ist Teil der Windows App SDK – eine Reihe von APIs und Tools, die vom Windows Betriebssystem selbst getrennt sind und auf dem Zielcomputer installiert oder zusammen mit Ihrer App verpackt werden müssen. WinUI 3 unterstützt sowohl C# als auch C++ und ist kein plattformübergreifendes oder webbasiertes Framework.

Minesweeper auf Windows 3.1 neben einer Version, die mit Hilfe von GitHub Copilot auf Windows 11 ausgeführt wird.

Important

WinUI 3 unterscheidet sich von UWP. WinUI 3 verwendet den Microsoft.UI.Xaml Namespace und wird als Desktopprozess ausgeführt; UWP verwendet Windows.UI.Xaml und wird in einem App-Container ausgeführt. WinUI 3 unterstützt paketierte Bereitstellung (MSIX), paketierte Bereitstellung mit externem Speicherort und nicht paketierte Bereitstellung – die richtige Wahl hängt von Ihrem Bereitstellungsszenario ab. Hinweise finden Sie unter Eine Vertriebsmethode auswählen.

Wählen Sie Ihren Pfad aus.

Es gibt zwei unterstützte Pfade zum Erstellen eines WinUI 3-Projekts.

Visual Studio Befehlszeile
Optimal für Entwickler, die neu in der Windows-Entwicklung sind, visuelle UI-Designer oder alle, die eine vollwertige IDE möchten Entwickler sind mit dem Terminal, der CI/CD-Pipelines oder der Skriptumgebung vertraut.
Werkzeuge Visual Studio 2026 mit installierten Windows App SDK- und WinUI-Workloads .NET 10 SDK mit dotnet new WinUI-Vorlagen
Projekterstellung Neuer Projekt-Assistent — wählen Sie die Vorlage Leere App, paketiert (WinUI 3 für Desktop) aus. dotnet new winui -n MyApp
Erstellen und Ausführen Drücken Sie F5 – Visual Studio erstellt, signiert und bereitstellt das MSIX-Paket und startet die App. dotnet run – Erstellt und startet die App mit Paketidentität (erfordert den Entwicklermodus)
Debuggen Vollständiger Visual Studio Debugger mit XAML-Livevorschau Debugger manuell anfügen oder die generierte .sln in Visual Studio öffnen

Beide Pfade erzeugen gleichwertige WinUI 3-Projekte. Der Visual-Studio-Weg übernimmt die MSIX-Signierung und -Bereitstellung automatisch. Für die lokale Entwicklung wird im Befehlszeilenpfad dotnet run verwendet (das enthaltene Microsoft.Windows.SDK.BuildTools.WinApp-Paket übernimmt die Debug-Identität automatisch); für die Verteilung sind bei der Paketierung zusätzliche Schritte erforderlich.

Voraussetzungen

Beide Pfade teilen die gleichen Mindestanforderungen.

  • Windows 10 Version 1809 (Build 17763) oder höher – Windows 11 wird empfohlen.
  • Entwicklermodus auf Ihrem Gerät aktiviert (ms-settings:developers)
  • Visual Studio 2026 (Visual Studio Pfad) oder .NET 10 SDK (Befehlszeilenpfad)

Die Windows App SDK ist eine separate Installation von Windows. Visual Studio installiert sie als Teil des Workload-Setups. Bei Verwendung der Befehlszeile fügen die Vorlagen dotnet new winui automatisch die erforderlichen NuGet-Pakete hinzu.

Nächste Schritte

Schnellstart: Visual Studio

Schnellstart: Befehlszeile

  • Last updated on