Usando o libgdiplus com IronOCR: Guia de Configuração

Atualizado:abril 21, 2026

Translated

View the article in English

.NET Core requer libgdiplus para usar o pacote NuGet System.Drawing.Common da Microsoft. Se não for encontrado no macOS ou Linux, você pode experimentar esta exceção:

Exceção não tratada. System.DllNotFoundException: Não foi possível encontrar ou carregar a biblioteca nativa de qualquer nome: [ libgdiplus, libgdiplus.so ]
Se você vir System.TypeInitializationException: The type initializer for 'Gdip' threw an exception,, leia nosso guia sobre [System.Drawing.Common no .NET 6.](https://ironpdf.com/troubleshooting/system-drawing-common-ironpdf/)

Linux

Ubuntu, Debian

Para instalar as bibliotecas necessárias no Ubuntu ou Debian, execute o seguinte comando:

# 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

Adicione a seguinte linha ao seu Dockerfile para garantir que as bibliotecas necessárias sejam incluídas na sua imagem 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

Se você encontrar a seguinte exceção no macOS:

Exceção não tratada. System.DllNotFoundException: Não foi possível encontrar ou carregar a biblioteca nativa de qualquer nome: [ libgdiplus, libgdiplus.dylib ]

Você pode resolver isso por:

Adicionando o pacote NuGet runtime.osx.10.10-x64.CoreCompat.System.Drawing à sua solução .NET para incluir libgdiplus no seu projeto.
Alternativamente, instalar manualmente a biblioteca via Homebrew com o comando abaixo:

# 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

Mais informações estão disponíveis na documentação oficial do .NET.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...