A arquitetura do leitor com estado

O BarcodeReader do ZXing.Net requer uma nova instância para cada thread ou operação paralela. O padrão a seguir mostra a configuração mínima correta para processamento simultâneo:

// ZXing.Net: a new reader instance is created per iteration
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

// ZXing.Net: a new reader instance is created per iteration
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

Imports System.Collections.Concurrent
Imports System.Drawing
Imports ZXing

Parallel.ForEach(imagePaths, Sub(path)
    Dim reader = New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    }

    Using bitmap As New Bitmap(path)
        Dim result = reader.Decode(bitmap)

        If result IsNot Nothing Then
            results(path) = result.Text
        End If
    End Using
End Sub)

O padrão ThreadLocal<BarcodeReader> reduz a alocação por chamada ao reutilizar uma instância por thread, mas adiciona complexidade ao descarte. De qualquer forma, a segurança de threads é responsabilidade do chamador no ZXing.Net.

Comparação Detalhada de Recursos

Abordagem ZXing .NET

O BarcodeReader do ZXing.Net é um objeto com estado. Quando Decode é chamado, o estado interno é gravado. Se duas threads compartilharem a mesma instância, ocorrerá uma corrida entre elas durante a escrita. Os resultados não são determinísticos: você pode obter um resultado de uma imagem diferente, um valor nulo onde existe um código de barras ou uma exceção. A abordagem correta é criar um leitor por thread — o que significa que cada caminho paralelo ou assíncrono aloca um leitor, o configura, o utiliza uma vez e o descarta:

// ZXing.Net: one reader instance per parallel operation
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

// ZXing.Net: one reader instance per parallel operation
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

Imports System.Collections.Concurrent
Imports System.Drawing
Imports ZXing

Parallel.ForEach(imagePaths, Sub(path)
    Dim reader As New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    }

    Using bitmap As New Bitmap(path)
        Dim result = reader.Decode(bitmap)

        If result IsNot Nothing Then
            results(path) = result.Text
        End If
    End Using
End Sub)

O padrão ThreadLocal<BarcodeReader> reduz a alocação por chamada ao reutilizar um leitor por thread, mas adiciona complexidade ao descarte e ainda requer configuração de formato em cada instância.

Abordagem do IronBarcode

O BarcodeReader.Read do IronBarcode é um método estático sem estado. Não há instância para compartilhar, nenhuma instância para isolar e nenhum estado de configuração para proteger. A mesma chamada é executada com segurança a partir de qualquer número de threads simultâneas:

// IronBarcode: static method — no instance management
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

Parallel.ForEach(imagePaths, path =>
{
    var result = BarcodeReader.Read(path, options).FirstOrDefault();
    if (result != null)
        results[path] = result.Value;
});

// IronBarcode: static method — no instance management
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

Parallel.ForEach(imagePaths, path =>
{
    var result = BarcodeReader.Read(path, options).FirstOrDefault();
    if (result != null)
        results[path] = result.Value;
});

Imports IronBarcode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Parallel.ForEach(imagePaths, Sub(path)
    Dim result = BarcodeReader.Read(path, options).FirstOrDefault()
    If result IsNot Nothing Then
        results(path) = result.Value
    End If
End Sub)

A documentação do IronBarcodesobre leitura assíncrona e multithread de códigos de barras explica o modelo interno de agrupamento de threads. A propriedade MaxParallelThreads controla o grau de paralelismo sem exigir coordenação externa.

Abordagem ZXing .NET

O ZXing.Net requer que reader.Options.PossibleFormats seja preenchido antes de cada decodificação. Se um formato de código de barras não estiver listado, ele não será detectado — sem erros, avisos ou resultados parciais:

// ZXing.Net: PossibleFormats list controls which symbologies are decoded
var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
};
reader.Options.TryHarder = true;

using var bitmap = new Bitmap(imagePath);
var results = reader.DecodeMultiple(bitmap);

// ZXing.Net: PossibleFormats list controls which symbologies are decoded
var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
};
reader.Options.TryHarder = true;

using var bitmap = new Bitmap(imagePath);
var results = reader.DecodeMultiple(bitmap);

Imports ZXing
Imports ZXing.Common

' ZXing.Net: PossibleFormats list controls which symbologies are decoded
Dim reader As New BarcodeReader()
reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
}
reader.Options.TryHarder = True

Using bitmap As New Bitmap(imagePath)
    Dim results = reader.DecodeMultiple(bitmap)
End Using

Se todos os formatos forem listados para evitar erros, o desempenho será prejudicado. Se apenas os formatos esperados forem listados, erros silenciosos se tornam um risco quando imagens chegam de fontes externas. Não existe nenhum mecanismo para o ZXing .NET informar que encontrou um código de barras em um formato não listado.

