Use Reporting on Linux and macOS
- 2 minutes to read
This article lists packages and options that are required before you use Reporting tools on Linux or macOS.
Add Common Libraries
Add the following common libraries to your application:
- The .NET library
- Install the .NET library of the required version.
- Packaged fonts
- To install font files on your machine, put them in the
/usr/share/fonts
folder and execute thefc-cache
command to updatefontconfig
cache files. Refer to the following article for more information on font installation in Reporting Tools: Use Custom Fonts in Reporting - DevExpress.Pdf.SkiaRenderer
- Add this package for reports with embedded PDF content.
- libcups
- Install libcups to support printing with OpenPrinting CUPS on Linux and other Unix-like operating systems. MacOS does not requires any additional packages.
Refer to the following help topic for information on how to avoid .NET 6 limitations related to the System.Drawing.Common library: Reporting .NET/.NET Core Limitations.
The following commands configure the environment in the dockerfile:
Enable the Drawing Engine
The DevExpress Drawing Library allows you to use the Skia-based drawing engine in non-Windows environments. Make sure that you add the DevExpress.Drawing.Skia package to your application to use this drawing engine.
If you use the the System.Drawing.Common
package v7 and later, the Skia-based engine is enabled automatically and the libgdiplus
library is not required.
You can find more information about troubleshooting in the following topic: DevExpress.Drawing Library Troubleshooting.
XRPdfContent Control Specifics
The XRPdfContent control uses the CreateBitmap method. This method does not work in Linux-based environments or certain Azure hosting plans. Add the DevExpress.Pdf.SkiaRenderer NuGet package to your solution and use the Skia rendering engine on these platforms:
- On Linux, add the SkiaSharp.NativeAssets.Linux NuGet package to the solution in addition to DevExpress.Pdf.SkiaRenderer.
- On Windows Azure, set the PrintingOptions.Pdf.RenderingEngine property to Skia.