.Net6 で Aspose.Cells を実行する方法

概要

.NET6（またはそれ以降）プラットフォームでは、以前のプラットフォーム（.netcore31 より前）と比較して、重要な違いはグラフィックスライブラリに関するものです。 この公式Microsoftドキュメントでは、.NET6 以降についてグラフィックスライブラリの「System.Drawing.Common」がWindowsでのみサポートされると説明され、グラフィックスライブラリの置換に関する推奨事項が示されています。

Aspose.Cells製品に関して、非WindowsシステムではMicrosoftの公式ドキュメントで推奨されているように、System.Drawing.Commonの代わりにSkiaSharpを使用し、グラフィックライブラリの移行を完了しました。この重要な変更はAspose.Cells 22.10.1以降の.Net6で有効になります。

.netcore31 より前の場合、互換性と安定性のため、現在も「System.Drawing.Common」グラフィックスライブラリを使用しています。.netcore31 より前の場合の依存関係は以下のとおりです:

  • System.Drawing.Common, 4.7.0.
  • System.Security.Cryptography.Pkcs, 5.0.1.
  • System.Text.Encoding.CodePages, 4.7.0.

Windows で .Net6 の Aspose.Cells を実行する

まず、VS2022 で .net6 アプリケーションを作成し、次に以下のインストールオプションを選択します。

Nuget を使用してインストール

  1. NuGet から Aspose.Cells を検索: Aspose.Cells for .NET NuGet Package また、VS2022 の NuGet パッケージマネージャからも Aspose.Cells をインストールすることができます。

  2. “SkiaSharp” または “System.Drawing.Common” は、Aspose.Cells 22.10.1 以降の .Net6 プラットフォームに自動的に依存関係としてインストールされます。これは、プロジェクトの「Target OS」構成に依存します。

  • プロジェクトの「Target OS」を「Windows」に設定すると、.Net6 プロジェクトでWindowsシステムに「System.Drawing.Common」が依存するようになります。この構成では、描画の結果が.netcore31 より前に近づきます。 Config target OS
  • プロジェクトの「Target OS」を「None」またはその他のオプションに設定すると、.Net6 プロジェクトでWindowsシステムに「SkiaSharp」が依存するようになります。*「SkiaSharp」を依存とするバージョンでは、プリンターへの印刷機能はサポートされないことに注意してください。

msi または DLL を使用してインストール

  1. Aspose.Cells.msi または DLL をダウンロード

  2. インストールディレクトリまたは DLL ディレクトリを開き、次に以下のステップ 3 または 4 を選択します:

  3. “net6.0-windows” サブディレクトリを見つけ、それに含まれる Aspose.Cells.dll を .net6 アプリケーションに追加します。次に、以下の NuGet パッケージを .net6 プロジェクトに手動で追加します:

  • System.Drawing.Common, 4.7.0.
  • System.Security.Cryptography.Pkcs, 6.0.3.
  • System.Text.Encoding.CodePages, 4.7.0.

この方法で、.Net6 プロジェクトでWindowsシステムに「System.Drawing.Common」が依存するようになります。この構成では、描画の結果が.netcore31 より前に近づきます。

  1. “net6.0” サブディレクトリを見つけ、それに含まれる Aspose.Cells.dll を .net6 アプリケーションに追加します。次に、以下の NuGet パッケージを .net6 プロジェクトに手動で追加します:
  • SkiaSharp, 2.88.6.
  • System.Security.Cryptography.Pkcs, 6.0.3.
  • System.Text.Encoding.CodePages, 4.7.0.

この方法で、.Net6 プロジェクトでWindowsシステムに「SkiaSharp」が依存するようになります。*「SkiaSharp」を依存とするバージョンでは、プリンターへの印刷機能はサポートされないことに注意してください。

Linux で .Net6 の Aspose.Cells を実行する

Windowsでのインストール方法については、Linuxシステム上でのグラフィックライブラリ依存関係としてSkiaSharpを選択することしかできません。

LinuxでSkiaSharpを正しく使用するためには、以下の追加操作を行う必要があります。

  1. Linuxシステムで以下のコマンドを実行します:
apt-get update && apt-get install -y libfontconfig1

または

apk update && apk add fontconfig

  1. .net6プロジェクトに"SkiaSharp.NativeAssets.Linux 2.88.6"をNuGetパッケージとして追加します。

  2. または、上記の2つの手順の代わりに、.net6プロジェクトに"SkiaSharp.NativeAssets.Linux.NoDependencies 2.88.6"をNuGetパッケージとして追加することもできます。

Ubuntu向けのDockerfileの例

  1. .net6プロジェクトに"SkiaSharp.NativeAssets.Linux 2.88.6"をNuGetパッケージとして追加します。

  2. 次の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の例

  1. .net6プロジェクトに"SkiaSharp.NativeAssets.Linux 2.88.6"をNuGetパッケージとして追加します。

  2. 次の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"]

成功事例 DockerでAspose.Cellsを実行する方法