Migrace z UPW na Windows App SDK

Pokud chcete migrovat aplikaci z Universal Windows Platform (UPW) na Windows App SDK, kód uživatelského rozhraní pravděpodobně potřebuje jen několik změn oboru názvů, zatímco většina kódu platformy může zůstat stejná. Budete muset upravit nějaký kód kvůli rozdílům mezi aplikacemi pro UPW a desktopovými aplikacemi. Ale očekáváme, že u většiny aplikací (v závislosti na velikosti základu kódu samozřejmě) bude migrace trvat v řádu dnů, nikoli týdnů.

Poznámka:

Vaše stávající aplikace pro UPW bude dál fungovat podle očekávání. Pokud ale chcete využívat moderní funkce v WinUI 3 a Windows App SDK doporučujeme migrovat aplikaci.

Níže jsou uvedené kroky na vysoké úrovni pro ruční migraci. V následující části najdete informace o používání nástroje pomocníka pro upgrade .NET).

1. Vytvořte nový desktopový projekt s balíčkem WinUI (viz Vytvořte svůj první projekt WinUI). To by mohlo jít do stávajícího řešení projektu.
2. Zkopírujte kód XAML nebo uživatelského rozhraní. V mnoha případech můžete jednoduše změnit obory názvů (například Windows.UI.* na Microsoft.UI.*).
3. Zkopírujte kód logiky aplikace. Některá rozhraní API vyžadují úpravy, například vyskakovací dialogy, selektorya sekundární dlaždice.

Úplné podrobnosti najdete v následujících tématech. Popisují a ukazují, jak ručně migrovat aplikaci Universal Windows Platform (UPW) do Windows App SDK.

Poznamenejte si konkrétní informace o Co se podporuje při migraci z UPW na WinUI, která popisuje všechny funkce, které ještě nejsou ve WinUI a Windows App SDK podporované. Pokud vaše aplikace potřebuje některou z těchto funkcí nebo knihoven, možná budete chtít zvážit odložení migrace.

Poznámka:

Pokud je zdrojový kód vaší UWP aplikace napsán v jazyce C++/CX, podívejte se také na Přesunout do C++/WinRT z C++/CX.

Migrace pomocí nástroje .NET Upgrade Assistant

Jako další krok, který vám pomůže migrovat aplikace pro UPW na Windows App SDK a WinUI, jsme využili Pomocníka pro upgrade .NET a přidali jsme podporu pro migraci aplikací pro UPW v C#. Podpora UPW automatizuje většinu procesu migrace. Další informace najdete v tématu Migrace z UPW do Windows App SDK pomocí pomocníka pro upgrade .NET.

Výhody kontejnerizace

Při přechodu na Windows App SDK můžou aplikace UPW ztratit výhody vlastní kontejnerizace původní platformy. Tyto výhody se ale dají obnovit pomocí izolace aplikací Win32 – nové funkce zabezpečení, která vylepšuje ochranu izolováním aplikací v prostředí sandboxu. Tento přístup nabízí další zabezpečení proti potenciálním hrozbám s minimálními změnami stávajícího kódu. Další informace a zahájení používání izolace aplikací Win32 najdete v přehledu izolace aplikací Win32.

Témata v této části

Téma	Popis
celková strategie migrace	Důležité informace a strategie pro přístup k procesu migrace a nastavení vývojového prostředí pro migraci
Mapování funkcí UPW na Windows App SDK	Toto téma porovnává hlavní oblasti funkcí v různých formách, ve kterých se zobrazují v UPW a v Windows App SDK.
Co je podporováno	Zjistěte, jaké funkce jsou aktuálně dostupné ve WinUI Desktopu, abyste mohli vyhodnotit, jestli byste se měli pokusit migrovat aplikaci pro UPW ještě dnes.
Mapování rozhraní API a knihoven UWP s Windows App SDK	Toto téma obsahuje mapování rozhraní API a knihoven UPW na jejich Windows App SDK ekvivalenty.
Průvodci oblastmi funkcí	Sbírka témat s pokyny k migraci, z nichž každé se zaměřuje na konkrétní funkční oblast.
případová studie 1 – PhotoLab (C#)	Toto téma je případová studie o tom, jak vzít ukázkovou aplikaci PhotoLab pro C# UWP PhotoLab a migrovat ji do Windows App SDK.
případová studie 2 – Editor fotek (C++/WinRT)	Toto téma je případová studie o tom, jak vzít ukázkovou aplikaci C++/WinRT UWP Photo Editor a migrovat ji do Windows App SDK.
další pokyny k migraci	Toto téma obsahuje další pokyny k migraci, které nejsou zařazeny do oblasti funkcí v průvodcích oblastí funkcí.
Migrace z UPW do Windows App SDK pomocí pomocníka pro upgrade .NET	Pomocník pro upgrade .NET je nástroj příkazového řádku, který může pomoct s migrací aplikace pro UPW jazyka C# do aplikace WinUI, která používá Windows App SDK.

Viz také

• Windows App SDK a podporované verze Windows