Using libgdiplus with IronOCR: Setup Guide

Mis à jour:juin 1, 2025

Translated

View the article in English

.NET Core requires libgdiplus to use the Microsoft System.Drawing.Common NuGet package. Si elle n'est pas trouvée sur macOS ou Linux, vous pouvez faire l'expérience de cette exception :

exception non gérée. System.DllNotFoundException : Impossible de trouver ou de charger la bibliothèque native à partir d'un nom quelconque : [ libgdiplus, libgdiplus.so ]_
si vous voyez System.TypeInitializationException : The type initializer for 'Gdip' threw an exception,, lisez plutôt notre guide System.Drawing.Common in 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 fichier Docker pour vous assurer 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

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 d'un nom quelconque : [ libgdiplus, libgdiplus.dylib ]_

Vous pouvez résoudre ce problème en :

Ajout du paquet runtime.osx.10.10-x64.CoreCompat.System.Drawing NuGet à votre solution .NET pour inclure libgdiplus dans votre projet.
Vous pouvez également installer manuellement la bibliothèque via Homebrew à l'aide de 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

De plus amples informations sont disponibles sur la documentation officielle .NET.

Curtis Chau

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

Rédacteur technique

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

Prêt à commencer?

Nuget Téléchargements 5,044,537 | Version : 2025.11 vient de sortir