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

API de geração Barcode4NET

O fluxo de trabalho completo de geração no Barcode4NET utilizava um padrão de configuração de propriedades:

// Barcode4NET — manual DLL,.NET Frameworkonly
// Não Pacote NuGet — requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

// Barcode4NET — manual DLL,.NET Frameworkonly
// Não Pacote NuGet — requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Dim barcode As New Barcode4NET.Barcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.Width = 300
barcode.Height = 100
Dim barcodeImage As Bitmap = barcode.GenerateBarcode()
barcodeImage.Save(outputPath, ImageFormat.Png)

Isso representa toda a extensão da superfície da API Barcode4NET. A biblioteca não oferecia encadeamento fluente, capacidade de leitura, saída em PDF nem opções avançadas de código QR, como incorporação de logotipo ou controle de correção de erros.

Comparação Detalhada de Recursos

Abordagem Barcode4NET

O Barcode4NET utilizava um padrão imperativo de configuração de propriedades. Os desenvolvedores instanciaram um objeto Barcode, atribuíram propriedades individuais e chamaram GenerateBarcode() para receber um System.Drawing.Bitmap:

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Public Function GenerateLabel(sku As String) As Bitmap
    Dim barcode As New Barcode4NET.Barcode()
    barcode.Symbology = Symbology.Code128
    barcode.Data = sku
    barcode.Width = 400
    barcode.Height = 120
    Return barcode.GenerateBarcode()
End Function

O tipo de retorno — System.Drawing.Bitmap — significava que o código de chamada era responsável por salvar, exibir ou transmitir a imagem. Isso era apropriado para aplicativos WinForms, onde um Bitmap podia ser atribuído diretamente a um PictureBox, mas exigia etapas de conversão adicionais para qualquer outro destino de saída.

Abordagem do IronBarcode

IronBarcode utiliza uma API estática fluente. Uma única chamada de método inicia a geração, e métodos encadeáveis ​​configuram o resultado antes de um método de salvamento ou conversão no terminal:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateLabel(sku As String) As Byte()
    Return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .ToPngBinaryData()
End Function

A enumeração BarcodeEncoding corresponde diretamente à enumeração Symbology. .ResizeTo() substitui as atribuições de propriedade Width e Height. Métodos terminais — .SaveAsPng(), .SaveAsJpeg(), .ToPngBinaryData() — substituem as chamadas separadas GenerateBarcode() e bitmap-save. Para cenários de geração mais avançados, consulte a documentação de geração de código de barras do IronBarcode .

Abordagem Barcode4NET

O Barcode4NET não possuía uma API de leitura. As equipes que precisavam decodificar códigos de barras a partir de imagens ou documentos digitalizados tinham que integrar uma biblioteca completamente separada — seja o ZXing .NET, uma alternativa de código aberto, ou um SDK de scanner comercial. O resultado foram duas cadeias de dependência separadas: Barcode4NET para geração e uma segunda biblioteca para leitura.

Abordagem do IronBarcode

IronBarcode fornece BarcodeReader.Read() como um método estático que aceita caminhos de arquivos de imagem, objetos de fluxo e documentos PDF:

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

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

' Read all barcodes from a multi-page PDF — no extra PDF library required
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

Para cenários com grande volume de imagens ou imagens ruidosas, a classe BarcodeReaderOptions oferece controle sobre a velocidade de leitura e a detecção de múltiplos códigos de barras. Consulte a documentação de leitura de código de barras para obter opções de configuração.

Abordagem Barcode4NET

O Barcode4NET foi compilado usando assemblies do.NET Framework. Ele funcionava no Windows, em aplicações.NET Framework, em projetos Web Forms e Windows Forms hospedados no IIS. Não havia versões para Linux, nem versões para .NET Core , nem suporte para ambientes de execução em nuvem. Quando a Microsoft lançou o .NET Core e posteriormente unificou a plataforma como .NET 5+, o Barcode4NET não recebeu atualizações correspondentes. Qualquer projeto direcionado à versão net5.0 ou posterior não poderia referenciar a biblioteca de forma alguma.

