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

Curtis Chau

Updated: 29 de junho de 2026

Download IronOCR

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

.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, então, por favor, leia nosso guia System.Drawing.Common no NET6.

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

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

# 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

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

Curtis Chau

Redator Técnico

Converse agora mesmo com a equipe de engenharia.

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 bem estruturados e visualmente atraentes.

Leia mais