System.Drawing.Common is not supported on non-Windows platforms - .NET 6 and .NET 7 under Linux and MacOS

Environment

Product	Progress® Telerik® Reporting
Framework	.NET 6

Description

The .NET 6 and .NET 7 project project runs correctly in Windows environment. The following error occurs when running it under a Linux and MacOS environment, for example, in Linux Docker container.

Error Message

System.AggregateException: One or more errors occurred. (Type: Telerik.Reporting.ReportSerialization.Current.ReportSerializable'1[Telerik.Reporting.Report])
    ---> System.MissingMethodException: Type: Telerik.Reporting.ReportSerialization.Current.ReportSerializable'1[Telerik.Reporting.Report]
    ---> System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.
    ---> System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.
    ---> System.TypeInitializationException: The type initializer for 'Telerik.Reporting.Drawing.Unit' threw an exception.
    ---> System.TypeInitializationException: The type initializer for 'Gdip' threw an exception.
    ---> System.PlatformNotSupportedException: System.Drawing.Common is not supported on non-Windows platforms. See https://aka.ms/systemdrawingnonwindows for more information.
        at System.Drawing.LibraryResolver.EnsureRegistered()
        at System.Drawing.SafeNativeMethods.Gdip.PlatformInitialize()
        at System.Drawing.SafeNativeMethods.Gdip..cctor()
        --- End of inner exception stack trace ---
        at System.Drawing.SafeNativeMethods.Gdip.GdipCreateBitmapFromScan0(Int32 width, Int32 height, Int32 stride, Int32 format, IntPtr scan0, IntPtr& bitmap)
        at System.Drawing.Bitmap..ctor(Int32 width, Int32 height, PixelFormat format)
        at System.Drawing.Bitmap..ctor(Int32 width, Int32 height)
        at Telerik.Reporting.Drawing.Unit.GetDotsPerInch()
        at Telerik.Reporting.Drawing.Unit.ResetDpiSettings()
        at Telerik.Reporting.Drawing.Unit..cctor()

Cause\Possible Cause(s)

The reason for the problem is described in the Microsoft article System.Drawing.Common only supported on Windows.

Suggested Workarounds

• .NET 6

  Add file named runtimeconfig.template.json with the following content in the folder with the .csproj file:

  {
      "configProperties": {
          "System.Drawing.EnableUnixSupport": true
      }
  }
  

  For more details, check the Microsoft article section runtimeconfig.json.

• .NET 7

  Currently, there is no workaround for .NET 7.

The Telerik Reporting team has prioritized the feature request described in Future of Linux support for reporting. Our target is to deliver it with 2023 R3 release scheduled for the middle of October 2023.

See Also

• System.Drawing.Common only supported on Windows.
• runtimeconfig.json
• Future of Linux support for reporting