从 .NET 6 更新到 .NET 7

Upgrade from .NET 6 to .NET 7

Intro

.NET 7 已经发布了一段时间了,将几个服务升级到了 .NET 7,升级还是比较顺利的,也有遇到几个问题,分享一下

TargetFramework

首先我们需要将项目文件中的目标框架(TargetFramework)从 .NET 6 更新到 .NET 7,.

从 .NET 6 更新到 .NET 7

如果是类库项目可以考虑增加 .NET 7 的目标框架

升级之后有一些 .NET 框架相关的 NuGet 包也可以升级更新到 7.0.0

从 .NET 6 更新到 .NET 7

NuGet Packages

如果项目里有用到 global.json 也要注意更新一下 SDK 的版本

从 .NET 6 更新到 .NET 7

Global json

CI update

CI 配置也需要更新到 .NET 7 或者增加 .NET 7 的环境,我个人平时使用的比较多的是 Github Actions 和 Azure DevOps 的 Pipeline,这里以这两种为例

Github Actions 更新示例:

从 .NET 6 更新到 .NET 7

如果要配置多个版本的 SDK 也可以配置一次就可以,可以在一个 step 里配置多个 version,示例如下:

从 .NET 6 更新到 .NET 7

Azure pipeline CI 更新示例:

从 .NET 6 更新到 .NET 7

Azure Pipeline

这里的示例是增加了 .NET 7 的 SDK,如果 .NET 6 的环境不再需要也可以直接把 .NET 6 SDK 的配置去掉

从 .NET 6 更新到 .NET 7

Dockerfile

如果项目里有打包 docker 镜像,更新了之后别忘记更新一下 Dockerfile 里的 base image

从 .NET 6 更新到 .NET 7

CodeSpace

如果你定制了 Github 的 CodeSpace 或者有在用 devcontainer 之类的环境,如果之前是 .NET 6 的环境别忘记更新到 .NET 7 环境,将原来 .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

修复办法:

  1. 指定使用 dotnet-monitor:6
  2. 使用 dotnet-monitor:7  的时候需要修改启动参数
- args: [ "--no-auth" ]
+ args: [ "collect", "--urls", "http://+:52323", "--no-auth"]

More

EF 7 更新后,有些项目里的一些更新和删除操作也可以升级为 EF 7 里的批量更新和删除操作了~

在更新一个 WPF 项目时,项目里有用到 MaterialDesignThemes 想着一起升级,升级之后有一些不兼容的变化折腾了一段时间,升级第三方的类库的时候注意看一下 breaking changes 可能会少踩一些坑。