Co je Pomocník pro upgrade .NET?
Pomocník pro upgrade platformy .NET pomáhá s upgradem projektů na novější verze .NET a analyzuje kód, který zjistí a opraví potenciální nekompatibilitu. Jedním z nástrojů je pomoct migrovat projekt z rozhraní .NET Framework, .NET Core nebo .NET na nejnovější verzi .NET. Rozšíření nebo nástroj použijete k upgradu celých projektů .NET nebo některého aspektu projektu, například migraci konfiguračního souboru ze staršího typu na novější typ.
Pomocník pro upgrade .NET se distribuuje jako rozšíření sady Visual Studio nebo nástroj rozhraní příkazového řádku (CLI).
Analýza a upgrade
Pomocník pro upgrade platformy .NET obsahuje analytický modul, který kontroluje vaše projekty a jejich závislosti. Po dokončení kontroly se vygeneruje sestava s podrobnými informacemi o provedení upgradu. Tyto informace můžete použít k upgradu celého projektu nebo konkrétních částí projektu.
Podporované typy projektů
Pomocník pro upgrade .NET podporuje upgrade projektů kódovaných v jazyce C# nebo Visual Basic. Podporují se následující typy projektů:
- ASP.NET
- Azure Functions
- Windows Presentation Foundation
- Windows Forms
- Knihovny tříd
- Aplikace konzoly
- Xamarin Forms
- .NET MAUI
- UpW nativní pro .NET
Některé produkty poskytují pokyny k používání pomocníka pro upgrade platformy .NET.
- ASP.NET
- Windows Presentation Foundation
- Windows Forms
- Univerzální platforma Windows
- Windows Communication Foundation
Cesty upgradu
Podporují se tyto možnosti upgradu:
- .NET Framework do .NET
- .NET Core do .NET
- Izolované řešení Azure Functions v1–v3 až v4 (cílení na net6.0+)
- UPW na WinUI 3
- Předchozí verze .NET na nejnovější verzi .NET
- Xamarin Forms do .NET MAUI
- Transformace souborů XAML podporují pouze upgrade oborů názvů. Pro komplexnější transformace použijte Visual Studio 2022 verze 17.6 nebo novější.
Podrobnosti a možnosti upgradu
Po spuštění upgradu vás průvodce provede konfigurací některých možností před zahájením upgradu. Na základě typu projektu, který upgradujete, zobrazí průvodce různé možnosti. Příklad upgradu projektu najdete v tématu Upgrade projektů pomocí pomocníka s upgradem platformy .NET.
Jak se má upgrade provést
Na základě typu projektu, který upgradujete, můžete změnit způsob provedení upgradu. Typ projektu ovlivňuje, které možnosti jsou k dispozici, a některé z následujících položek můžou chybět:
Místní upgrade projektu
Tato možnost upgraduje projekt bez vytvoření kopie.
Souběžný upgrade projektu
Zkopíruje projekt a upgraduje kopii a ponechá původní projekt sám.
Přírůstkové souběžné
To je dobrá volba pro složité webové aplikace. Upgrade z ASP.NET na ASP.NET Core vyžaduje poměrně hodně práce a občas ruční refaktoring. Tento režim umístí projekt .NET vedle existujícího projektu .NET Framework. Koncové body se směrují přes projekt .NET, zatímco všechna ostatní volání se posílají do aplikace .NET Framework.
Tento režim umožňuje pomalu upgradovat ASP.NET nebo knihovnu aplikace kus po kusu.
Výsledky upgradu
Po dokončení upgradu se zobrazí stavová obrazovka zobrazující všechny artefakty přidružené k upgradu. Každý artefakt upgradu je možné rozbalit a přečíst si další informace o stavu. Následující seznam popisuje ikony stavu:
- Nezaplněná zelená značka zaškrtnutí: Nástroj nenalezl nic o artefaktu, který se má upgradovat.
- Plná zelená značka zaškrtnutí: Artefakt byl upgradován a úspěšně dokončen.
- Žluté upozornění: Artefakt byl upgradován, ale měli byste zvážit důležité informace.
- Červený X: Upgrade artefaktu nebyl úspěšný.
Kromě toho se akce provedené během upgradu zaprotokolují do okna Výstup ve zdroji Pomocníka pro upgrade, jak je znázorněno na následujícím obrázku:
Po upgradu projektu ho důkladně otestujte!
