API de geração Barcode4NET

O fluxo de trabalho completo de geração noBarcode4NETutilizava 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, suporte a QR Code, nem opções avançadas de 2D como incorporação de logotipo ou controle de correção de erros.

Comparação Detalhada de Recursos

Abordagem Barcode4NET

OBarcode4NETutilizava 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 poderia ser atribuído diretamente a um PictureBox, mas exigia etapas adicionais de conversão 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

O enum BarcodeEncoding corresponde diretamente ao enum Symbology. .ResizeTo() substitui as atribuições de propriedade Width e Height. Métodos terminais — .SaveAsPng(), .SaveAsJpeg(), .ToPngBinaryData() — substituem as chamadas de GenerateBarcode() e salvar bitmap separadamente. 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

OBarcode4NETnã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:Barcode4NETpara geração e uma segunda biblioteca para leitura.

Abordagem do IronBarcode

O 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 de imagem de alto volume ou barulhentos, a classe BarcodeReaderOptions fornece controle sobre a velocidade de leitura e a detecção de vários códigos de barras. Consulte a documentação de leitura de código de barras para obter opções de configuração.

Abordagem Barcode4NET

OBarcode4NETfoi 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+, oBarcode4NETnão recebeu atualizações correspondentes. Qualquer projeto que mire 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êiner, isso significava ou incorporar o DLL em uma imagem base personalizada ou copiá-lo durante a construção do contêiner, nenhuma das quais é compatível com fluxos de trabalho padrão de dotnet restore.

Abordagem do IronBarcode

O IronBarcode é 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 DLL.

Abordagem Barcode4NET

Barcode4NET está efetivamente no fim de vida. Novas licenças não são mais vendidas através do ComponentSource, embora os clientes existentes possam renovar Suporte e Atualizações de Software através do ComponentSource de acordo com os termos do fornecedor. Se um novo desenvolvedor entrar em uma equipe usando Barcode4NET, não há mecanismo para adquirir uma vaga adicional para ele. A última versão de código foi a versão 2.0 em 2007, então qualquer defeito ou problema de segurança descoberto desde essa versão não é endereçado por patch.

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 mira net8.0 em seu .csproj, executa a compilação, e encontra uma falha de carregamento porque oBarcode4NETfoi construído para.NET Framework1.1 / 2.0 / 3.x e não pode ser referenciado de um alvo .NET moderno. 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 doBarcode4NETcria 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 doBarcode4NETdeve 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 IronBarcode significa que dotnet restore lida com tudo — o problema de localização do 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 oBarcode4NETcomo uma descoberta. É um produto comercial sem lançamento de código desde 2007 e sem rastreamento de CVE ou fluxo de correções. Auditores de segurança geralmente tratam dependências neste estado de maneira diferente de bibliotecas mantidas ativamente, e a descoberta muitas vezes se torna um item de remediação formal ao invés de um risco adiado.

Capacidade de leitura adicionada a um fluxo de trabalho existente

As equipes que inicialmente usavam oBarcode4NETapenas 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. BarcodeReader.Read() do IronBarcode lida tanto com imagens quanto com PDFs nativamente, consolidando a dependência em um único pacote mantido.

Removendo a referência da DLL

OBarcode4NETnunca foi distribuído como um pacote NuGet, então não há comando dotnet remove package. Todo arquivo .csproj que referencia a biblioteca contém um elemento <Reference Include="Barcode4NET"> com um <HintPath> apontando para o 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 origem — tipicamente 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 GenerateBarcode() doBarcode4NETretorna um System.Drawing.Bitmap. A cadeia fluente do IronBarcode termina 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 PictureBox do WinForms — requer um ajuste de uma linha no local da chamada: envolver o array de bytes em um MemoryStream e chamar Image.FromStream().

Simbologia Enum Renomear

O enum Symbology noBarcode4NETmapeia diretamente para o enum BarcodeEncoding no IronBarcode. Todos os valores comuns — Code128, Code39, EAN13, UPCA, QRCode — mantêm seus nomes. Uma busca e substituição em toda a solução de Symbology. por BarcodeEncoding. cobre a maioria dos casos, embora cada substituição deva ser revista 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 doBarcode4NETpara 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 do NuGet — dotnet restore substitui todo o gerenciamento manual de DLL. 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.