Abordagem do IronBarcode

O IronBarcode detecta automaticamente todos os mais de 50 formatos suportados. Não é necessário nem aceito nenhum formato de lista:

// IronBarcode: automatic detection across all supported formats
var results = BarcodeReader.Read(imagePath);
foreach (var barcode in results)
{
    Console.WriteLine($"{barcode.Value} ({barcode.Format})");
}

// IronBarcode: automatic detection across all supported formats
var results = BarcodeReader.Read(imagePath);
foreach (var barcode in results)
{
    Console.WriteLine($"{barcode.Value} ({barcode.Format})");
}

Imports IronBarcode

' IronBarcode: automatic detection across all supported formats
Dim results = BarcodeReader.Read(imagePath)
For Each barcode In results
    Console.WriteLine($"{barcode.Value} ({barcode.Format})")
Next

Para aplicações que ajustam velocidade de leitura contra exaustividade de detecção, o IronBarcode expõe um enum ReadingSpeed — Faster, Balanced, Detailed, ExtremeDetail — sem exigir enumeração de formato. O ajuste de velocidade afeta a agressividade com que o mecanismo processa cada imagem, e não os formatos que ele considera.

Abordagem ZXing .NET

Quando um código de barras chega incorporado em um PDF, o ZXing .NET requer uma biblioteca externa de renderização de PDF. A solução alternativa mais comum utiliza o PdfiumViewer, que adiciona aproximadamente 20 MB de binários nativos e um loop de renderização de página que os chamadores devem implementar e manter:

// ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
using var pdfDocument = PdfDocument.Load(pdfPath);

var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.PDF_417
};

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    string tempPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png");
    try
    {
        using var pageImage = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi);
        pageImage.Save(tempPath, ImageFormat.Png);

        using var bitmap = new Bitmap(tempPath);
        var decoded = reader.DecodeMultiple(bitmap);
        if (decoded != null)
            results.AddRange(decoded.Select(d => d.Text));
    }
    finally
    {
        File.Delete(tempPath);
    }
}

// ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
using var pdfDocument = PdfDocument.Load(pdfPath);

var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.PDF_417
};

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    string tempPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png");
    try
    {
        using var pageImage = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi);
        pageImage.Save(tempPath, ImageFormat.Png);

        using var bitmap = new Bitmap(tempPath);
        var decoded = reader.DecodeMultiple(bitmap);
        if (decoded != null)
            results.AddRange(decoded.Select(d => d.Text));
    }
    finally
    {
        File.Delete(tempPath);
    }
}

Imports System.IO
Imports System.Drawing
Imports PdfiumViewer
Imports ZXing
Imports ZXing.Common

' ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
Using pdfDocument As PdfDocument = PdfDocument.Load(pdfPath)

    Dim reader As New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.PDF_417
    }

    For i As Integer = 0 To pdfDocument.PageCount - 1
        Dim tempPath As String = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png")
        Try
            Using pageImage As Image = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi)
                pageImage.Save(tempPath, Imaging.ImageFormat.Png)

                Using bitmap As New Bitmap(tempPath)
                    Dim decoded = reader.DecodeMultiple(bitmap)
                    If decoded IsNot Nothing Then
                        results.AddRange(decoded.Select(Function(d) d.Text))
                    End If
                End Using
            End Using
        Finally
            File.Delete(tempPath)
        End Try
    Next
End Using

Esse padrão apresenta modos de falha reais: a configuração incorreta do DPI causa falhas silenciosas, as permissões de arquivos temporários falham em ambientes restritos, as bibliotecas nativas do PdfiumViewer exigem gerenciamento de implantação separado e a instalação não funciona no Linux sem configuração adicional.

Abordagem do IronBarcode

O IronBarcodelê códigos de barras de PDFs nativamente — todas as páginas, todos os formatos, sem dependências externas. A mesma chamada BarcodeReader.Read aceita caminhos de PDF diretamente:

// IronBarcode: one call processes every page of the PDF
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}");

// IronBarcode: one call processes every page of the PDF
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}");

Imports IronBarcode

' IronBarcode: one call processes every page of the PDF
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}")
Next

Sem enumeração de páginas, sem configuração de DPI, sem arquivos temporários e sem biblioteca separada para implantar junto com o aplicativo.

Abordagem ZXing .NET

O pacote central ZXing.Net fornece lógica de decodificação, mas sem carregamento de imagem. Quem faz a chamada deve escolher uma vinculação com base no seu destino de implantação:

A consequência prática é que o código do Windows usando System.Drawing.Bitmap não compila ou roda no Linux. A conteinerização exige a troca de pacotes de vinculação e a reescrita do código de carregamento de imagens:

// Windows binding path — uses System.Drawing
using ZXing.Windows.Compatibility;
using System.Drawing;

var reader = new BarcodeReader();
using var bitmap = new Bitmap(imagePath);
var result = reader.Decode(bitmap);

// Windows binding path — uses System.Drawing
using ZXing.Windows.Compatibility;
using System.Drawing;

var reader = new BarcodeReader();
using var bitmap = new Bitmap(imagePath);
var result = reader.Decode(bitmap);

Imports ZXing.Windows.Compatibility
Imports System.Drawing

Dim reader As New BarcodeReader()
Using bitmap As New Bitmap(imagePath)
    Dim result = reader.Decode(bitmap)
End Using

// Cross-platform path — different package, different API
using ZXing.ImageSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

var reader = new BarcodeReader<Rgba32>();
using var image = Image.Load<Rgba32>(imagePath);
var result = reader.Decode(image);

// Cross-platform path — different package, different API
using ZXing.ImageSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

var reader = new BarcodeReader<Rgba32>();
using var image = Image.Load<Rgba32>(imagePath);
var result = reader.Decode(image);

Imports ZXing.ImageSharp
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats

Dim reader As New BarcodeReader(Of Rgba32)()
Using image As Image(Of Rgba32) = Image.Load(Of Rgba32)(imagePath)
    Dim result = reader.Decode(image)
End Using

Usar a ligação do Windows em um host Linux também requer libgdiplus na imagem Docker, adicionando aproximadamente 50 MB ao contêiner.

Abordagem do IronBarcode

A IronBarcode envia um único pacote para todas as plataformas. A mesma chamada BarcodeReader.Read(path) compila e roda de forma idêntica em Windows, Linux, macOS, e dentro de contêineres Docker. Não são necessários pacotes de vinculação, condicionais de plataforma ou dependências de sistema adicionais. Para equipes que utilizam contêineres para aplicações .NET , o guia de configuração do IronBarcode para Docker e Linux aborda detalhadamente o padrão de implantação de pacote único.

Abordagem ZXing .NET

A classe BarcodeWriter do ZXing.Net cria um objeto escritor, aceita opções de codificação, chama Write, e retorna um Bitmap que os chamadores devem salvar manualmente usando System.Drawing.Imaging:

// ZXing.Net: create writer, set options, call Write, save Bitmap
using ZXing;
using ZXing.Common;
using ZXing.Windows.Compatibility;
using System.Drawing.Imaging;

var writer = new BarcodeWriter
{
    Format = BarcodeFormat.CODE_128,
    Options = new EncodingOptions
    {
        Width = 300,
        Height = 100,
        Margin = 10
    }
};

using var bitmap = writer.Write("PRODUCT-001");
bitmap.Save("output.png", ImageFormat.Png);

// ZXing.Net: create writer, set options, call Write, save Bitmap
using ZXing;
using ZXing.Common;
using ZXing.Windows.Compatibility;
using System.Drawing.Imaging;

var writer = new BarcodeWriter
{
    Format = BarcodeFormat.CODE_128,
    Options = new EncodingOptions
    {
        Width = 300,
        Height = 100,
        Margin = 10
    }
};

using var bitmap = writer.Write("PRODUCT-001");
bitmap.Save("output.png", ImageFormat.Png);

Imports ZXing
Imports ZXing.Common
Imports ZXing.Windows.Compatibility
Imports System.Drawing.Imaging

Dim writer As New BarcodeWriter With {
    .Format = BarcodeFormat.CODE_128,
    .Options = New EncodingOptions With {
        .Width = 300,
        .Height = 100,
        .Margin = 10
    }
}

Using bitmap = writer.Write("PRODUCT-001")
    bitmap.Save("output.png", ImageFormat.Png)
End Using

Salvar em formatos diferentes de PNG ou JPEG, salvar em um PDF, ou produzir saída binária para uma resposta HTTP requerem toda infraestrutura adicional de System.Drawing que o chamador deve implementar.

Abordagem do IronBarcode

O BarcodeWriter.CreateBarcode do IronBarcode retorna um objeto GeneratedBarcode que fornece métodos de saída embutidos através de uma cadeia fluente:

// IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .SaveAsPng("output.png");

// IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .SaveAsPng("output.png");

Imports IronBarCode

' IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .SaveAsPng("output.png")

O objeto GeneratedBarcode também expõe .ToPngBinaryData(), .ToJpegBinaryData(), .ToStream(), e .SaveAsPdf() — alvos de saída que o ZXing.Net requer que os chamadores implementem eles mesmos usando System.Drawing.

Processamento simultâneo e de alto rendimento