O modelo de distribuição de DLLs agravou a restrição da plataforma. Em todos os ambientes de compilação — estação de trabalho do desenvolvedor, agente de compilação, contêinerDocker— era necessário que a DLL estivesse presente em um caminho conhecido. Em implantações baseadas em contêineres, isso significava ou incorporar a DLL em uma imagem base personalizada ou copiá-la durante a construção do contêiner, nenhum dos quais é compatível com os fluxos de trabalho padrão.

Abordagem do IronBarcode

OIronBarcodeé compatível com várias estruturas (frameworks) a partir de um único pacote NuGet :.NET Framework4.6.2 até .NET 9, e todas as versões atuais do .NET no Windows, Linux e macOS. A implantação em contêineresDockerutiliza as imagens de tempo de execução .NET padrão, sem modificações. O Azure Functions, o AWS Lambda e outros ambientes de execução sem servidor são suportados pelo mesmo pacote NuGet . O comando dotnet restore resolve todas as dependências sem qualquer gerenciamento manual de DLLs.

Abordagem Barcode4NET

O Barcode4NET chegou ao fim de sua vida útil. Novas licenças não estão disponíveis através da ComponentSource ou de qualquer outro canal. Se um desenvolvedor se juntar a uma equipe que utiliza o Barcode4NET, não há nenhum mecanismo para comprar uma licença para ele. Dependendo da estrutura das licenças existentes, um novo desenvolvedor pode não ter permissão legal para executar ou depurar código relacionado a códigos de barras durante o desenvolvimento. Não existe um sistema de rastreamento de problemas, nenhum canal de suporte e nenhum fornecedor para contatar em relação a defeitos. Vulnerabilidades de segurança descobertas após a última versão permanecem sem solução.

Abordagem do IronBarcode

IronBarcode é um produto comercial com manutenção ativa e licença perpétua. Os planos começam em US$ 749 para uma licença Lite para um único desenvolvedor, com planos Plus (US$ 1.499, 3 desenvolvedores), Professional (US$ 2.999, 10 desenvolvedores) e Unlimited (US$ 5.999) disponíveis. Todos os planos incluem implantação livre de royalties. Atualizações de segurança, correções de bugs e atualizações de compatibilidade com a versão do .NET são lançadas regularmente. Está disponível um período de teste gratuito de 30 dias para avaliação, sem necessidade de chave de licença.

Atualização do .NET bloqueada

O evento que mais frequentemente desencadeia essa situação é um projeto de modernização do .NET . Uma equipe tem como alvo o código net8.0 em seu código .csproj, executa a compilação e encontra um erro de compilação porque o Barcode4NET foi compilado com assemblies do.NET Frameworkque não são mais referenciados. O erro é inequívoco: a biblioteca não será carregada na nova estrutura de destino. Neste ponto, a equipe se depara com uma escolha binária: reverter a alteração da estrutura de destino e permanecer no.NET Frameworkou substituir o Barcode4NET. A migração não pode ser adiada sem bloquear o esforço de modernização mais amplo.

Falhas no pipeline de CI/CD após alterações na infraestrutura

O modelo de distribuição de DLLs do Barcode4NET cria uma fragilidade latente nos pipelines de compilação. Quando um agente de compilação é reaprovisionado, uma imagem de contêiner é atualizada ou um novo ambiente de CI é configurado, a DLL do Barcode4NET deve ser colocada manualmente no caminho esperado pelo arquivo de projeto. As equipes que não documentaram cuidadosamente essa etapa só descobrem o problema quando o pipeline falha. A transição para oIronBarcodesignifica que dotnet restore cuida de tudo — o problema de localização da DLL deixa de existir.

Novos membros da equipe não podem ser licenciados.

