Barcoder vs IronBarcode: Comparação de bibliotecas de código de barras em C#

Fluxo de trabalho de geração de múltiplos pacotes

O relato da instalação ilustra imediatamente a diferença de escopo. Com o Barcoder, a saída básica em PNG requer dois pacotes separados:

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

O fluxo de trabalho completo para gerar um código de barras Code128 e salvá-lo como PNG requer três importações de namespace, uma chamada de codificador específica do formato, a construção de um renderizador com um objeto de opções, um fluxo de arquivo e uma chamada de renderização:

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

A mudança de formato de código de barras não é uma simples alteração de parâmetros — requer a importação de um namespace diferente e a chamada de uma classe diferente. Code128Encoder.Encode aceita um booleano para includeChecksum, QrEncoder.Encode aceita um nível de correção de erros e dois booleanos adicionais, e DataMatrixEncoder.Encode aceita apenas a string. Não existe uma interface unificada para criar um código de barras em um formato específico.

Comparação Detalhada de Recursos

Abordagem do código de barras

O Código de barras encaminha a seleção de formato por meio de classes de codificadores separadas em namespaces distintos. A mudança de formato significa adicionar uma nova diretiva using e usar uma classe diferente com uma assinatura de método diferente:

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

Cada codificador possui seu próprio contrato de parâmetros. Adicionar um novo formato a um projeto existente não é uma mudança de uma palavra só — é uma nova importação de namespace, uma nova classe para aprender e novos parâmetros para entender.

Abordagem do IronBarcode

IronBarcode encaminha toda a seleção de formato através da enumeração BarcodeEncoding na classe unificada BarcodeWriter. Adicionar um novo formato consiste em alterar o valor da enumeração em apenas uma palavra:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

Para uso em produção, adicione a chave de licença na inicialização do aplicativo:

IronBarCode.License.LicenseKey = "YOUR-KEY";

IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

A documentação de geração de códigos de barras do IronBarcode abrange toda a gama de opções de geração, incluindo estilo, margens e personalização de cores.

Abordagem do código de barras

A separação entre codificação e renderização no Código de barras é fundamentada em sua arquitetura, mas gera sobrecarga a cada mudança de formato de saída. Salvar em um arquivo requer a abertura de um FileStream. Para obter dados binários, é necessário abrir um MemoryStream e chamar ToArray(). Cada cenário de saída requer a construção de um renderizador com um objeto de opções:

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

O controle de tamanho é indireto: PixelSize é um multiplicador de escala no tamanho do módulo de código de barras, não uma especificação direta de largura e altura.

Abordagem do IronBarcode

IronBarcode retorna um objeto GeneratedBarcode a partir do qual qualquer formulário de saída pode ser obtido por meio de chamadas de método encadeadas. Sem construção de renderizador, sem gerenciamento de fluxo:

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height) recebe dimensões de pixel explícitas e encadeia com qualquer método de saída no mesmo objeto.

Abordagem do código de barras

O leitor de código de barras não possui capacidade de leitura ou decodificação. Não existe API, nem API planejada, e nenhuma solução alternativa dentro da biblioteca. Se um aplicativo precisar ler códigos de barras, uma segunda biblioteca — uma dependência NuGet separada com sua própria API e versão a ser controlada — deverá ser adicionada juntamente com o Barcoder. Isso significa, no mínimo, duas dependências relacionadas à leitura: um leitor de código de barras para geração e outro componente para leitura.

Abordagem do IronBarcode

OIronBarcodeabrange tanto a geração quanto a leitura de códigos de barras, com o mesmo pacote e padrões de API consistentes. O método BarcodeReader.Read() aceita arquivos de imagem, arrays de bytes, fluxos e PDFs nativamente:

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// Leia a partir do PDF — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// Leia a partir do PDF — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine(result.Value)
    Console.WriteLine(result.Format)
Next

' Leia a partir do PDF — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

A leitura de PDFs é nativa — sem extração intermediária de imagens, sem biblioteca de conversão, sem pacote adicional. A documentação de leitura de código de barras do IronBarcode abrange PDFs com várias páginas, leitura de regiões de interesse e otimização de desempenho.

A leitura foi adicionada aos requisitos.

Muitos projetos começam como fluxos de trabalho puramente de geração — imprimir etiquetas, gerar códigos para documentos, incorporar códigos de barras em relatórios. O Código de barras atende a esses projetos desde o início. Quando a mesma aplicação precisa posteriormente verificar códigos de barras recebidos, processar documentos digitalizados ou decodificar códigos de barras de PDFs carregados, o Código de barras não oferece uma solução. A equipe deve avaliar uma segunda biblioteca, aprender sua API, gerenciar sua versão NuGet separadamente e lidar com a superfície de integração entre as duas bibliotecas. As equipes que chegam a esse ponto geralmente consolidam suas operações em uma biblioteca que lida com ambos os lados, em vez de manter duas dependências de código de barras separadas.

