如何为.Net6运行Aspose.Cells
概述
对于.NET6(或更高版本)平台,与以前的平台(.netcore31 或更早版本)相比,一个重要的区别在于图形库。 在这个官方Microsoft 文件,它解释了.NET6或更高版本的图形库“System.Drawing.Common”将仅在Windows上受支持,并给出了替换图形库的建议。
对于Apose.Cells产品,我们已经进行了评估并完成了图形库的迁移。我们在非 Windows 系统中使用 SkiaSharp 而不是 System.Drawing.Common,如 Microsoft 官方文档中建议的那样。请注意,此重要更改将在 .Net6 的 Aspose.Cells 22.10.1 或更高版本中生效。
对于.netcore31及之前版本,为了兼容性和稳定性,目前我们仍然使用“System.Drawing.Common”图形库。 .netcore31及之前版本的依赖如下:
- 系统.绘图.通用,4.7.0。
- 系统.安全.加密.Pkcs,5.0.1。
- 系统.文本.编码.代码页,4.7.0。
在 Windows 上运行 .Net6 的 Aspose.Cells
首先你可以用VS2022创建一个.net6应用程序,然后你可以选择以下安装选项:
通过nuget安装
-
从 NuGet 搜索 Aspose.Cells:Aspose.Cells for .NET NuGet 封装. 您还可以从 VS2022 中的 Nuget 包管理器安装 Aspose.Cells。
-
对于.Net6 平台,“SkiaSharp”或“System.Drawing.Common”将作为 Aspose.Cells 22.10.1 或更高版本的依赖项自动安装,这取决于项目中“目标操作系统”的配置。
- 将项目的“目标操作系统”设置为“Windows”,您将使用“System.Drawing.Common”作为 .Net6 项目对 Windows 系统的依赖项。在这种配置下,绘制的结果更接近.netcore31或之前的版本。
- 将“目标操作系统”设置为“无”或项目的其他选项,您将使用“SkiaSharp”作为 .Net6 项目对 Windows 系统的依赖项。请注意,使用“SkiaSharp”作为依赖项的版本不支持打印到打印机功能。
通过msi或DLL安装
-
打开安装目录或DLL目录,然后选择下面的步骤3或4:
3.找到“net6.0-windows”子目录,将其中的Aspose.Cells.dll添加到您的.net6应用程序中。手动将以下 nuget 包添加到您的 .net6 项目中:
- 系统.绘图.通用,4.7.0。
- 系统.安全.加密.Pkcs,6.0.3。
- 系统.文本.编码.代码页,4.7.0。
这样,您将使用“System.Drawing.Common”作为 .Net6 项目对 Windows 系统的依赖项。在这种配置下,绘制的结果更接近.netcore31或之前的版本。
4.找到“net6.0”子目录,将其中的Aspose.Cells.dll添加到您的.net6应用程序中。手动将以下 nuget 包添加到您的 .net6 项目中:
- SkiaSharp,2.88.6。
- 系统.安全.加密.Pkcs,6.0.3。
- 系统.文本.编码.代码页,4.7.0。
这样,您将使用“SkiaSharp”作为 .Net6 项目对 Windows 系统的依赖项。请注意,使用“SkiaSharp”作为依赖项的版本不支持打印到打印机功能。
在 Linux 上运行 .Net6 的 Aspose.Cells
参考Windows上的安装方法,Linux系统上只能选择SkiaSharp作为图形库依赖。
为了确保在Linux下正确使用SkiaSharp,您还需要执行以下额外操作:
- 在 Linux 系统中运行以下命令:
apt-get update && apt-get install -y libfontconfig1
OR
apk update && apk add fontconfig
-
将 nuget 软件包“SkiaSharp.NativeAssets.Linux 2.88.6”添加到您的 .net6 项目中。
-
或者您可以选择将 nuget 包“SkiaSharp.NativeAssets.Linux.NoDependencies 2.88.6”添加到您的 .net6 项目中,而不是执行上面的两个步骤。
Ubuntu 的 Dockerfile 示例
-
将 nuget 包“SkiaSharp.NativeAssets.Linux 2.88.6”添加到您的 .net6 项目中。
-
使用以下 Dockerfile:
# Ubuntu 20.04 FROM mcr.microsoft.com/dotnet/runtime:6.0-focal AS base WORKDIR /app # add "libfontconfig1" package if using "SkiaSharp.NativeAssets.Linux" in your project # Or you need to use "SkiaSharp.NativeAssets.Linux.NoDependencies" in your project RUN apt-get update && apt-get install -y libfontconfig1 # Copy fonts from local to docker # For example, put a "fonts" folder in your project folder, and put the font files in it, # then, use the following line: COPY fonts/ /usr/share/fonts FROM mcr.microsoft.com/dotnet/sdk:6.0-focal AS build WORKDIR /src COPY ["Ubuntu_Docker.csproj", "."] RUN dotnet restore "./Ubuntu_Docker.csproj" COPY . . WORKDIR "/src/." RUN dotnet build "Ubuntu_Docker.csproj" -c Release -o /app/build FROM build AS publish RUN dotnet publish "Ubuntu_Docker.csproj" -c Release -o /app/publish FROM base AS final WORKDIR /app COPY --from=publish /app/publish . ENTRYPOINT ["dotnet", "Ubuntu_Docker.dll"]
Alpine 的 Dockerfile 示例
-
将 nuget 包“SkiaSharp.NativeAssets.Linux 2.88.6”添加到您的 .net6 项目中。
-
使用以下 Dockerfile:
# Alpine 3.16 FROM mcr.microsoft.com/dotnet/runtime:6.0-alpine3.16 AS base WORKDIR /app # add "fontconfig" package if using "SkiaSharp.NativeAssets.Linux" in your project # Or you need to use "SkiaSharp.NativeAssets.Linux.NoDependencies" in your project RUN apk update && apk add fontconfig # Copy fonts from local to docker # For example, put a "fonts" folder in your project folder, and put the font files in it, # then, use the following line: COPY fonts/ /usr/share/fonts FROM mcr.microsoft.com/dotnet/sdk:6.0-alpine3.16 AS build WORKDIR /src COPY ["Alpine_Docker.csproj", "."] RUN dotnet restore "./Alpine_Docker.csproj" COPY . . WORKDIR "/src/." RUN dotnet build "Alpine_Docker.csproj" -c Release -o /app/build FROM build AS publish RUN dotnet publish "Alpine_Docker.csproj" -c Release -o /app/publish FROM base AS final WORKDIR /app COPY --from=publish /app/publish . ENTRYPOINT ["dotnet", "Alpine_Docker.dll"]