.NET Core 3.1 已经用了很长一段时间,其实在 2022 年的年底微软已经不提供支持了,后面的一个 LTS 版本 .NET 6 也会在 2024 年 11 月终止支持,所以直接升级到 .NET 8 是最好的选择。
微软官方推出了升级工具:Upgrade Assistant ,链接地址如下:
https://dotnet.microsoft.com/zh-cn/platform/upgrade-assistant/tutorial/intro
有了升级工具,升级就变得非常简单了,本文就介绍使用升级工具将 .NET Core 3.1 项目升级到 .NET 8 。
安装 Upgrade Assistant
先确保 VS2022 已经升级到了 17.8 。然后在 VS2022 的扩展管理中安装扩展:.NET Upgrade Assistant ,需要特别注意的是,如果之前安装过升级工具扩展,需要卸载重新安装。
![7cea09bd2a8e94ef2dd6b0eedf976335.jpeg](https://i-blog.csdnimg.cn/blog_migrate/5dcd4fd0e94780f8233d9357eac8d644.jpeg)
升级项目
.NET Core 3.1 的一个解决方案中,会有很多的项目,按照项目的依赖关系,从最底层的项目逐个往上进行升级。
1、安装完升级工具后,在项目上点击右键就会出现 Upgrade 按钮:
![5847939bac98f2786c2cd9111f332b64.jpeg](https://i-blog.csdnimg.cn/blog_migrate/a6a5038111f0017b17c585db01072f01.jpeg)
2、在弹窗中选择升级方式:
![3bf8bce1cd43c1734eb1fb12235d5d76.jpeg](https://i-blog.csdnimg.cn/blog_migrate/dcde5f0b7711fb9b83adcf2095742c49.jpeg)
3、选择升级的目标版本,这里我选择 .NET 8 ,这是一个长线支持版本,最新版本的升级工具只支持升级到 7 和 8 了,如果有升级到 .NET 6 的需求,就需要使用老版本了:
![fea32ba151246e99250a1f59899c3097.jpeg](https://i-blog.csdnimg.cn/blog_migrate/a17ff46fe6184bb896fd88ea897d8b8d.jpeg)
4、选择需要更新的内容,默认全选,点击「Upgrade selection」进行升级:
![ce468dd87248f2a73185644fd31c3605.jpeg](https://i-blog.csdnimg.cn/blog_migrate/f9b1b135f97bfe182e10c534ff9ed5f7.jpeg)
5、很快就可以看到升级成功的提示:
![4e7fa6b219c447f7f28f6331679afd4c.jpeg](https://i-blog.csdnimg.cn/blog_migrate/9ca2e0d13a31e3102ff2b34cc4d806f0.jpeg)
编译
我验证过好几个低版本的项目,使用工具升级的过程没有出现果任何错误,但升级完后进行代码编译就会出现各种问题了。
问题1:Ionic.zip
在原来的版本中,项目中的 zip 压缩用到了 Ionic.zip ,现在 .NET8 已经不支持了,需要换成 DotNetZip :
![3daa564929b577b25d0c066b80d0d1c6.jpeg](https://i-blog.csdnimg.cn/blog_migrate/1b4452fd98693041984da42939321435.jpeg)
问题2:BinaryFormatter 已经过时
代码中有不少地方使用到了二进制的序列化,但 BinaryFormatter 在 .NET8 中已经弃用,有两种解决方式:
1、修改源代码,采用新的推荐的方式进行替换。
2、修改项目文件,忽略此问题,在项目文件种添加下面配置:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
...
<NoWarn>$(NoWarn);SYSLIB0011</NoWarn>
</PropertyGroup>
</Project>
参考:https://learn.microsoft.com/zh-cn/dotnet/fundamentals/syslib-diagnostics/syslib0011
问题 3:Aspose 使用问题
项目中对 Office 文件的处理,使用了 Aspose 套件,升级后版本有兼容性问题,升级到对应的版本就行。
![553c3e73c942d84d310b6d765b0edf18.jpeg](https://i-blog.csdnimg.cn/blog_migrate/a44977f32853da5a6b52bd8e3559bd9a.jpeg)
问题 4:方法二义性
在之前的版本中,List 存储的如果是一个复杂类型,想要按照类型中的某个字段进行去重是没办法直接实现的:
List<UserInfo> list = new List<UserInfo>();
list.Add(new UserInfo() { Name="oec2003",Age=18});
list.Add(new UserInfo() { Name = "oec2003" ,Age=18});
list.Add(new UserInfo() { Name = "oec2004" ,Age=18});
list.Add(new UserInfo() { Name = "oec2004" ,Age=18});
var distnctList = list.DistinctBy(x=>x.Age);
foreach (var item in distnctList)
{
Console.WriteLine(item.Name);
}
public class UserInfo
{
public string Name { get; set; }
public int Age { get; set; }
}
上面代码中的 DistinctBy 方法在 .NET Core 3.1 中是没有的,所以我们扩展了一个 DistinctBy 方法,没想到 .NET8 中已经默认提供了,会导致方法冲突,只需要将我们的扩展方法去掉,使用默认就好。
![5dc1ab7e7eca2f71301a0082495aaf30.jpeg](https://i-blog.csdnimg.cn/blog_migrate/b707dc05acf0aceef06c53c4ed1e9d05.jpeg)
运行
解决了上面的几个编译问题后,程序就能正常启动运行了,整个过程还是非常快速的,不得不说,微软的技术向下兼容做的是非常不错的,再加上工具的加持,升级到新的版本没有什么压力和负担。
相比之下,其他有些技术虽然也在不停地更新迭代,但主流使用的还是某个特定的版本。