WinUI

Vorbereiten der Entwicklung mit WinUI 3

Diese Seite wurde aktualisiert :
Erstellungsdatum der Seite :

Betriebsumgebung

Fenster
  • Mit Windows 11
Visuelles Studio
  • Visual Studio 2022 Version 17.9.3
.NETTO
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
SDK für Windows-Apps
  • 1.4.230913002

Voraussetzungen

In einigen Fällen können auch niedrigere Versionen funktionieren.

Fenster
  • Fenster 10
  • Mit Windows 11
Visuelles Studio
  • Visual Studio 2022 Version 17.9.3 oder höher
.NETTO
  • .NET 6
  • (.NET 8)
SDK für Windows-Apps
  • 1.4.230913002 oder höher

Installieren von Visual Studio und Einrichten von WinUI

WinUI 3-Entwicklungsprojekte können mit der Visual Studio-Installation hinzugefügt werden. In diesem Abschnitt finden Sie eine vereinfachte Beschreibung des Visual Studio-Installationsprozesses. Eine detaillierte Anleitung finden Sie in den folgenden Tipps.

Starten Sie das Visual Studio 2022-Installationsprogramm aus dem Internet oder über Medien. Es unterstützt Community-, Professional- oder höhere Editionen.

Wählen Sie in der Systemlastauswahl aus. NET Desktop-Entwicklung.

「. NET Desktop-Entwicklung, und überprüfen Sie Windows App SDK C#-Vorlagen in den Installationsdetails auf der rechten Seite.

Starten Sie nun einfach die Installation. Es gibt noch andere Bildschirme, aber ich werde sie erst erklären, wenn sie ein Projekt erstellen.

Sobald die Installation abgeschlossen ist, erstellen Sie ein neues Projekt.

Oben winui rechts befindet sich im Suchelement ein Exemplar, so dass beim Auswählen die WinUI 3-Projektvorlage angezeigt wird, wählen Sie also eine beliebige Vorlage aus und erstellen Sie ein Projekt.

Sie können jetzt Anwendungen mit WinUI 3 entwickeln.

Wenn die Meldung "Ausrichtung auf eine nicht installierte .NET-Version" angezeigt wird

Ab Visual Studio 2022 ist 17.9.1 .NET für WinUI 3 auf .NET 6 ausgerichtet. Wenn Sie keine zusätzlichen Runtimes in Visual Studio 2022 auswählen, wird nur die .NET 8-Runtime installiert, und möglicherweise wird eine Warnung wie die folgende angezeigt.

Wenn Sie Bedenken haben, können Sie die .NET 6-Runtime installieren oder die Warnung einfach verwerfen. Sie müssen die .NET 6-Runtime zum Debuggen nicht installieren.

Wenn Sie später eine WinUI 3-Entwicklungsumgebung hinzufügen möchten

Wenn Sie Visual Studio zuerst installieren, können Sie später eine WinUI 3-Entwicklungsumgebung hinzufügen.

Starten Sie Visual Studio, und wählen Sie im Menü Extras > Abrufen von Tools und Features aus.

Es wird derselbe Bildschirm angezeigt, auf dem Sie Visual Studio installiert haben, sodass Sie die . Stellen Sie sicher, dass ".NET Desktop Development" aktiviert ist, und aktivieren Sie "Windows App SDK C# Template" unter "Installationsdetails" auf der rechten Seite.

Aktivieren des Entwicklermodus

WinUI-Anwendungen werden im Gegensatz zu anderen Desktopanwendungen in einer Umgebung mit erhöhter Sicherheit ausgeführt. Daher kann es nicht so ausgeführt werden, wie es ist. Wenn Sie versuchen, es auszuführen, sehen Sie ein Dialogfeld wie das folgende und Sie werden aufgefordert, den "Entwicklermodus" zu aktivieren. Wenn Sie auf den Link klicken, wird der Einstellungsbildschirm angezeigt, aktivieren Sie also bitte den "Entwicklermodus".

Auch wenn Sie Visual Studio nicht verwenden, können Sie den "Entwicklermodus" auch über den Einstellungsbildschirm aktivieren oder deaktivieren. Wählen Sie "Einstellungen" aus dem Startmenü.

Wählen Sie im Menü System die Option Für Entwickler aus.

Es gibt einen Schalter für "Für Entwickler", also stellen Sie ihn auf "Ein". Es wird eine Notiz angezeigt, also wählen Sie "Ja", um sie zu aktivieren.

Wenn Sie zu .NET 8 wechseln möchten

Wenn Sie ein Projekt mit dieser Vorlage erstellen, wird standardmäßig .NET 6 verwendet. Auch wenn ich das Zielframework über die Projekteigenschaften in .NET 8 ändere, zeigt der Build weiterhin Fehler und Warnungen an. Um den 13.03.2024 wird das Windows App SDK jedoch aktualisiert, um .NET 8 offiziell zu unterstützen.

Die Vorlage befindet sich jedoch weiterhin in .NET 6, sodass Sie nach dem Erstellen des Projekts an .NET 8 arbeiten müssen. Es besteht die Möglichkeit, dass es in zukünftigen Versionsupgrades unterstützt wird.

Erstellen Sie zunächst ein Projekt, und verwenden Sie dann NuGet, um die Windows App SDK-bezogenen Versionen zu aktualisieren.

Sofern nicht anders, ist alles auf dem neuesten Stand. Microsoft.WindowsAppSDK muss mindestens 1.5.XXXX sein.

Ändern Sie das Zielframework in den Projekteigenschaften in .NET 8.

Auch wenn Sie in diesem Zustand erstellen, wird ein Fehler angezeigt, da die Projekteinstellungen veraltet sind.

Öffnen Sie die Projektdatei als Code.

RuntimeIdentifiersDa es einen Parameter gibt, entfernen Sie das Zeichen von 10 wie folgt Win10 .

Vor der Änderung

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

Nach dem Fix

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

Außerdem werden die Veröffentlichungseinstellungen des Programms neu geschrieben. Öffnen Sie jede .pubxml Datei im Ordner Eigenschaften > PublishProfiles.

RuntimeIdentifier Entfernen Sie auf ähnliche Weise das Zeichen von 10 im Win10 Parameter von .

Erstellen Sie danach neu, und stellen Sie sicher, dass keine Fehler oder Warnungen vorhanden sind. .pubxml (Es wird eine Warnung in der Datei angezeigt, aber Sie müssen sich keine Sorgen machen, da es sich um eine andere Syntax als dieses Problem handelt.) )

Aus irgendeinem Grund gibt die WinUI-Klassenbibliothek jedoch weiterhin eine Warnung aus, auch wenn Sie das Gleiche wie oben tun. Im Moment können Sie es ausführen, also warten wir, bis dies behoben ist.