Quebra de compatibilidade com o .NET Framework

Barcoder.Renderer.Image removeu o suporte ao .NET Framework. Equipes que mantêm serviços ou aplicativos de desktop no.NET Framework4.x e que atualizam o pacote de renderização de imagens durante a manutenção rotineira de dependências encontram uma falha na compilação. Isso não é uma configuração incorreta — é uma decisão da biblioteca relacionada ao suporte da plataforma. OIronBarcodeé compatível com o.NET Framework4.6.2 até o .NET 9 sem necessidade de empacotamento especial ou dependências condicionais para diferentes plataformas.

A diferença entre versões de pacotes cria problemas de coordenação.

Com Barcoder e Barcoder.Renderer.Image versionados independentemente, atualizar um sem o outro durante uma atualização de dependências pode introduzir incompatibilidades sutis. Em um repositório com múltiplos projetos — cada um consumindo uma versão diferente de cada pacote de renderização — garantir um comportamento consistente entre os projetos torna-se um problema de coordenação que cresce com o tamanho da equipe. Equipes que adotaram oIronBarcoderelatam que gerenciar um único pacote e uma única versão elimina completamente esse tipo de problema.

A cobertura de formatos se expande ao longo do tempo.

Um projeto pode começar com etiquetas Code128 e, posteriormente, adicionar códigos QR para links voltados para o cliente e, em seguida, DataMatrix para requisitos de conformidade. Com o Barcoder, cada adição de formato significa uma nova importação de namespace, uma classe de codificador diferente com parâmetros de método diferentes e, potencialmente, um novo pacote NuGet . Com o IronBarcode, adicionar um formato é uma alteração no valor da enumeração BarcodeEncoding em uma chamada existente. Equipes com planos que incluem a expansão da cobertura de formatos de código de barras consideram o modelo baseado em enumerações significativamente mais fácil de manter.

Requisitos de implantação MAUI e multiplataforma

O Código de barras não documenta suporte para implantações em MAUI, Docker, AWS Lambda ou Azure. Equipes que desenvolvem aplicativos MAUI multiplataforma ou implementam processamento de código de barras em infraestrutura sem servidor descobrem que a documentação e os testes do Código de barras não abrangem esses objetivos. AIronBarcodedocumenta e testa ativamente a implementação em dispositivos iOS, Android, Windows, macOS (MAUI), contêineres Docker e nas principais plataformas de nuvem.

A alteração do tipo IBarcode para GeneratedBarcode

O código do leitor de código de barras que armazena uma variável IBarcode e a passa para um renderizador posteriormente precisa ser refatorado. Em IronBarcode, GeneratedBarcode possui seus próprios métodos de saída — não há uma etapa de renderização separada. Qualquer assinatura de método que atualmente aceite IBarcode deve ser alterada para aceitar GeneratedBarcode, e a chamada de renderização dentro desse método deve se tornar uma chamada direta como .SaveAsPng() ou .ToPngBinaryData(). O sistema de tipos revelará todos os locais que precisam ser atualizados durante a compilação — IBarcode não será resolvido após a remoção dos pacotes Barcoder.

PixelSize Não possui equivalente direto

O código PixelSize do leitor de código de barras é um multiplicador de escala no tamanho do módulo natural do código de barras, e não uma dimensão explícita em pixels. A largura de saída depende do conteúdo do código de barras, do formato e do multiplicador em combinação.IronBarcodeusa @@--CÓDIGO-63685--@@ com dimensões de pixel explícitas. Durante a migração, meça as dimensões reais de saída que o código Código de barras existente produz e use esses valores na chamada .ResizeTo():

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

Consolidação de Namespaces

Os projetos de código de barras acumulam declarações using Barcoder.* — uma por formato usado. Durante a migração, todos estes se condensam em um único using IronBarCode;. Uma busca por using Barcoder em toda a solução identificará todos os arquivos que precisam ser atualizados. O número de arquivos afetados costuma ser maior do que as equipes esperam, porque cada arquivo que utiliza um formato de código de barras importa seu próprio namespace específico do formato.

Alterações no caminho de saída SVG

Projetos que utilizam Barcoder.Renderer.Svg e a classe SvgRenderer substituem o pipeline de renderização por uma chamada de método direta em GeneratedBarcode:

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

O pacote Barcoder.Renderer.Svg pode ser removido assim que todos os sites de renderização SVG forem migrados.