Uma integração ZXing .NET que funciona corretamente em um aplicativo de console de thread única pode apresentar comportamento não determinístico quando o mesmo código é movido para um controlador ASP.NET Core que lida com solicitações simultâneas ou para um trabalho em segundo plano que processa lotes em paralelo. O padrão de instância por thread exigido pelo ZXing .NET significa que cada solicitação ou tarefa paralela aloca um objeto leitor completo com seu conjunto de decodificadores configurado, usa-o uma vez e o descarta. À medida que o volume de solicitações aumenta, essa pressão de alocação torna-se mensurável. As equipes que chegam a esse ponto — especialmente aquelas que executam fluxos de trabalho de digitalização de alto rendimento em logística, armazenagem ou processamento de documentos — geralmente procuram uma biblioteca cujo modelo de threading não imponha essa sobrecarga a cada chamador.

Digitalização de documentos em formatos mistos

Aplicações que aceitam documentos de terceiros frequentemente encontram formatos de código de barras que não foram previstos quando a lista de formatos foi configurada. Uma integração de envio criada para a Code 128 recebe remessas de parceiros usando códigos QR. Um sistema de registros médicos configurado para PDF 417 encontra simbologias Data Matrix de um novo fornecedor de equipamentos. Em ZXing .NET, cada um desses casos produz um valor nulo silencioso em vez de um erro de decodificação, o que significa que a falha pode não aparecer até que o processamento subsequente falhe. Equipes que já sofreram prejuízos com falhas silenciosas de formatação — especialmente em contextos onde um código de barras não identificado tem consequências para os negócios — começam a comparar o custo da manutenção da lista de formatos com o de uma biblioteca que detecta formatos automaticamente.

Extração de código de barras em PDF

Muitos documentos comerciais chegam em formato PDF: faturas, manifestos de envio, registros de pacientes, certificados de conformidade. O ZXing .NET não consegue ler estes arquivos diretamente. As equipes que precisam extrair códigos de barras de PDFs acabam construindo e mantendo um pipeline de renderização baseado no ZXing .NET — selecionando uma biblioteca PDF, gerenciando suas dependências nativas, implementando um loop de renderização de página, lidando com a configuração de DPI e escrevendo a lógica de limpeza para arquivos temporários. Esse código de infraestrutura não é lógica de código de barras; Ele existe unicamente para preencher a lacuna entre o que o ZXing .NET aceita (bitmaps) e o que os documentos comerciais realmente são (PDFs). As equipes que se veem responsáveis ​​pela manutenção dessa ponte — especialmente quando a própria biblioteca PDF tem suas próprias considerações de licenciamento, implantação e plataforma — geralmente preferem uma biblioteca única que lide com toda a superfície de entrada.

Reduzindo a complexidade de ligação

Projetos iniciados no Windows e posteriormente implantados no Linux ou Docker encontram diretamente a fragmentação do binding do ZXing.Net: o pacote de binding do Windows usa uma API diferente do binding multiplataforma do ImageSharp, e a troca entre eles exige a alteração tanto das referências do NuGet quanto do código de carregamento de imagens. Equipes que conteinerizam seus aplicativos .NET como prática comum, ou que executam a mesma base de código em máquinas de desenvolvimento (Windows ou macOS) e servidores de produção (Linux), descobrem que manter dois caminhos de código para carregamento de imagens adiciona atrito a cada alteração futura na camada de digitalização.

Remoção da instanciação do leitor de código de barras

Cada chamada new BarcodeReader() na base de código é removida durante a migração. O padrão de instanciação — criação do leitor, configuração do formato, carregamento da imagem, chamada de decodificação — se resume em uma única chamada de método estático. Arquivos que importam os namespaces ZXing, ZXing.Common, ZXing.Windows.Compatibility, ZXing.ImageSharp, e SixLabors.ImageSharp têm essas importações removidas e substituídas por um único using IronBarCode;.

Remoção da configuração PossibleFormats

O bloco de atribuição reader.Options.PossibleFormats é excluído em cada ponto de chamada. O IronBarcode realiza detecção de formato automática e não aceita uma lista de restrição de formato. A flag TryHarder é substituída pela propriedade ReadingSpeed em BarcodeReaderOptions, que controla o esforço de detecção sem restringir o escopo do formato.

Limpeza do pacote de vinculação

A migração remove ZXing.Net, ZXing.Net.Bindings.Windows.Compatibility, qualquer variante de ZXing.Net.Bindings.ImageSharp (.V2 / .V3), e quaisquer pacotes de PdfiumViewer que foram adicionados para suportar leitura de PDF. Se libgdiplus foi adicionado a um Dockerfile para suportar System.Drawing através da ligação do Windows no Linux, essa linha também é removida. O IronBarcode não requer dependências específicas de plataforma na imagem Docker.