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

Padrão de geração do núcleo do BarcodeLib

O fluxo de trabalho padrão de geração do Biblioteca de código de barras requer a criação de uma instância, a configuração de propriedades e a chamada de Encode():

@@--CÓDIGO-63539--@@`csharp // BarcodeLib using BarcodeLib; using System.Drawing; using System.Drawing.Imaging;

var b = new Barcode(); b.IncludeLabel = true; b.Width = 300; b.Height = 100; Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345"); img.Save("barcode.png", ImageFormat.Png); @@--CÓDIGO-63539--@@`

Este é o fluxo de trabalho completo de geração. O padrão de configuração de propriedade é o design: toda a configuração ocorre na instância antes da chamada Encode(), e o valor de retorno é um System.Drawing.Image que deve ser salvo separadamente ou convertido em bytes.

Comparação Detalhada de Recursos

Abordagem BarcodeLib

BarcodeLib requer a construção de uma instância e a definição de propriedades antes de chamar Encode(). A saída é um objeto System.Drawing.Image:

@@--CÓDIGO-63539--@@`csharp using BarcodeLib; using System.Drawing; using System.Drawing.Imaging;

public byte[] GenerateCode128(string data) { var b = new Barcode(); b.IncludeLabel = true; b.Width = 300; b.Height = 100; Image img = b.Encode(TYPE.CODE128, data);

using var ms = new MemoryStream();
img.Save(ms, ImageFormat.Png);
return ms.ToArray();

} @@--CÓDIGO-63539--@@`

O tipo de retorno System.Drawing.Image significa que a saída do array de bytes requer um intermediário MemoryStream. A propriedade IncludeLabel é um interruptor booleano — o Biblioteca de código de barras renderiza automaticamente a string de dados codificada como o rótulo visível abaixo das barras.

Abordagem do IronBarcode

A geração doIronBarcodeé totalmente estática. As cadeias de configuração após CreateBarcode() e os métodos de saída encerram a cadeia diretamente:

@@--CÓDIGO-63539--@@`csharp // NuGet: dotnet add package IronBarcode using IronBarCode;

public byte[] GenerateCode128(string data) { return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) .ResizeTo(300, 100) .AddAnnotationTextBelowBarcode(data) .ToPngBinaryData(); } @@--CÓDIGO-63539--@@`

.ToPngBinaryData() retorna o array de bytes diretamente — sem objeto intermediário Image ou MemoryStream. .AddAnnotationTextBelowBarcode() recebe a string do rótulo explicitamente, dando controle sobre qual texto aparece abaixo das barras. Para cenários de geração avançados, consulte a documentação de geração de código de barras do IronBarcode .

Abordagem BarcodeLib

BarcodeLib não possui uma API de leitura. Não existe nenhum método Decode(), Scan() ou ReadBarcode(). A ausência não se trata de uma diferença de versão — a leitura nunca fez parte do projeto da biblioteca. Qualquer tentativa de chamar um método de decodificação resulta em um erro de compilação:

@@--CÓDIGO-63539--@@`csharp // Biblioteca de código de barras — reading does not exist using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method // var value = b.Decode("barcode.png"); // CS1061: no definition // var value = b.Scan("barcode.png"); // CS1061: no definition // var value = b.ReadBarcode("barcode.png"); // CS1061: no definition

// The only thing you can do is generate: Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345"); // this works @@--CÓDIGO-63539--@@`

Equipes que precisam tanto da geração quanto da leitura de código de barras em conjunto com o Biblioteca de código de barras devem adicionar uma segunda biblioteca — normalmente o ZXing .NET — o que introduz sua própria carga de gerenciamento de dependências e uma segunda superfície de API para manter.

Abordagem do IronBarcode

BarcodeReader.Read() aceita arquivos de imagem, arquivos PDF, fluxos e objetos System.Drawing.Bitmap. A leitura de um PDF não requer nenhuma biblioteca adicional:

@@--CÓDIGO-63539--@@`csharp using IronBarCode;

// Read from an image var results = BarcodeReader.Read("barcode.png"); Console.WriteLine(results.First().Value); // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed var pdfResults = BarcodeReader.Read("invoice-batch.pdf"); foreach (var result in pdfResults) { Console.WriteLine($"Page {result.PageNumber}: {result.Value}"); }

// Tune reading for speed vs. thoroughness var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced, ExpectMultipleBarcodes = true }; var multiResults = BarcodeReader.Read("warehouse-scan.png", options); @@--CÓDIGO-63539--@@`

A enumeração ReadingSpeed permite ajustar o desempenho da varredura para cenários de alto volume. Para obter orientações sobre a configuração de leitura, consulte a documentação de leitura do IronBarcode .

Abordagem BarcodeLib

A partir da versão 3.x do BarcodeLib, a biblioteca introduziu o SkiaSharp como um backend gráfico para substituir o System.Drawing.Common, que se tornou exclusivo doWindowsapós o .NET 6. O Biblioteca de código de barras fixa-se a um intervalo de versões específico do SkiaSharp. Se um projeto já utiliza o SkiaSharp por meio de outra dependência — comum em projetos MAUI que utilizam SkiaSharp.Views.Maui e Microsoft.Maui.Graphics — a versão resolvida pode ficar fora do intervalo esperado pelo BarcodeLib. O resultado é, no mínimo, um aviso NU1608 e, na pior das hipóteses, uma falha na vinculação do assembly em tempo de execução:

@@--CÓDIGO-63539--@@ Aviso NU1608: Versão do pacote detectada fora da restrição de dependência: BarcodeLib 3.1.5 requer SkiaSharp (>= 2.88.7 e < 2.89.0), mas A versão SkiaSharp 3.116.1 foi resolvida. @@--CÓDIGO-63539--@@

Forçar uma resolução por meio de referências explícitas a pacotes adiciona complexidade sem garantia de sucesso:

@@--CÓDIGO-63539--@@`xml

@@--CÓDIGO-63539--@@`

Mesmo com substituições explícitas, a compatibilidade depende de as chamadas da API interna do Biblioteca de código de barras corresponderem ao que a versão fixada expõe. Não existe nenhum contrato de suporte que garanta uma correção dentro de um prazo que seja relevante para o projeto.

Abordagem do IronBarcode

OIronBarcodenão compartilha o gráfico de dependências do SkiaSharp com o código do aplicativo. Não há negociação de versões para gerenciar, nenhum erro NU1608 para diagnosticar e nenhum risco de vinculação de assembly em tempo de execução relacionado à resolução de versão do SkiaSharp. Projetos MAUI, projetos Blazor e qualquer outro aplicativo que dependa do SkiaSharp podem instalar oIronBarcodesem qualquer conflito de versão. Para padrões de integração específicos do MAUI, consulte a documentação doIronBarcodeMAUI .

A exigência de leitura aparece.

Um sistema que gera etiquetas de envio há meses recebe um novo requisito: o aplicativo também deve processar etiquetas devolvidas pelos fornecedores. A integração com o armazém precisa analisar os códigos de barras presentes nos manifestos de remessas de entrada. Um sistema de gerenciamento de documentos precisa indexar códigos de barras em PDFs digitalizados. A Biblioteca de código de barras não consegue atender a nenhum desses requisitos — a API de leitura não existe. A equipe avalia a possibilidade de adicionar o ZXing .NET junto com a BarcodeLib, pondera o ônus de manutenção de duas bibliotecas e os dois grafos de dependência separados, e decide que o caminho mais limpo é uma biblioteca que lide com a geração e a leitura em uma única instalação do NuGet .

Conflito SkiaSharp em um projeto MAUI

Uma equipe adiciona a biblioteca Biblioteca de código de barras a um aplicativo MAUI existente e imediatamente se depara com avisos NU1608 durante a restauração. Eles investigam, identificam a incompatibilidade de versão entre o intervalo SkiaSharp esperado pelo Biblioteca de código de barras e a versão exigida pelo MAUI, adicionam substituições explícitas <PackageReference> para forçar uma resolução e conseguem que a compilação seja aprovada. Em seguida, ocorre uma falha de execução no dispositivo quando os binários nativos do SkiaSharp carregam a versão errada. A correção requer uma investigação mais aprofundada do registro de vinculação do assembly. A mudança para oIronBarcoderesolve o conflito pela raiz — não encontrando uma versão compatível do SkiaSharp, mas eliminando completamente a dependência compartilhada.

