A .NET frissítési segéd áttekintése

A .NET új verziói az év során jelennek meg, és évente egyszer jelentek meg nagyobb kiadások. A .NET Frissítési segéd segítségével frissítheti az alkalmazásokat a .NET, a .NET Core korábbi verzióiról, és .NET-keretrendszer a legújabb verzióra.

A .NET frissítési segéd egy Visual Studio-bővítmény és parancssori eszköz, amely az alkalmazások .NET legújabb verziójára való frissítéséhez használható.

A .NET frissítési asszisztenssel kapcsolatos problémákat a Visual Studióban a Visszajelzés> küldése probléma küldése súgó kiválasztásával>adhatja meg.

A Frissítési segéd telepítése

A .NET frissítési segéd telepíthető Visual Studio-bővítményként vagy .NET parancssori eszközként. További információ: A .NET frissítési segéd telepítése.

Támogatott nyelvek

A következő kódnyelvek támogatottak:

• C#
• Visual Basic

Támogatott projektek

A következő típusú projektek támogatottak:

• ASP.NET
• Azure Functions
• Windows Presentation Foundation
• Windows Forms
• Osztálykódtárak
• Konzolalkalmazások
• .NET natív UWP
• Xamarin Forms
• .NET MAUI

Elérési utak frissítése

Az alábbi verziófrissítési útvonalak támogatottak:

• .NET-keretrendszer a .NET-be
• .NET Core–.NET
• UWP–WinUI 3
• Előző .NET-verzió a legújabb .NET-verzióra
• Azure Functions v1-v3–v4 izolált
• Xamarin Forms to .NET MAUI
  • Az XAML-fájlátalakítások csak a névterek frissítését támogatják. Átfogóbb átalakításokhoz használja a Visual Studio 2022 17.6-os vagy újabb verzióját.

Frissítés a Visual Studio bővítménnyel

Miután telepítette a .NET Upgrade Assistant bővítményt, kattintson a jobb gombbal a projektre a Megoldáskezelő ablakban, és válassza a Frissítés lehetőséget.

Figyelemfelhívás

Győződjön meg arról, hogy a frissítések előtt biztonsági másolatot készít a projektekről, ha nem használ forrásvezérlőt.

Megnyílik egy lap, amely a projekt típusa alapján különböző frissítési stílusokat biztosít:

• Helyszíni projektfrissítés

  Ez a beállítás másolás nélkül frissíti a projektet.

• Projektfrissítés egymás mellett

  Másolja át a projektet, és frissítse a másolatot, és hagyja egyedül az eredeti projektet.

• Egymás melletti növekményes

  Jó választás bonyolult webalkalmazásokhoz. A ASP.NET-ról ASP.NET Core-ra való frissítéshez elég sok munka és időnként manuális újrabontás szükséges. Ez a mód egy .NET-projektet helyez a meglévő .NET-keretrendszer projekt mellé, és átirányítja a .NET-projektben implementált végpontokat, míg az összes többi hívást .NET-keretrendszer alkalmazásba küldi.

  Ez a mód lehetővé teszi a ASP.NET vagy a Kódtár alkalmazás darabonkénti frissítését.

Az alkalmazás frissítése után megjelenik egy állapotképernyő, amely megjeleníti a projekthez kapcsolódó összes összetevőt, amely a frissítéshez volt társítva. Minden frissítési összetevő kibontható az állapotra vonatkozó további információkért. Az alábbi lista az állapotikonokat ismerteti:

• Kitöltött zöld pipa: Az összetevőt frissítették és sikeresen befejezték.
• Nem kitöltött zöld pipa: Az eszköz nem talált semmit a frissíteni kívánt összetevőről.
• Sárga figyelmeztető jel: Az összetevő frissítve lett, de fontos információkat érdemes figyelembe vennie.
• Red X: Az összetevőt frissíteni kellett, de a frissítés nem sikerült.

Emellett a Frissítési segéd által végrehajtott műveletek naplózva lesznek a Frissítési segéd forrásának Kimeneti ablakában, ahogyan az az alábbi képen látható:

A projekt frissítése után alaposan tesztelnie kell.

Frissítés a parancssori felület eszközzel

A .NET Frissítési segéd parancssori felületének telepítése után nyisson meg egy terminálablakot, és keresse meg a frissíteni kívánt projektet tartalmazó könyvtárat. A parancs használatával upgrade-assistant --help megtekintheti a parancssori felület által elérhető lehetőségeket.

Figyelemfelhívás

Győződjön meg arról, hogy a frissítések előtt biztonsági másolatot készít a projektekről, ha nem használ forrásvezérlőt.

Futtassa az eszközt a upgrade-assistant upgrade paranccsal, és az aktuális mappából származó összes projekt megjelenik a listában. A CLI-eszköz interaktív módon választja ki a frissíteni kívánt projektet. A nyílbillentyűkkel jelöljön ki egy elemet, majd nyomja le az Enter billentyűt az elem futtatásához. Válassza ki a frissíteni kívánt projektet. A cikk által biztosított példában négy projekt található az aktuális mappában:

 Selected options
───────────────────────────────────────────────────────────
 No options specified, follow steps below to continue

 Steps
─────────────────
 Source project
─────────────────

Which project do you want to upgrade (found 9)?

> MatchingGame (winforms\MatchingGame\MatchingGame.csproj)
  MatchingGame.Logic (winforms\MatchingGame.Logic\MatchingGame.Logic.csproj)
  StarVoteControl (csharp\StarVoteControl\StarVoteControl.csproj)
  WebSiteRatings (csharp\WebSiteRatings\WebSiteRatings.csproj)

  Navigation
    Exit

A frissítési projekttől függően előfordulhat, hogy megjelenik egy lehetőség, amellyel megadhatja, hogyan történjen a frissítés:

• Helyszíni projektfrissítés

  Ez a beállítás másolás nélkül frissíti a projektet.

• Projektfrissítés egymás mellett

  Ez a beállítás csak .NET-keretrendszer projektekhez érhető el. Másolja át a projektet, és frissítse a másolatot, és hagyja egyedül az eredeti projektet.

 Selected options
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
 Source project     C:\Code\winforms\MatchingGame\MatchingGame.csproj

 Steps
───────────────────────────────
 Source project / Upgrade type
───────────────────────────────

How do you want to upgrade project MatchingGame?

> In-place project upgrade
  Side-by-side project upgrade

  Navigation
    Back
    Exit

A lépés után, ha több továbbminősíthető cél keretrendszer is létezik, a következő célokat fogja kiválasztani:

 Selected options
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
 Source project     C:\Code\Work\dotnet\dotnet-docs\docs\core\porting\snippets\upgrade-assistant-wpf-framework\winforms\MatchingGame\MatchingGame.csproj
 Ugrade type        Inplace

 Steps
──────────────────────────────────────────────────
 Source project / Ugrade type / Target framework
──────────────────────────────────────────────────

What is your preferred target framework?

> .NET 6.0 (Supported until November, 2024)
  .NET 7.0 (Supported until May, 2024)
  .NET 8.0 (Try latest preview features)

  Navigation
    Back
    Exit

A projekt frissítése után alaposan tesztelnie kell.