从 ASP.NET Core 3.1 迁移到 5.0

3月中旬，微软官方已经发布了dotnet 5的第一个预览版：5.0.0-preview.1。

dotnet core经过前几个版本的发展和沉淀，到3.1已经基本趋于稳定。

所以从.net core 3.1升级到.net 5将非常简单，下面咱们就开始吧：

（注：需要 Visual Studio 2019 16.6 或更高版本）

第一步：在 global.json 中更新 .NET Core SDK 版本

{
  "sdk": {
    "version": "5.0.100-preview.1.20155.7"
  }
}

第二步：更新目标框架

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
        <TargetFramework>netcoreapp5.0</TargetFramework>
  </PropertyGroup>
</Project>

第三步：更新包引用

在项目文件中，将每个 Microsoft.AspNetCore.* 和 Microsoft.Extensions.* 包引用的 Version 属性更新为5.0.0 或更高版本。

如：

<ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="5.0.0-preview.1.20124.5" />
    <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="5.0.0-preview.1.20120.4" />
</ItemGroup>

第四步：更新 Docker 镜像

对于使用 Docker 的应用，请使用包含 ASP.NET Core 5.0 的基本镜像。 例如：

docker pull mcr.microsoft.com/dotnet/core/aspnet:5.0

是的，就是这么简单，只需要以上4步，就可以轻松将dotne core 3.1 升级到  dotnet 5

从3.1版迁移到5.0版的重大更改

那从dotnet core 3.1 到  dotnet 5 的第一预览版 有哪些重大更改呢？

其实也并不多，主要集中在以下几点：

1.Azure：删除了Microsoft前缀的Azure集成程序包

2.SignalR：MessagePack集线器协议已移至MessagePack 2.x程序包

3.SignalR：UseSignalR和UseConnections方法已删除

总结

从上面的描述，可以发现，从3.1 到 5 并没有太大的改变。

最大的改变，不知你有没有发现 dotnet core 3.1 到  dotnet 5  ，少了一个“core“。

是的，从3.1到5 更重要的意义，在于标志这dotnet的一个全新时代的到来。

让我们共同期待将今年年底前发布的dotnet 5 正式版。