Using libgdiplus with IronOCR: Setup Guide

This article was translated from English: Does it need improvement?
Translated
View the article in English

.NET Core requires libgdiplus to use the Microsoft System.Drawing.Common NuGet package. Wenn es unter macOS oder Linux nicht gefunden wird, kann diese Ausnahme auftreten:

  • Nicht behandelter Ausnahmefehler. System.DllNotFoundException: Konnte die native Bibliothek unter keinem Namen finden oder laden: [ libgdiplus, libgdiplus.so ]
  • Wenn Sie System.TypeInitializationException: Der Typ-Initialisierer für 'Gdip' hat eine Ausnahme ausgelöst, sehen, lesen Sie bitte stattdessen unseren System.Drawing.Common in NET6-Leitfaden.

Linux

Ubuntu, Debian

Führen Sie den folgenden Befehl aus, um die erforderlichen Bibliotheken auf Ubuntu oder Debian zu installieren:

# Update package lists and install necessary libraries
sudo apt-get update && sudo apt-get install -y apt-utils libgdiplus libc6-dev
# Update package lists and install necessary libraries
sudo apt-get update && sudo apt-get install -y apt-utils libgdiplus libc6-dev
SHELL

Docker

Fügen Sie die folgende Zeile zu Ihrer Docker-Datei hinzu, um sicherzustellen, dass die notwendigen Bibliotheken in Ihrem Docker-Image enthalten sind:

# Update package lists and install necessary libraries in Docker container
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

macOS

Wenn Sie auf macOS die folgende Ausnahme erhalten:

Unbehandelte Ausnahme. System.DllNotFoundException: Konnte die native Bibliothek unter keinem Namen finden oder laden: [ libgdiplus, libgdiplus.dylib ]

Sie können dies beheben durch:

  • Hinzufügen des runtime.osx.10.10-x64.CoreCompat.System.Drawing NuGet-Pakets zu Ihrer .NET-Lösung, um libgdiplus in Ihr Projekt einzuschließen.
  • Alternativ installieren Sie die Bibliothek manuell über Homebrew mit dem untenstehenden Befehl:
# Update Homebrew and install mono-libgdiplus
brew update && brew install mono-libgdiplus
# Update Homebrew and install mono-libgdiplus
brew update && brew install mono-libgdiplus
SHELL
Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 5,044,537 | Version: 2025.11 gerade veröffentlicht