System.Drawing.Common workaround in .NET6 Intro
最近有不少小伙伴在升级 .NET 6 时遇到了 System.Drawing.Common 的问题,同时很多库的依赖还都是 System.Drawing.Common ,而 .NET 6 默认情况下只在 Windows 上支持使用,Linux 上默认不支持这就导致在 Linux 环境上使用会有问题, 所以想介绍下 .NET 6 中 Linux 上使用 System.Drawing.Common 的解决办法
App Context
在项目启动时,配置 AppContext Switch,设置 System.Drawing.EnableUnixSupport ,示例代码如下:
System.AppContext.SetSwitch( "System.Drawing.EnableUnixSupport", true);
Runtime Config Json
在应用 build/publish 之后,会有一个 *.runtimeconfig.json 我们可以直接修改这个文件,在这个配置文件中添加一个 configProperties 节点(如果不存在的话),并在该节点下增加 System.Drawing.EnableUnixSupport 配置,配置如下:
{
"runtimeOptions": {
"configProperties": {
"System.Drawing.EnableUnixSupport": true
}
}
}
MS Build
我们也可以在项目文件中添加一个下面的配置,作用和上面的直接修改 runtimeconfig.json 效果一样,只是 .NET SDK 会在生成的时候将这个配置写入到 runtimeconfig.json 中
< ItemGroup>
< RuntimeHostConfigurationOptionInclude= "System.Drawing.EnableUnixSupport"Value= "true"/>
</ ItemGroup>
Environment Variable
除此之外我们也可以配置环境变量 DOTNET_System_Drawing_EnableUnixSupport 来启用 Unix 支持
Dockerfile 示例:
ENVDOTNET_System_Drawing_EnableUnixSupport=true
Unix 示例:
exportDOTNET_System_Drawing_EnableUnixSupport true
More
个人推荐使用项目文件配置或者是环境变量的方式,如果不想修改代码,就使用环境变量的方式,如果觉得环境变量不方便就使用项目文件配置,直接修改 runtimeconfig.json 的方式有点不太好维护,至于 AppContext Switch 个人感觉有点侵入代码,不如项目文件或者环境变量干净
如果基于 Docker 容器部署,更加推荐使用环境变量方式,直接在 Runtime 镜像中配置一个环境变量即可,这样无论什么地方需要部署都已经写在了镜像环境中,在哪里跑都是一样的,可以参考:https://github.com/OpenReservation/ReservationServer/blob/dev/Dockerfile#L10
References
https://docs.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only
https://github.com/dotnet/designs/pull/234
https://github.com/dotnet/runtime/pull/55962
https://docs.microsoft.com/en-us/dotnet/core/run-time-config
https://guochen2.github.io/2021/11/13/netcore/net6%E7%BB%98%E5%9B%BE%E7%BB%84%E4%BB%B6System.Drawing.Common%E5%BC%82%E5%B8%B8/
https://github.com/dotnet/sdk/blob/a5f5bb5183517cb301050288b25c9c727e52e8a6/src/Tasks/Microsoft.NET.Build.Tasks/GenerateRuntimeConfigurationFiles.cs#L166
https://github.com/OpenReservation/ReservationServer/blob/dev/Dockerfile#L10 返回搜狐,查看更多
责任编辑: