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 váš kód a zjistí a opraví potenciální nekompatibilitu. Jedním z nástrojů je pomoct s upgradem projektu z rozhraní .NET Framework, .NET Core nebo .NET na nejnovější verzi .NET. Pomocník pro upgrade .NET slouží k upgradu celých projektů .NET nebo k určitému aspektu projektu, například k upgradu konfiguračního souboru ze staršího typu na novější typ.

Pomocník pro upgrade .NET je integrovaný do sady Visual Studio a dá se nainstalovat jako nástroj rozhraní příkazového řádku (CLI).

Důležité

Pomocník pro upgrade platformy .NET je oficiálně zastaralý. Místo toho použijte agenta pro chatování a modernizaci GitHub Copilotu, který je zahrnutý v sadách Visual Studio 2026 a Visual Studio 2022 verze 17.14.16 nebo novější. Tento agent analyzuje vaše projekty a závislosti, vytvoří podrobný plán migrace s cílenými doporučeními a automatizovanými opravami kódu a potvrdí každou změnu, abyste ji mohli ověřit nebo vrátit zpět. Automatizuje běžné úlohy přenosu – aktualizace souborů projektu, nahrazení zastaralých rozhraní API a řešení problémů se sestavením– abyste mohli rychleji modernizovat s menším ručním úsilím.

Analyzovat a upgradovat

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 tom, jak provést upgrade. 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
  • model Windows Forms
  • Knihovny tříd
  • Aplikace konzoly
  • Xamarin Forms
  • .NET MAUI
  • Nativní UWP pro .NET

Některé produkty poskytují pokyny k používání pomocníka pro upgrade platformy .NET.

Možnosti upgradu

Podporují se tyto možnosti upgradu:

  • přechod z .NET Framework na .NET
  • Přechod z .NET Core na .NET
  • Izolované řešení Azure Functions v1–v3 až v4 (cílení na net6.0+)
  • UWP na WinUI 3
  • Předchozí verze .NET na nejnovější verzi .NET
  • Xamarin Forms na .NET MAUI
    • Transformace souborů XAML podporují pouze aktualizaci názvových prostorů. Pokud chcete komplexnější transformace, použijte Visual Studio 2022 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. Jako příklad upgradu projektu se podívejte na Upgrade projektů pomocí .NET Upgrade Assistant.

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:

  • Upgrade projektu na místě

    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 aktualizace

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:

  • Prázdná zelená zaškrtávací značka: Nástroj nenalezl nic o artefaktu, který se má aktualizovat.
  • Vyplněná zelená fajfka: Artefakt byl vylepšen 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ý.

Karta výsledků upgradu Nástroje pro upgrade .NET v sadě Visual Studio

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:

Okno výstupu v sadě Visual Studio zobrazující výsledky pomocníka pro upgrade platformy .NET

Po upgradu projektu ho důkladně otestujte!

Související obsah

  • Last updated on