Processamento de código de barras em PDF necessário

Aplicações que geram documentos PDF com códigos de barras incorporados — faturas, ordens de serviço, manifestos de envio — às vezes precisam ler esses códigos de barras novamente durante o processamento subsequente. O Biblioteca de código de barras gera imagens de código de barras, mas não oferece suporte a PDF em nenhuma das extremidades. A leitura de códigos de barras de um PDF com o Biblioteca de código de barras requer primeiro a renderização do PDF em imagens usando uma biblioteca PDF separada e, em seguida, a passagem dessas imagens para uma biblioteca de leitura também separada. OIronBarcodeprocessa toda a cadeia nativamente: BarcodeReader.Read("file.pdf") percorre todas as páginas e retorna todos os códigos de barras detectados sem uma etapa intermediária de renderização.

Os recursos do código QR superam a geração básica.

Projetos que inicialmente exigiam apenas a geração básica de códigos QR frequentemente evoluem para a necessidade de incorporação de logotipos, personalização de cores ou configuração de correção de erros. A Biblioteca de código de barras suporta códigos QR até TYPE.QR_Code, mas não oferece opções além das propriedades padrão Width, Height e IncludeLabel. O recurso QRCodeWriter doIronBarcodeexpõe a incorporação de logotipos, o controle de cores e o ajuste da correção de erros por meio de métodos encadeados. Equipes cujos requisitos de código QR ultrapassaram o que a implementação básica do Biblioteca de código de barras suporta descobrem que essa lacuna de recursos é o fator determinante para a decisão de migração.

API de instância para API fluente estática

O código Biblioteca de código de barras usa um padrão de objeto mutável: crie uma instância de Barcode, defina as propriedades e chame Encode().IronBarcodeusa um padrão fluente estático: chama BarcodeWriter.CreateBarcode(), encadeia métodos de configuração e termina com um método de saída. O código existente que armazena uma instância de Barcode como um campo ou a passa entre métodos precisará ser reestruturado. A alteração típica consiste em substituir o bloco de configuração de propriedades por uma cadeia de métodos:

@@--CÓDIGO-63539--@@csharp // The property setters on b become chained methods BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) .ResizeTo(300, 100) .AddAnnotationTextBelowBarcode(data) .SaveAsPng(outputPath); @@--CÓDIGO-63539--@@

Sistema.Desenho.Imagem para Saída Direta

BarcodeLib retorna System.Drawing.Image, que requer MemoryStream para produzir bytes. Qualquer código digitado para Image ou System.Drawing.Image precisará ser atualizado. A cadeia fluente doIronBarcodetermina diretamente com o formato de saída desejado — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — eliminando a necessidade do objeto de imagem intermediário e da etapa MemoryStream.

Enumeração TIPO para Enumeração de Codificação de Código de Barras

A Biblioteca de código de barras usa a classe TYPE com constantes em maiúsculas, como TYPE.CODE128.IronBarcodeusa o enum BarcodeEncoding com valores em PascalCase, como BarcodeEncoding.Code128. Os valores correspondem diretamente. Uma busca por TYPE\. em arquivos .cs identifica todas as ocorrências que precisam ser atualizadas, e uma operação sistemática de localizar e substituir abrange os formatos comuns: CODE128 → Code128, EAN13 → EAN13, UPCA → UPCA, QR_Code → QRCode.

Limpeza de referência SkiaSharp

Projetos que adicionaram entradas explícitas <PackageReference Include="SkiaSharp"> apenas para resolver os avisos NU1608 do Biblioteca de código de barras podem remover essas alterações após a migração para o IronBarcode. O comando dotnet list package --include-transitive confirma se o SkiaSharp ainda é necessário para outros pacotes no projeto antes de removê-lo.