Migrieren von UWP zum Windows App SDK

Wenn Sie mit Ihrer aktuellen Funktionalität in der Universellen Windows-Plattform (UWP) zufrieden sind, gibt es keine Notwendigkeit für eine Migration Ihres Projekttyps. WinUI 2.x und das Windows SDK unterstützen UWP-Projekttypen.

Wenn Sie sich jedoch entschieden haben, Ihre App von UWP zum Windows App SDK zu migrieren, benötigt Ihr Benutzeroberflächencode in den meisten Fällen nur ein paar Namespaceänderungen. Der Großteil Ihres Plattformcodes kann unverändert bleiben. Sie müssen etwas Code aufgrund von Unterschieden zwischen UWP-Apps und Desktop-Apps anpassen. Wir erwarten jedoch, dass sich für die meisten Apps (natürlich abhängig von der Größe der Codebasis) die Migration eher in der Größenordnung von Tagen, nicht Wochen bewegen wird.

Dies sind die wichtigsten Schritte für eine manuelle Migration (aber im nächsten Abschnitt finden Sie Informationen zur Verwendung des .NET-Upgrade-Assistenten-Tools):

1. Erstellen Sie ein neues WinUI 3-Desktop-Projekt (siehe Erstellen Sie Ihr erstes WinUI 3-Projekt). Dieses könnte in Ihre vorhandene Lösung einfließen.
2. Kopieren Sie Ihren XAML-/Benutzeroberflächencode. In vielen Fällen können Sie Namespaces einfach ändern (z. B. Windows.UI.* in Microsoft.UI.*).
3. Kopieren Sie den Logikcode Ihrer App. Einige APIs benötigen Anpassungen, z. B. Popup, Picker und SecondaryTiles.

Ausführliche Informationen finden Sie in der folgenden Tabelle. Sie beschreiben und veranschaulichen, wie Sie Ihre Universelle Windows-Plattform -Anwendung (UWP) manuell zum Windows App SDK migrieren.

Beachten Sie insbesondere, was beim Migrieren von UWP zu WinUI 3 unterstützt wird. In diesem Thema werden alle Funktionen beschrieben, die in WinUI 3 und dem Windows App SDK noch nicht unterstützt werden. Wenn Ihre App eine dieser Funktionen/Bibliotheken benötigt, sollten Sie erwägen, die Migration zu verschieben.

Migrieren mithilfe des .NET-Upgrade-Assistenten-Tools

Als weiterer Schritt bei der Migration Ihrer UWP-Apps zum Windows App SDK und WinUI 3 haben wir den .NET-Upgrade-Assistenten genutzt und Unterstützung für die Migration von C#-UWP-Apps hinzugefügt. Die UWP-Unterstützung automatisiert einen Großteil des Migrationsprozesses. Weitere Informationen finden Sie im Thema Migrieren von UWP zum Windows App SDK mit dem .NET-Upgrade-Assistenten.

Themen in diesem Abschnitt

Thema	Beschreibung
Allgemeine Migrationsstrategie	Überlegungen und Strategien zum Herangehen des Migrationsprozesses und zum Einrichten Ihrer Entwicklungsumgebung für die Migration.
Zuordnen von UWP-Features zum Windows App SDK	In diesem Thema werden wichtige Featurebereiche in den verschiedenen Formen verglichen, in denen sie in UWP und im Windows App SDK angezeigt werden.
Was wird unterstützt?	Erfahren Sie, welche Features derzeit in WinUI 3 Desktop verfügbar sind, um zu bewerten, ob Sie versuchen sollten, Ihre UWP-App heute zu migrieren.
Zuordnen von UWP-APIs und Bibliotheken zum Windows App SDK	Dieses Thema enthält eine Zuordnung von UWP-APIs und -Bibliotheken zu ihren Windows App SDK-Entsprechungen.
Funktionsbereichshandbücher	Eine Sammlung von Themen zur Migrationsanleitung, die sich jeweils auf einen bestimmten Featurebereich konzentrieren.
Fallstudie 1 – PhotoLab (C#)	Dieses Thema ist eine Fallstudie über die C# UWP PhotoLab-Beispiel-App, die auf das Windows App SDK migriert wird.
Fallstudie 2 – Foto-Editor (C++/WinRT)	Dieses Thema ist eine Fallstudie über die C++/WinRT UWP PhotoLab-Beispiel-App, die auf das Windows App SDK migriert wird.
Zusätzliche Migrationsleitfäden	Dieses Thema enthält zusätzliche Migrationsleitfäden, die nicht in einen Featurebereich in den Featurebereichsanleitungen kategorisiert sind.
Migrieren von UWP zum Windows App SDK mit dem .NET-Upgrade-Assistenten	Der .NET-Upgrade-Assistent ist ein Befehlszeilentool, das Sie bei der Migration einer C#-UWP-App zu einer Windows-UI-Bibliothek (WinUI) 3-App unterstützen kann, die das Windows App SDK verwendet.