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
  # Usando o libgdiplus com IronOCR: Guia de Configuração .NET Core requer [libgdiplus](https://packages.ubuntu.com/search?keywords=libgdiplus&searchon=names&suite=all&section=all) para usar o pacote NuGet [System.Drawing.Common](https://www.nuget.org/packages/System.Drawing.Common/5.0.3) 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](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: ```bash # 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: ```dockerfile # 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](https://www.nuget.org/packages/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: ```bash # 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](https://docs.microsoft.com/en-us/dotnet/core/install/macos#libgdiplus).

• ---

• 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

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

...

Leia mais