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

Requisito de Especificação de Tipo

O método BarcodeScanner.Scan() da classe Spire.Barcode não possui nenhuma sobrecarga que aceite apenas um caminho de arquivo. Toda operação de leitura exige que o código que a invoca declare o formato do código de barras antecipadamente. Para fluxos de trabalho de formato único, isso funciona, mas para o processamento de documentos de formato misto, gera um possível loop de iteração:

// Spire.Barcode: multi-format detection requires a guessing loop
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: multi-format detection requires a guessing loop
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

Cada tipo adicionado à matriz de candidatos representa uma passagem de varredura adicional. Qualquer formato ausente da lista faz falta, mesmo que silenciosamente. O desenvolvedor é responsável por manter um inventário de tipos completo e por realizar novos testes sempre que um novo formato entra no fluxo de trabalho.

Comparação Detalhada de Recursos

Abordagem Spire.Barcode

O parâmetro BarcodeScanner.Scan() da Spire.Barcode requer um parâmetro BarCodeType em todas as chamadas. A chamada de tipo único é apropriada quando o formato é conhecido e garantido:

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("barcode.png", BarCodeType.Code128)

For Each value As String In results
    Console.WriteLine(value)
Next

Quando o formato não é conhecido antecipadamente, a única abordagem disponível é iterar pelos tipos candidatos. Cada iteração consiste em uma varredura completa, e qualquer formato ausente da lista é ignorado silenciosamente. O resultado é um string[] que não contém informações de tipo, portanto, o roteamento subsequente baseado no formato requer gerenciamento de estado adicional por parte do chamador.

Abordagem do IronBarcode

O código BarcodeReader.Read() doIronBarcodenão requer nenhum parâmetro de tipo. A biblioteca detecta o formato automaticamente em todas as simbologias suportadas em uma única passagem. A leitura de códigos de barras a partir de imagens requer uma única chamada de método, independentemente da quantidade de formatos diferentes que a fonte possa conter:

//IronBarcode— auto-detection built in
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.BarcodeType}: {result.Value}");
}

//IronBarcode— auto-detection built in
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.BarcodeType}: {result.Value}");
}

Imports IronBarcode

'IronBarcode— auto-detection built in
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.BarcodeType}: {result.Value}")
Next

Cada objeto de resultado inclui BarcodeType, Value e metadados posicionais. O roteamento subsequente baseado no formato não requer nenhum estado adicional — o tipo está presente no próprio resultado.

Nível gratuito do Spire.Barcode

O FreeSpire.Barcode aplica uma grande marca d'água de avaliação às imagens de código de barras geradas. A marca d'água cobre o código de barras de uma forma que o torna inadequado para uso em produção e impede uma avaliação significativa da qualidade de geração. O desempenho de digitalização é intencionalmente reduzido na versão gratuita, o que significa que as medições de taxa de transferência feitas durante a avaliação não representam o desempenho comercial do Spire.Barcode. O pacote gratuito também requer uma chave de registro obtida da E-iceblue para que as caixas de diálogo de aviso sejam suprimidas durante a execução. O conjunto de simbologia disponível no plano gratuito é um subconjunto da oferta comercial. Essas restrições, em conjunto, significam que uma avaliação baseada no FreeSpire.Barcode não representa com precisão o que o produto comercial oferece.

Modo de avaliação do IronBarcode

A versão de avaliação doIronBarcodeé o pacote licenciado usado sem uma chave de licença. A leitura funciona em velocidade máxima, com suporte total de simbologia e sem restrições comportamentais. As opções de velocidade e precisão de leitura comportam-se da mesma forma nos modos de avaliação e licenciado. O código de barras gerado no modo de teste apresenta uma pequena marca d'água na borda da imagem; Não oculta o código de barras em si. O comportamento medido durante uma avaliação doIronBarcodeé o comportamento que é enviado para a produção.

Abordagem Spire.Barcode

O Spire.Barcode não possui capacidade nativa de leitura de PDF. Para extrair códigos de barras de um arquivo PDF, o desenvolvedor precisa instalar o pacote separado Spire.PDF, adquirir uma licença separada do Spire.PDF e escrever manualmente o código de iteração de página e extração de imagem antes que a leitura do código de barras possa começar:

// Spire.Barcode + Spire.PDF: two libraries, two licenses
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required even here
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: two libraries, two licenses
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required even here
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

Dim pdf As New PdfDocument()
pdf.LoadFromFile("document.pdf")

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required even here
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

Esse padrão requer dois pacotes NuGet , dois contratos de licença e código de gerenciamento de páginas escrito pelo desenvolvedor. Se os códigos de barras estiverem incorporados em conteúdo vetorial em vez de imagens rasterizadas dentro do PDF, a abordagem de extração de imagens pode não os detectar completamente.

Abordagem do IronBarcode

OIronBarcodeprocessa arquivos PDF nativamente, sem qualquer dependência adicional. A leitura de códigos de barras em documentos PDF é feita por meio de uma única chamada de método, utilizando a mesma API BarcodeReader.Read() usada para arquivos de imagem. Os números de página estão incluídos em cada objeto de resultado:

// IronBarcode: native PDF support, no additional library
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}");
}

// IronBarcode: native PDF support, no additional library
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}");
}

Imports IronBarcode

Dim results = BarcodeReader.Read("document.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}")
Next

Não é necessária a extração manual de páginas, nenhum pacote secundário e nenhuma compra de licença adicional.

Abordagem Spire.Barcode

