Freigeben über

Migrieren von UWP zum Windows App SDK

Um Ihre App von der Universelle Windows-Plattform (UWP) auf die 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

Ihre vorhandene UWP-App funktioniert weiterhin wie erwartet. Um jedoch moderne Features in WinUI 3 und dem Windows App SDK empfehlen wir, Ihre App zu migrieren.

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

  1. Erstellen Sie ein neues WinUI-verpacktes Desktop-Projekt (siehe Erstellen Sie Ihr erstes WinUI-Projekt). Dies könnte in die vorhandene Lösung Ihres Projekts integriert werden.
  2. Kopieren Sie Ihren XAML-/Benutzeroberflächencode. In vielen Fällen können Sie einfach Namespaces ändern (z. B. Windows. UI.* zum 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 unten stehenden Tabelle. Sie beschreiben und veranschaulichen, wie Sie Ihre Universelle Windows-Plattform (UWP) Anwendung manuell zum Windows App SDK migrieren.

Beachten Sie insbesondere Was unterstützt wird beim Migrieren von UWP zu WinUI, die jede Funktionalität beschreibt, die in WinUI und dem Windows App SDK noch nicht unterstützt wird. 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 Tools .NET Upgrade-Assistent

Als weiterer Schritt bei der Migration Ihrer UWP-Apps zu den Windows App SDK und WinUI 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 Migrate 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 in der Übersicht über die Win32-App-Isolation.

Themen in diesem Abschnitt

Thema Beschreibung
Allgemeine Migrationsstrategie Überlegungen und Strategien zum Herangehen des Migrationsprozesses und zum Einrichten Ihrer Entwicklungsumgebung für die Migration.
Zuordnung 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 Desktop verfügbar sind, um zu bewerten, ob Sie versuchen sollten, Ihre UWP-App heute zu migrieren.
Zuordnung 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.
Funktionsbereich-Anleitungen Eine Sammlung von Themen zur Migrationsanleitung, die sich jeweils auf einen bestimmten Featurebereich konzentrieren.
Fallstudie 1 – PhotoLab (C#) Dieses Thema ist eine Fallstudie zur Aufnahme der C#-UWP PhotoLab-Beispiel-App und ihrer Migration zum Windows App SDK.
Fallstudie 2 – Foto-Editor (C++/WinRT) In diesem Thema wird eine Fallstudie zur Aufnahme der C++/WinRT UWP Foto-Editor-Beispiel-App und deren Migration zum Windows App SDK vorgestellt.
Zusätzliche Migrationsleitfäden Dieses Thema enthält zusätzliche Migrationsrichtlinien, die nicht in einem der Featurebereiche in den Featurebereich-Leitfäden kategorisiert sind.
Migrate von UWP zum Windows App SDK mit dem .NET Upgrade-Assistenten Der .NET Upgrade-Assistent ist ein Befehlszeilentool, mit dem Sie eine C#-UWP-App zu einer WinUI-App migrieren können, die die Windows App SDK verwendet.
Verwenden von KI zum Modernisieren Ihrer App Verwenden von GitHub Copilot zum Beschleunigen der Modernisierung einer vorhandenen Desktop-App zum Windows App SDK und WinUI 3.

Siehe auch

  • Last updated on