Verwendung von libgdiplus mit IronOCR: Einrichtungsanleitung

Curtis Chau
Curtis Chau
Updated: 29. Juni 2026

.NET Core erfordert libgdiplus, um das Microsoft System.Drawing.Common NuGet-Paket zu verwenden. 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: The type initializer for 'Gdip' threw an exception, 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
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
Dockerfile

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
SHELL

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 Handbücher.

Weiterlesen

Bereit anzufangen?

Nuget Downloads 6,357,159Version:2026.11gerade veröffentlicht