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:

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);

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 leva um bool para includeChecksum, QrEncoder.Encode leva um nível de correção de erro e dois bools adicionais, e DataMatrixEncoder.Encode leva 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. Trocar formatos 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
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

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

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

// DataMatrix
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
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix
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 direciona toda a seleção de formato através do enum 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated 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-LICENSE-KEY";

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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 abrir um FileStream. Obter dados binários requer 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:

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' File output
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})
Using stream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Binary data via MemoryStream
Using ms = 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 do qual qualquer forma de saída pode ser alcançada através 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) leva dimensões de pixels 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

O IronBarcode abrange 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, matrizes 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 natively
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 natively
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 natively
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 deixou de suportar .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. O IronBarcode é compatível com o.NET Framework4.6.2 até o.NET 9sem 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ência pode introduzir sutis incompatibilidades. 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 o IronBarcode relatam 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 IronBarcode, adicionar um formato é uma alteração no valor enum 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. A IronBarcode documenta e testa ativamente a implementação em dispositivos iOS, Android, Windows, macOS (MAUI), contêineres Docker e nas principais plataformas de nuvem.

A mudança de tipo IBarcode para GeneratedBarcode

O código do Código de barras que armazena uma variável IBarcode e a passa a um renderizador posteriormente deve ser refatorado. Não IronBarcode, GeneratedBarcode possui seus próprios métodos de saída — não há uma etapa de renderizador separada. Qualquer assinatura de método que atualmente aceita IBarcode deve mudar 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 de atualização durante a compilação — IBarcode não será resolvido após a remoção dos pacotes do Barcoder.

PixelSize Não Tem Equivalente Direto

O PixelSize do Código de barras é um multiplicador de escala no tamanho natural do módulo de código de barras, não uma dimensão de pixel explícita. A largura de saída depende do conteúdo do código de barras, do formato e do multiplicador em combinação.IronBarcode usa .ResizeTo(width, height) com dimensões de pixels explícitas. Durante a migração, meça as dimensões reais de saída que o código existente do Código de barras 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 do Código de barras acumulam declarações using Barcoder.* — uma por formato usado. Durante a migração, todas essas se colapsam em um único using IronBarCode;. Uma busca por using Barcoder por toda a solução identificará todos os arquivos que precisam de atualização. 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 usando Barcoder.Renderer.Svg e a classe SvgRenderer substituem o pipeline de renderizador por uma chamada direta de método 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 uma vez que todos os locais de renderização SVG tiverem sido migrados.