Utilisation de libgdiplus avec IronOCR : Guide d'installation

Updated: 29 juin 2026

.NET Core nécessite libgdiplus pour utiliser le package NuGet Microsoft System.Drawing.Common . Si vous ne le trouvez pas sur macOS ou Linux, vous pouvez rencontrer l'exception suivante :

Exception non gérée. System.DllNotFoundException : Impossible de trouver ou de charger la bibliothèque native à partir de n'importe quel nom : [ libgdiplus, libgdiplus.so ]
Si vous voyez System.TypeInitializationException: The type initializer for 'Gdip' threw an exception,, veuillez lire plutôt notre guide System.Drawing.Common dans NET6.

Linux

Ubuntu, Debian

Pour installer les bibliothèques requises sur Ubuntu ou Debian, exécutez la commande suivante :

# 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

Ajoutez la ligne suivante à votre Dockerfile pour garantir que les bibliothèques nécessaires sont incluses dans votre image Docker :

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

# 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

Si vous rencontrez l'exception suivante sur macOS :

Exception non gérée. System.DllNotFoundException : Impossible de trouver ou de charger la bibliothèque native à partir de n'importe quel nom : [ libgdiplus, libgdiplus.dylib ]

Vous pouvez résoudre ce problème en :

Ajoutez le package NuGet runtime.osx.10.10-x64.CoreCompat.System.Drawing à votre solution .NET pour inclure libgdiplus dans votre projet.
Vous pouvez également installer manuellement la bibliothèque via Homebrew avec la commande ci-dessous :

# 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

Plus d'informations sont disponibles dans la documentation officielle .NET .

Curtis Chau

Rédacteur technique

Discutez maintenant avec l'équipe d'ingénierie

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.