Upgrade from .NET 6 to .NET 7
Intro
.NET 7 已经发布了一段时间了,将几个服务升级到了 .NET 7,升级还是比较顺利的,也有遇到几个问题,分享一下
TargetFramework
首先我们需要将项目文件中的目标框架(TargetFramework)从 .NET 6 更新到 .NET 7,
如果是类库项目可以考虑增加 .NET 7 的目标框架
升级之后有一些 .NET 框架相关的 NuGet 包也可以升级更新到 7.0.0
如果项目里有用到 global.json
也要注意更新一下 SDK 的版本
CI update
CI 配置也需要更新到 .NET 7 或者增加 .NET 7 的环境,我个人平时使用的比较多的是 Github Actions 和 Azure DevOps 的 Pipeline,这里以这两种为例
Github Actions 更新示例:
如果要配置多个版本的 SDK 也可以配置一次就可以,可以在一个 step 里配置多个 version,示例如下:
Azure pipeline CI 更新示例:
这里的示例是增加了 .NET 7 的 SDK,如果 .NET 6 的环境不再需要也可以直接把 .NET 6 SDK 的配置去掉
Dockerfile
如果项目里有打包 docker 镜像,更新了之后别忘记更新一下 Dockerfile 里的 base image
CodeSpace
如果你定制了 Github 的 CodeSpace 或者有在用 devcontainer 之类的环境,如果之前是 .NET 6 的环境别忘记更新到 .NET 7 环境,将原来 .NET 6 的镜像更新到 .NET 7
dotnet-monitor
有几个项目有使用到 dotnet-monitor 来作为 sidecar 来收集应用程序的状态,升级时也遇到了点问题
主要使用的 tag 没有指定,相当于使用的是 latest,拉取最新镜像的时候拉了 dotnet-monitor:7
的镜像有一些 breaking change 导致 monitor 起不来,应用也无法启动,可以参考:https://github.com/dotnet/dotnet-monitor/issues/2892
修复办法:
指定使用
dotnet-monitor:6
使用
dotnet-monitor:7
的时候需要修改启动参数
- args: [ "--no-auth" ]
+ args: [ "collect", "--urls", "http://+:52323", "--no-auth"]
More
EF 7 更新后,有些项目里的一些更新和删除操作也可以升级为 EF 7 里的批量更新和删除操作了~
在更新一个 WPF 项目时,项目里有用到 MaterialDesignThemes
想着一起升级,升级之后有一些不兼容的变化折腾了一段时间,升级第三方的类库的时候注意看一下 breaking changes 可能会少踩一些坑
References
https://github.com/WeihanLi/SparkTodo/commit/dc8b854f79817b9fe657d6da1f3b00752187f0f0
https://github.com/WeihanLi/SparkTodo/commit/87adcc02207bd5fb35f5ae5e078c998cc0a26fa7
https://github.com/WeihanLi/dotnet-httpie/commit/66ef609973a932dc9e419c9530658dbd884797f7
https://github.com/OpenReservation/ReservationServer/commit/0be1715fceceb4ebbf8c625cb9db4ee8cddd1632
https://github.com/night-moon-studio/NatashaPad/pull/15
https://github.com/dotnet/dotnet-monitor/issues/2892
https://github.com/dotnet/dotnet-monitor/discussions/2864