Quando um contratado se junta ao projeto ou um segundo desenvolvedor precisa trabalhar em recursos de código de barras, não há licença para comprar. A equipe precisa encontrar uma solução para essa restrição — ou o novo desenvolvedor evita completamente o código de barras, ou alguém transfere uma licença que pode não ser legalmente transferível de acordo com os termos originais. Nenhuma das duas situações é sustentável para uma equipe que está desenvolvendo ativamente o produto.

Auditorias de segurança e conformidade

Organizações que executam a geração de listas de materiais de software ou verificam dependências em relação a bancos de dados de fim de vida útil encontram o Barcode4NET como uma descoberta. É um produto comercial sem fornecedor ativo, sem rastreamento de CVE e sem disponibilidade de patches. Os auditores de segurança tratam as dependências comerciais em fim de vida útil de forma diferente das bibliotecas de código aberto consolidadas — a ausência de um processo de resposta do fornecedor significa que qualquer vulnerabilidade permanece permanentemente sem mitigação. Normalmente, isso se torna um item formal de remediação, em vez de um risco adiado.

Capacidade de leitura adicionada a um fluxo de trabalho existente

As equipes que inicialmente usavam o Barcode4NET apenas para fluxos de trabalho de geração de códigos de barras descobrem posteriormente que precisam verificar códigos de barras em documentos digitalizados, processar imagens enviadas pelo usuário ou extrair dados de faturas em PDF. Com o Barcode4NET, isso requer a integração de uma segunda biblioteca. O pacote BarcodeReader.Read() doIronBarcodelida com imagens e PDFs nativamente, consolidando a dependência em um único pacote com suporte.

Removendo a referência da DLL

O Barcode4NET nunca foi distribuído como um pacote NuGet, portanto não existe o comando dotnet remove package. Cada arquivo .csproj que faz referência à biblioteca contém um elemento <Reference Include="Barcode4NET"> com um <HintPath> apontando para a DLL no disco. Cada um desses elementos deve ser encontrado e removido manualmente. Uma busca com o comando grep na solução os localiza:

grep -rl "Barcode4NET" --include="*.csproj" .

grep -rl "Barcode4NET" --include="*.csproj" .

O diretório DLL no controle de versão — normalmente ThirdParty/Barcode4NET/ ou lib/ — também deve ser preparado para exclusão com git rm.

Alteração do tipo de retorno de Bitmap para matriz de bytes

O código GenerateBarcode() do Barcode4NET retorna um código System.Drawing.Bitmap. A cadeia fluente doIronBarcodetermina em .ToPngBinaryData() retornando byte[], ou .SaveAsPng() escrevendo diretamente no disco. O código que atribui o valor de retorno a uma variável do tipo Bitmap ou o passa para um método que espera um Bitmap — como um WinForms PictureBox — requer um ajuste de uma linha no local da chamada: envolva a matriz de bytes em um MemoryStream e chame Image.FromStream().

Simbologia Enum Renomear

A enumeração Symbology no Barcode4NET corresponde diretamente à enumeração BarcodeEncoding no IronBarcode. Todos os valores comuns — Code128, Code39, EAN13, UPCA, QRCode — mantêm seus nomes. Uma operação de localizar e substituir em toda a solução de Symbology. por BarcodeEncoding. abrange a maioria dos casos, embora cada substituição deva ser revisada para confirmar o contexto.

Limpeza do script de compilação

Os scripts de compilação e os arquivos de configuração de CI/CD que copiam a DLL do Barcode4NET para diretórios de saída ou agentes de compilação precisam ser atualizados. Essas etapas não têm equivalente após a migração para o NuGet — dotnet restore substitui todo o gerenciamento manual de DLLs. Deixar etapas obsoletas de cópia de DLLs após a migração não causará falhas na compilação, mas representa uma configuração desatualizada que gera confusão para futuros responsáveis ​​pela manutenção.