Używanie libgdiplus z IronOCR: Przewodnik instalacji

Curtis Chau
Curtis Chau
Updated: 29 czerwca 2026

.NET Core wymaga libgdiplus do używania pakietu NuGet Microsoft System.Drawing.Common. Jeśli nie zostanie znaleziony na macOS lub Linux, możesz napotkać następujący wyjątek:

  • Nieobsługiwany wyjątek. System.DllNotFoundException: Nie można znaleźć lub załadować biblioteki natywnej o żadnej nazwie: [ libgdiplus, libgdiplus.so ]
  • Jeśli widzisz System.TypeInitializationException: The type initializer for 'Gdip' threw an exception,, proszę przeczytać nasz przewodnik System.Drawing.Common w NET6 zamiast tego.

Linux

Ubuntu, Debian

Aby zainstalować wymagane biblioteki na Ubuntu lub Debian, uruchom następujące polecenie:

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

Docker

Dodaj poniższą linię do swojego Dockerfile, aby zapewnić, że niezbędne biblioteki są zawarte w obrazie Dockera:

# 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

Jeśli napotkasz następujący wyjątek na macOS:

Nieobsługiwany wyjątek. System.DllNotFoundException: Nie można znaleźć lub załadować biblioteki natywnej o żadnej nazwie: [ libgdiplus, libgdiplus.dylib ]

Możesz to rozwiązać poprzez:

# Update Homebrew and install mono-libgdiplus
brew update && brew install mono-libgdiplus
SHELL

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 6,357,159Wersja:2026.11właśnie wydany