Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Erstellen Sie Ihre erste WinUI-App, und sehen Sie, dass sie auf Windows zum Leben kommt. Diese Schnellstartanleitung führt Sie von der Einrichtung des Tools zu einer funktionsfähigen App und führt Sie dann durch die erste Aktualisierung der Benutzeroberfläche.
Was Sie lernen werden
- Wählen Sie Ihre Entwicklungstools aus, und richten Sie sie ein.
- Erstellen Sie eine WinUI-App, und führen Sie sie aus.
- Aktualisieren Sie die Benutzeroberfläche, und sehen Sie ihre Änderung in der ausgeführten App.
Entwicklungstools auswählen
Befolgen Sie einen der empfohlenen Pfade in dieser Schnellstartanleitung:
- winapp CLI: Arbeiten Sie von einem Terminal aus in Ihrem bevorzugten Editor. Dieser Befehlszeilenworkflow eignet sich auch gut für agentengestütztes Programmieren.
- Visual Studio: Verwenden Sie eine integrierte Entwicklungs- und Debuggingumgebung.
Wenn Ihre Tools bereits installiert sind, rufen Sie Erstellen Ihrer ersten App auf.
Installieren der Tools
Aktivieren Sie den Entwicklermodus. Sie können die Einstellungen über Entwicklereinstellungen öffnen.
Installieren Sie das .NET 10 SDK und die Windows-App Development CLI. Wenn Sie WinGet verwenden, führen Sie Folgendes aus:
winget install --id Microsoft.DotNet.SDK.10 --exact --source winget winget install --id Microsoft.WinAppCli --exact --source wingetÜberspringen Sie die Installation, wenn das erforderliche Tool bereits installiert ist.
Öffnen Sie ein neues Terminal, damit es die installierten Befehle einnimmt, und überprüfen Sie dann die Versionen:
dotnet --version winapp --versionVerwenden Sie für diesen Workflow das .NET SDK 10 oder höher und die winapp CLI 0.6 oder höher.
Note
winapp CLI befindet sich in der öffentlichen Vorschauversion.
winapp newverwaltet die WinUI-Projektvorlagen, installiert jedoch nicht das .NET SDK. Lesen Sie die Ankündigung zu CLI 0.6 für die neuen Projekt- und Ausführungsbefehle.
Erstellen Sie Ihre erste App
Verwenden Sie den oben installierten Workflow, um das Projekt zu erstellen und zu starten.
Führen Sie in dem Ordner, in dem Sie Ihre Projekte speichern, Folgendes aus:
winapp new --name MyWinUIApp --template winui --use-defaults
cd MyWinUIApp
winapp run
winapp new erstellt die leere WinUI-App.
winapp run kompiliert das Projekt und startet es; Sie benötigen keinen separaten Build- oder Paketregistrierungsbefehl.
Informationen zum Auswählen einer anderen Startvorlage, Debuggen von Abstürzen, Automatisieren der Benutzeroberfläche oder Verpacken Ihrer App über die Befehlszeile finden Sie unter Verwenden der winapp CLI mit WinUI.
Ihre App öffnet ein Fenster auf dem Desktop. Fahren Sie unten mit Änderung vornehmen fort.
Änderung vornehmen
Behalten Sie das soeben erstellte Projekt bei. Fügen Sie der vorhandenen Schnittstelle eine Nachricht hinzu:
Schließen Sie die laufende App. Öffnen Sie
MainPage.xamlin Ihrem Editor. Wenn Ihre Vorlage diese Datei nicht enthält, öffnen Sie stattdessenMainWindow.xaml.Suchen Sie den Layoutbereich, der den Inhalt der App enthält. In der aktuellen leeren CLI-Vorlage enthält
<Grid />ein leeresMainPage.xaml. Ersetzen Sie dieses leere Raster durch Folgendes:<Grid> <TextBlock Text="Hello, WinUI!" HorizontalAlignment="Center" VerticalAlignment="Center" /> </Grid>Wenn das Panel bereits Steuerelemente enthält, fügen Sie nur das
TextBlockin diesem Panel hinzu. Behalten Sie die vorhandenen Steuerelemente, Namen und Ereignishandler bei. Ersetzen Sie nicht die umgebendePageoderWindowdie Rahmen- und Titelleiste inMainWindow.xaml.Speichern Sie die Datei. Führen Sie
winapp runerneut über den Projektordner aus oder drücken Sie F5 in Visual Studio.
Herzlichen Glückwunsch! Sie haben Ihre erste WinUI-App erstellt, ausgeführt und aktualisiert. Das Fenster zeigt jetzt Hello, WinUI!
Problembehandlung
| Problem | Was soll überprüft werden? |
|---|---|
winapp oder dotnet wird nicht erkannt. |
Öffnen Sie das Terminal nach der Installation erneut. Verwenden Sie die Versionsbefehle auf der CLI-Registerkarte, um zu bestätigen, dass beide Tools verfügbar sind. |
winapp new wird nicht erkannt. |
Für diesen Workflow ist winapp CLI 0.6 oder höher erforderlich. Aktualisieren Sie die CLI mithilfe der von Ihnen ausgewählten Installationsmethode. |
| WinUI-Vorlagen werden in Visual Studio nicht angezeigt. | Öffnen Sie den Visual Studio Installer, wählen Sie Ändern aus und vergewissern Sie sich, dass die WinUI-Anwendungsentwicklung installiert ist. Starten Sie danach Visual Studio neu. |
| Der Build meldet einen SDK- oder Wiederherstellungsfehler. | Überprüfen Sie die Voraussetzungen des ausgewählten Workflows und den ersten Fehler in der Build-Ausgabe. Verwenden Sie Unterstützung des Windows App SDK, um die Versionsanforderungen zu überprüfen, bevor Sie Projekteigenschaften ändern. |
| Bereitstellungsberichte, dass der Entwicklermodus deaktiviert ist. | Aktivieren Sie Entwicklermodus und führen Sie die App erneut aus. |
| Ihre neue Nachricht erscheint nicht. | Speichern Sie die XAML-Datei und starten Sie das Projekt neu. Fügen Sie in Vorlagen mit einer MainPage.xaml, die Nachricht zu dieser Seite hinzu, anstatt den Hostingframe des Fensters zu ersetzen. |
Teile deine App
Wenn Sie bereit sind, Ihre App anderen zur Verfügung zu stellen, wählen Sie aus, wie sie verteilt werden soll. Sie müssen nicht den Microsoft Store verwenden; es ist eine von mehreren Optionen:
-
Teilen Sie es direkt: Verteilen Sie ein MSIX-Paket, ein Installationsprogramm oder eine .zip Datei von Ihrer eigenen Website oder GitHub Releases. Sie können Ihre App auch mit
winget installinstallierbar machen. Sie übernehmen die Code-Signierung und -Updates. - Veröffentlichen über Microsoft Store: Erhalten Sie Auffindbarkeit im Store, eine vertrauenswürdige Installationserfahrung, kostenlose Signatur für MSIX-Pakete und automatische Updates.
Veröffentlichen Ihrer ersten Windows-App führt Sie durch beide Optionen, einschließlich Codesignatur, Verpacken und dessen, was Ihre ersten Benutzer sehen. Informationen zum Vergleichen aller Optionen nebeneinander finden Sie unter Verteilungspfad auswählen.
Nächste Schritte
Das Lernprogramm „Notizen“ verwendet ein separates WinUINotes Projekt, um Seiten, Navigation, Datenbindung und lokalen Speicher zu unterrichten.
Wenn Sie über das Terminal arbeiten, deckt Verwenden der winapp-CLI mit WinUI den gesamten Befehlszeilenworkflow ab: Vorlagen, dotnet run, Debuggen, Benutzeroberflächenautomatisierung, Tests und Paketerstellung.
Sie finden auch gezielte Beispiele für Steuerelemente in Codebeispielen und der WinUI-Galerie.
Wenn Sie bereit sind, damit andere Ihre App verwenden können, zeigt Veröffentlichen Ihrer ersten Windows-App, wie Sie sie direkt oder über den Microsoft Store freigeben können.
Windows developer