将 .NET Framework 项目转换为 .NET Standard 项目

将 .NET Framework 项目转换为 .NET Standard 项目

独立观察员 2020 年 8 月 20 日

如今 .NET Core 是未来发展的主流(至少在 .NET 5 发布之前),而我们如果要改造一个项目为 .NET Core 项目,则它引用的项目应当先改造为 .NET Standard 项目。

下表给出了每种平台支持指定的 .NET Standard 版本的最低版本(参考):

 

 

简单说明一下:.NET Standard 2.0 支持 .NET Core 2.0 和 .NET Framework 4.6.1(最好使用 4.7.2 或更高),所以使用这些版本的话就不用进行多平台配置了。.NET Standard 2.1 开始就和 .NET Framework 不兼容了,这种情况还是要多平台配置。(关于多平台配置,后面会提到)

 

言归正传,我们如何将 Framework 类库项目转换为 Standard 类库项目呢?答案就是使用 dotnet try-convert 工具。

安装前先要确保你已经安装了 .NET Core SDK (get it here),然后在任务栏搜索 “cmd”,以管理员身份运行:

 

使用如下命令安装或卸载:

:: 安装:
dotnet tool install -g try-convert
:: 卸载:
dotnet tool uninstall -g try-convert

 

我已经安装过了:

 

接下来在项目路径打开 cmd,使用如下命令进行转换:

try-convert

 

转换前:

 

转换后:

 

 

可以看到已备份了旧的项目文件,并修改出了新的项目文件。这时我们点击 VS 的弹框重载项目即可(没有打开 VS 则无此操作):

 

由于使用了新的项目文件,我们在项目上右键,就能看到 “编辑项目文件” 的选项:

 

 

打开后发现,项目类型还是 .NET Framework 4.5.2(net452):

 

在项目上右键–属性,可以看到目标框架也还是以前的:

 

那么我们接下来就来进行 “多平台配置” 吧。

首先,在项目文件中将 TargetFramework 改为 TargetFrameworks (加个 “s”),然后里面的内容加上 “netstandard2.0” ,并与之前的内容以分号隔开,修改后如下:

 

然后我们关闭 VS 并重新打开(重新加载解决方案),再次查看项目属性,可以看到目标框架里没有指定特定的内容了,生成一下也没什么错误,说明配置成功了。

 

另外,新式项目的依赖项组织形式也发生了变化:

 

如果解决方案里有多个项目需要转换,也可以定位在解决方案目录,然后执行转换命令(try-convert),已转换的项目会自动跳过,剩余项目将自动批量转换:

 

 

 

通过命令输出,我们还得知了新式的项目类型叫做 “.NET SDK-style project” ,哈哈,涨姿势了。

 

如果 .NET Standard 依赖项中出现了黄色三角形:

 

可以看看该项是否需要,不需要的可以移除。另外,在打开的类文件标签下方可以手动选择当前在什么框架下查看:

 

如果有引用在 .NET Standard 框架下没有,可在 “包” 上右键–“管理 NuGet 程序包”:

 

然后搜索并安装:

 

好了,大致就是这些了。

 

参考:

从 .NET Framework 移植到 .NET Core 的概述

 

 同步首发:

http://dlgcy.com/net-framework-to-net-standard/

 
posted @ 2020-08-20 14:13  独立观察员  阅读(2197)  评论(0编辑  收藏  举报