Informationen zur Migration von UWP zum Windows App SDK

  • Artikel

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 Desktop-Apps und UWP-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. Im Überblick sind dies die Schritte:

  1. Erstellen Ihres ersten gepacktes WinUI 3-Desktop-Projekts. 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.

Hinweis

Wenn Ihr UWP-Quellcode in der inzwischen ersetzten Programmiersprache C++/CX geschrieben wurde, ist eine Quellcodeportierung erforderlich. Weitere Informationen finden Sie unter Umstellen von C++/CX auf C++/WinRT.

Vollständige Details finden Sie unter Migrieren von UWP zum Windows App SDK. In dieser Migrationsdokumentation wird beschrieben, wie man über alle Unterschiede hinweg migriert.

Beachten Sie innerhalb dieses Inhalts 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.