Shulou(Shulou.com)06/01 Report--

This article focuses on "how to upgrade a .NET Framework project to .NET 6". Interested friends may wish to have a look at it. The method introduced in this paper is simple, fast and practical. Let's let the editor take you to learn how to upgrade a .NET Framework project to .NET 6.

Overview

Upgrade conditions:

Windows operating system

.NET 6 SDK

Visual Studio 2022 or later

Environmental preparation

① is the first VS2022 download, directly to the official Microsoft website, download address:

Https://visualstudio.microsoft.com/zh-hans/downloads/

After downloading, you can install it online. If you have other versions of vs before, you do not need to uninstall them. Multiple versions of VS can coexist. When installing, the runtime of .NET 6 will check installation by default.

If ② needs to download SDK and runtime separately, you can go to Microsoft's official website at:

.net SDKs downloads for Visual Studio (microsoft.com)

After ③ is installed, you can confirm that .NET 6 is installed properly in the window command window. You can enter:

After the vs installation is complete, you should be able to see the .NET 6 framework when you create a new project.

.net Portability Analyzer installation and use

Before upgrading, it is best to analyze whether the class library your project depends on supports the latest .NET platform, which can be done by using the extension tool .NET Portability Analyzer (only .NET 5 and below are supported):

After the extension tool download and installation is complete, restart VS. From the right-click menu of the project or solution, select: Portability Analyzer Settings. On the configuration page, select the. net version you want to analyze.

After the setup is complete, in the VS project or solution right-click menu, select: Analyze Assembly Portability, and the result will appear in a moment. The second Sheet page details the unsupported API information.

Upgrade Assistant introduction and installation

Our previous applications run on the .NET Framework, and now we want to port them to .NET 6. Of course you can choose to migrate manually, but a more convenient way is to use the upgrade assistant provided by Microsoft to do this.

The first step is to upgrade the helper installation, which is simple and executed in the command window:

Dotnet tool install-g upgrade-assistant

After the installation is successful, it should look like the following figure:

Similarly, because the .NET upgrade Assistant is installed as a .NET tool, you can easily update it by running the following command:

Dotnet tool update-g upgrade-assistant project upgrade

① analysis: the .NET upgrade assistant tool includes an analysis mode that provides insight into changes that may need to be made before the upgrade begins. Run the upgrade-assistant analyze command in the command window, passing in the name of the project or solution you are upgrading. As shown below:

There is a lot of internal diagnostic information in the output, but some information is very useful. Note that the analysis mode indicates that the upgrade will recommend that the project target the net6.0-windows target framework moniker (net6.0-windows). This is because the project referenced by the solution is the WPF project, which is an Windows-only technology. A console application may be advised to upgrade directly to TFMnet6.0 unless it uses some Windows-specific libraries.

If any errors or warnings are reported, handle them before starting the upgrade.

② upgrade: run the upgrade-assistant upgrade command, passing in the name of the project or solution being upgraded.

The tool runs and displays a list of steps it will perform. After completing each step, the tool provides a set of commands that allow the user to apply or skip the next step or other options. Pressing Enter without selecting a number selects the first item in the list.

For detailed steps, please refer to the official website document-link address:

Https://docs.microsoft.com/zh-cn/dotnet/core/porting/upgrade-assistant-wpf-framework

Open the project

After the upgrade is complete, select VS2022 to open the project. My old project relies on Caliburn.Micro version 3.2 that does not support .NET 6, which has been automatically upgraded to the highest version.

Change item:

① packages.config is migrated to the project .csproj file; the following figure

Net6.0-windows WinExe false true true all

② Caliburn.Micro: upgrade to the latest version 4.0 that supports .NET 6

③ AssemblyInfo.cs: the assembly version is supposed to be set in the project-"property in .NET 6, as shown below:"

However, the upgrade assistant does not clean up the excess items after the upgrade, so I will delete them manually, as shown in the following figure:

Run the project

At this point, I believe you have a deeper understanding of "how to upgrade a .NET Framework project to .NET 6". You might as well do it in practice. Here is the website, more related content can enter the relevant channels to inquire, follow us, continue to learn!

Welcome to subscribe "Shulou Technology Information " to get latest news, interesting things and hot topics in the IT industry, and controls the hottest and latest Internet news, technology news and IT industry trends.