Freigeben über

Migrieren von UWP zum Windows App SDK

  • Artikel

Um Ihre App von der Universelle Windows-Plattform (UWP) zum Windows App SDK zu migrieren, benötigt Ihr UI-Code wahrscheinlich nur einige Namespaceänderungen, während ein Großteil des Plattformcodes gleich bleiben kann. 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.

Hinweis

Wenn Sie mit der aktuellen Funktionalität der UWP-Plattform und Ihrer UWP-App zufrieden sind, müssen Sie Ihr Projekt nicht migrieren. WinUI 2 und das Windows SDK unterstützen weiterhin UWP-Projekttypen.

Im Folgenden finden Sie die Schritte auf hoher Ebene für die manuelle Migration. Weitere Informationen zur Verwendung des .NET-Upgrade-Assistenten finden Sie im folgenden Abschnitt.

  1. Erstellen Sie ein neues WinUI 3-Desktop-Projekt (siehe Erstellen Sie Ihr erstes WinUI 3-Projekt). Dies könnte in die vorhandene Projektlösung gehen.
  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, was alle Funktionen beschreibt, die in WinUI 3 und dem Windows App SDK noch nicht unterstützt werden. Wenn Ihre App eines dieser Features/Bibliotheken benötigt, sollten Sie eine Verschiebung der Migration in Betracht ziehen.

Hinweis

Wenn der Quellcode Ihrer UWP-App in C++/CX geschrieben ist, lesen Sie auch "Wechseln zu C++/WinRT aus C++/CX".

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.

Vorteile der Containerisierung

Beim Übergang zum Windows App SDK verlieren UWP-Anwendungen möglicherweise die inhärenten Containerisierungsvorteile ihrer ursprünglichen Plattform. Diese Vorteile können jedoch mithilfe der Win32-App-Isolation wiederhergestellt werden– ein neues Sicherheitsfeature, das den Schutz verbessert, indem Anwendungen in einer Sandkastenumgebung isoliert werden. Dieser Ansatz bietet zusätzliche Sicherheit vor potenziellen Bedrohungen mit minimalen Änderungen an Ihrem vorhandenen Code. Weitere Informationen und die Verwendung der Win32-App-Isolation finden Sie unter "Willkommen beim Win32-App-Isolationsrepo " auf GitHub.

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 WinUI 3-App unterstützen kann, die das Windows App SDK verwendet.

Weitere Informationen