确保系统安装下列工具:
- Visual Studio 2019 16.8 及以上版本 (下载地址)
- .NET 5.0 SDK (下载地址)
1.打开cmd 运行以下命令安装try-convert
dotnet tool install -g try-convert
如果已经安装try-convert但是需要升级到新版本,运行一下命令
dotnet tool update -g try-convert
2.安装.NET升级助手,请执行以下命令
dotnet tool install -g upgrade-assistant3.使用.NET助手开始迁移程序
1.使用cmd切换到解决方案所在文件夹并输入以下命令(这里解决方案名字暂定为:Test.sln)
upgrade-assistant upgrade Test.sln
也可以使用Visual Studio 2019的终端来实现,以下如图所示:
在Visual Studio 2019的视图里找到终端,然后打开终端输入命令,按下回车执行
upgrade-assistant upgrade Test.sln
.NET升级工具执行并显示它奖执行的步骤,对于每个流程的步骤我们都选择:
1. Apply next step
步骤一: 备份项目文件
.NET 升级助手会询问您是要为备份使用自定义路径还是默认位置。这里我们一般用默认路径(同项目目录下****.backup文件夹下面),中间会让你选择需要升级的程序集,选择自己需要升级的程序集就好了
步骤二: 将项目文件转换为 SDK 样式
.NET 5 项目使用的是 SDK 格式。在此步骤中，升级助手使用该ry-convert工具将你的项目文件转换为该 SDK 格式。
步骤三: 清理Nuget包的引用关系
步骤四: 更新TFM
.NET 升级助手会将目标框架名称 (TFM) 更新为 .NET 5.0。在我的情况下，值从.NET Framework更改为net5.0。
步骤五: 更新 NuGet 包
.NET升级工具会尝试更新项目的 NuGet 包。该工具使用分析器来检测要删除的引用以及要使用.NET 5版本升级的软件包。
步骤六: 添加模板文件(Web应用会出现)
该工具更新任何 NuGet 包后，它会添加任何相关模板文件。ASP.NET Core 使用模板文件进行配置和启动
步骤七: 迁移应用程序配置文件(Web应用会出现)
步骤八: 更新Razor 文件，修复Razor 文件里面的代码
该工具更新任何 NuGet 包后，它会添加任何相关模板文件。ASP.NET Core 使用模板文件进行配置和启动
步骤九: 更新 C# 源代码
.NET升级助手将C＃代码引用升级到其.NET Core 版本。您会在终端中看到列出的几个步骤 - 并非所有步骤都适用。
现在工具已经帮我们完成大部分的迁移工作了，最后一步就是要我们手动修复剩余的问题了。仍然需要整理一些东西。大多数这些问题涉及 ASP.NET Core 如何处理启动、配置和捆绑。
