分享 | .NET Framework升级到.NET 5

Posted 2021-12-29 常哥说编程

-Begin-

前言

微软在2020年9月发布了.NET 5 正式版，距离现在已经一年多了。

.NET 5是一个历史性的版本，实现了.NET Framework和.NET CORE的统一，意味着未来只有一个.NET版本，可以支持 Windows、Linux、macOS、iOS、Android、tvOS、watchOS 和 WebAssembly等等。.NET 5将引入新的.NET API、运行时功能和语言特性作为.NET 5 的一部分。因此，我们应该明白，.NET 5（及其后续版本） 是.NET 平台的未来。

但是可能很多.Neter，包括我在内，还是比较习惯使用.NET Framework，很多项目也是基于.NET Framework，如果希望将项目框架改成.NET 5，是否可以平滑移植？

今天跟大家分享一下，如何将自己的.NET Framework的项目，移植为.NET 5项目。

准备

• VS版本需要Visual Studio 2019 v16.8及以上。

• 提前安装好dotnet 5框架（可通过公众号回复NET5获取安装包）。

• 安装.NET 升级助手，通过控制台或Powershell执行指令即可。

安装指令：

 

 卸载指令：

 

 更新指令：

 

 

• 一个.NET Framework的项目。

实现

1、进入要目标项目或解决方案所在的文件夹中，打开控制台或Powershell。

2、输入指令如下：

 

 3、该工具将运行并显示它将执行的步骤列表。

 

 

 

完成每个步骤后，该工具都会提供一组命令，用户可应用这些命令，也可跳过下一步骤、查看更多详细信息、配置日志记录或退出该过程。如果该工具检测到某个步骤将不执行任何操作，它会自动跳过该步骤，转到下一步骤，直到到达有要执行的操作的步骤为止。如果未进行其他任何选择，那么按 Enter 将执行下一步。

4、第一步是备份项目，完成后显示为Complete，然后接着依次执行下一步，按照提示执行即可。

 

 

5、第二步是将项目文件转换为 SDK 样式。

6、第三步是清空NuGet包引用。

6、第四步是更新项目的 TFM。

7、第五步是更新项目的 NuGet 包。

8、第六步是添加模板文件（如果有）。

8、第七步是更新Winform项目。

9、第八步是升级app config文件。

10、第九步是升级C#代码。

11、第十步是移动到新的项目。

12、执行完成后，即完成移植。

 

 13、完成之后，打开项目看到项目框架已经变成了.NET 5。