Używanie libgdiplus z IronOCR: Przewodnik instalacji

Zaktualizowano:1 czerwca, 2025

Translated

View the article in English

.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, to proszę przeczytaj 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

# 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

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:

Dodanie pakietu NuGet runtime.osx.10.10-x64.CoreCompat.System.Drawing do swojej solucji .NET, aby uwzględnić libgdiplus w projekcie.
Alternatywnie, ręcznie zainstaluj bibliotekę przez Homebrew za pomocą poniższego polecenia:

# 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

Więcej informacji jest dostępnych w oficjalnej dokumentacji .NET.

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

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ę...

Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Pliki do pobrania 5,571,678 | Wersja: 2026.4 just released