O modelo de geração do Spire.Barcode centra-se num objeto de configuração mutável BarcodeSettings. Um desenvolvedor instancia as configurações, atribui propriedades individualmente, passa o objeto de configurações para um BarCodeGenerator e, em seguida, chama GenerateImage():

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("barcode.png", ImageFormat.Png)

O objeto de configurações mutável significa que as configurações podem ser compartilhadas acidentalmente entre chamadas quando uma única instância é reutilizada em várias operações de geração. A classe geradora adiciona uma etapa de instanciação adicional que não possui lógica de configuração própria.

Abordagem do IronBarcode

IronBarcode utiliza um método de fábrica estático com encadeamento fluente opcional. Não existe objeto de configurações nem instância de gerador para gerenciar:

//IronBarcodegeneration
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

//IronBarcodegeneration
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' IronBarcode generation
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

Códigos QR com logotipos personalizados estão disponíveis em todos os níveis de licença doIronBarcode:

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-with-logo.png")

Processamento de documentos em formato misto

Equipes que começam com um único formato de código de barras conhecido frequentemente descobrem que sua diversidade de formatos aumenta com o tempo. Um aplicativo de armazenagem que começou com etiquetas Code128 pode receber remessas de fornecedores usando códigos DataMatrix, GS1-128 ou QR Codes. Cada novo formato que entra no fluxo de trabalho exige a atualização da matriz de candidatos no loop de adivinhação de tipo, o novo teste da lógica de detecção e a confirmação de que nenhum formato existente foi substituído pela ordem de iteração. Quando a diversidade de formatos atinge um ponto em que a sobrecarga de manutenção desse ciclo se torna um custo de desenvolvimento recorrente, as equipes avaliam se a detecção automática eliminaria completamente esse ônus.

Integração de PDF

Aplicações que lidam com grande volume de documentos frequentemente se deparam com situações em que os códigos de barras precisam ser extraídos de arquivos PDF em vez de imagens independentes. Em um fluxo de trabalho Spire.Barcode, essa transição exige a aquisição de uma licença Spire.PDF, a integração de um segundo pacote e a criação de infraestrutura de iteração de página e extração de imagem antes que qualquer leitura de código de barras possa ocorrer. As equipes que não previram essa necessidade no momento da compra inicial se veem gerenciando duas licenças de produto e duas interfaces de API para uma tarefa que, conceitualmente, pertence à leitura de código de barras. A descoberta de que o suporte para PDF requer uma compra separada é um fator comum que leva à reavaliação da escolha do produto.

Limitações da avaliação do nível gratuito

Equipes que avaliaram o FreeSpire.Barcode e posteriormente adquiriram a licença comercial às vezes relatam que o produto comercial se comporta de maneira diferente daquela sugerida em sua avaliação. Isso é intencional: a versão gratuita degrada propositalmente o desempenho de leitura e restringe o conjunto de simbologias, o que significa que os testes de desempenho e de cobertura de formatos realizados durante a avaliação não são aplicáveis ​​à versão comercial. Quando uma equipe descobre essa discrepância após a compra, geralmente busca alternativas cujo comportamento durante o período de teste seja representativo do comportamento em produção.

Reduzindo a quantidade de produtos

Organizações que padronizam seu conjunto de tecnologias às vezes identificam o Spire.Barcode como um componente em um inventário crescente de produtos da E-iceblue, cada um com seu próprio custo de licença e ciclo de renovação. Se o principal objetivo do Spire.Barcode for a leitura de códigos de barras em um fluxo de processamento de documentos — em vez de uma integração profunda com o Spire.Doc ou o Spire.XLS — as equipes avaliam se uma biblioteca de códigos de barras independente reduziria a complexidade do licenciamento e a área de suporte necessária.

Removendo o parâmetro BarCodeType

Cada chamada scanner.Scan() em uma base de código Spire.Barcode carrega um argumento BarCodeType. Substituir essas chamadas por BarcodeReader.Read() remove completamente o parâmetro de tipo. Os loops de adivinhação de tipo — blocos foreach que iteram pelos valores candidatos BarCodeType — podem ser excluídos por completo; uma única chamada BarcodeReader.Read() substitui todo o loop.

Atualizando o tipo de retorno

Spire.Barcode's Scan() retorna string[].IronBarcoderetorna uma coleção BarcodeResults. Os sites de chamada que atribuem a string[] ou passam resultados para métodos que esperam esse tipo precisam ser atualizados. A extração de valores como uma matriz usa .Select(r => r.Value).ToArray(); O acesso ao primeiro resultado utiliza .First()?.Value.

Removendo o pacote Spire.PDF

Se o Spire.PDF foi instalado exclusivamente para dar suporte à extração de códigos de barras de arquivos PDF, ele pode ser removido após a migração para o IronBarcode. Todas as importações using Spire.Pdf; e blocos de iteração de página manual são substituídos por uma única chamada BarcodeReader.Read("file.pdf"). Se Spire.PDF for usado para outras operações de documento além da extração de código de barras, ele deverá ser mantido e apenas os caminhos de código relacionados ao código de barras deverão ser substituídos.

Alterações de namespace

Substitua using Spire.Barcode; por using IronBarCode;. A enumeração BarCodeType é substituída por BarcodeEncoding para geração e não requer equivalente para leitura. A inicialização da licença muda de BarcodeSettings.ApplyKey() ou Spire.License.LicenseProvider.SetLicenseKey() para uma única atribuição de propriedade IronBarCode.License.LicenseKey na inicialização do aplicativo.