Dela via

Migrera från UWP till Windows App SDK

Om du vill migrera din app från UWP (Universal Windows Platform ) till Windows App SDK behöver din användargränssnittskod förmodligen bara några namnområdesändringar, medan mycket av din plattformskod kan förbli densamma. Du måste justera viss kod på grund av skillnader mellan UWP-appar och skrivbordsappar. Men vi förväntar oss att migreringen för de flesta appar (beroende på kodbasens storlek, naturligtvis) kommer att ta några dagar snarare än veckor.

Anmärkning

Din befintliga UWP-app fortsätter att fungera som förväntat. Men för att dra nytta av moderna funktioner i WinUI 3 och Windows App SDK rekommenderar vi att du migrerar din app.

Nedan visas stegen på hög nivå för migrering manuellt. Men se följande avsnitt för information om hur du använder .NET Upgrade Assistant-verktyget).

  1. Skapa ett nytt WinUI 3-paketerat skrivbordsprojekt (se Skapa ditt första WinUI 3-projekt). Det kan gå in i projektets befintliga lösning.
  2. Kopiera XAML/UI-koden. I många fall kan du helt enkelt ändra namnområden (till exempel Windows.UI.* till Microsoft.UI.*).
  3. Kopiera din applikationslogik-kod. Vissa API:er behöver tweaks, till exempel Popup, Pickers och SecondaryTiles.

Fullständig information finns i avsnitten i tabellen nedan. De beskriver och visar hur du manuellt migrerar ditt UWP-program (Universal Windows Platform) till Windows App SDK.

Observera särskilt vad som stöds när du migrerar från UWP till WinUI 3, som beskriver alla funktioner som ännu inte stöds i WinUI 3 och Windows App SDK. Om din app behöver någon av dessa funktioner/bibliotek kanske du vill överväga att skjuta upp migreringen.

Anmärkning

Om UWP-appens källkod är skriven i C++/CX kan du även läsa Flytta till C++/WinRT från C++/CX.

Migrera med hjälp av .NET Upgrade Assistant-verktyget

Som ett ytterligare steg för att hjälpa dig att migrera dina UWP-appar till Windows App SDK och WinUI 3 har vi utnyttjat .NET Upgrade Assistant och lagt till stöd för migrering av C# UWP-appar. UWP-stödet automatiserar en stor del av migreringsprocessen. Mer information finns i avsnittet Migrera från UWP till Windows App SDK med .NET Upgrade Assistant.

Fördelar med containerinkapsning

När du övergår till Windows App SDK kan UWP-program förlora de inneboende containeriseringsfördelarna med sin ursprungliga plattform. Dessa fördelar kan dock återställas med win32-appisolering – en ny säkerhetsfunktion som förbättrar skyddet genom att isolera program i en sandbox-miljö. Den här metoden ger ytterligare säkerhet mot potentiella hot med minimala ändringar i din befintliga kod. Mer information och om du vill börja använda Win32-appisolering finns i Översikt över Win32-appisolering.

Ämnen i det här avsnittet

Ämne Beskrivning
Övergripande migreringsstrategi Överväganden och strategier för att närma sig migreringsprocessen och hur du konfigurerar utvecklingsmiljön för migrering.
Mappa UWP-funktioner till Windows App SDK I det här avsnittet jämförs viktiga funktionsområden i olika former där de visas i UWP och i Windows App SDK.
Vad stöds Lär dig vilka funktioner som för närvarande är tillgängliga i WinUI 3 Desktop för att utvärdera om du ska försöka migrera UWP-appen idag.
Mappa UWP-API:er och bibliotek till Windows App SDK Det här avsnittet innehåller en mappning av UWP-API:er och bibliotek till deras Motsvarigheter till Windows App SDK.
Funktionsområdesguider En samling migreringsvägledningsavsnitt som var och en fokuserar på ett specifikt funktionsområde.
Fallstudie 1 – PhotoLab (C#) Det här avsnittet är en fallstudie där du tar exempelappen C# UWP PhotoLaboch migrerar den till Windows App SDK.
Fallstudie 2 – Fotoredigerare (C++/WinRT) Det här avsnittet är en fallstudie där du tar exempelappen C++/WinRT UWP Photo Editor och migrerar den till Windows App SDK.
Ytterligare migreringsvägledning Det här avsnittet innehåller ytterligare migreringsvägledning som inte kategoriseras i ett funktionsområde i funktionsområdesguiderna.
Migrera från UWP till Windows App SDK med .NET Upgrade Assistant .NET Upgrade Assistant är ett kommandoradsverktyg som kan hjälpa dig att migrera en C# UWP-app till en WinUI 3-app som använder Windows App SDK.

Se även