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

O Sistema de Duas Chaves Explicado

A BarcodeXpress divide o licenciamento em duas camadas conceitualmente distintas:

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

Imports Accusoft.BarcodeXpressSdk

Dim barcodeXpress As New BarcodeXpress()
' Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName"
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
' Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"))

O par SolutionName e SolutionKey ativa o próprio SDK. A chamada UnlockRuntime, que recebe sua própria chave e sua própria chave de solução como argumentos separados, ativa os recursos de implantação em produção. Ambos devem estar presentes e válidos para que uma implantação em produção retorne valores de código de barras completos e sem obstruções.

Na revisão de código, esse padrão gera uma pergunta previsível: "Por que estamos chamando UnlockRuntime com duas chaves diferentes?" A resposta — que a Accusoft trata o licenciamento do SDK e o licenciamento de implantação como produtos separados com faturamento separado — nem sempre é óbvia na própria API. As equipes que fazem manutenção desse código seis meses após a configuração inicial geralmente precisam consultar a documentação para entender qual tecla corresponde a qual função.

A propriedade IsRuntimeUnlocked permite verificar se a camada de tempo de execução está ativa:

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

If Not barcodeXpress.Licensing.IsRuntimeUnlocked Then
    ' In this state, barcode values are partially obscured
    ' "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active")
End If

Essa verificação é a medida de segurança que as equipes adicionam quando percebem que a saída do modo de avaliação retorna silenciosamente dados parciais em vez de lançar uma exceção ou falhar claramente.

Comparação Detalhada de Recursos

Abordagem BarcodeXpress

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress()

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp"
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")

        ' Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime("RuntimeKey-XXXXXX", Convert.ToInt64("98765432109876"))

        ' Guard against partial-value mode
        If Not _barcodeXpress.Licensing.IsRuntimeUnlocked Then
            Throw New InvalidOperationException("Runtime license not active — barcode values will be obscured")
        End If
    End Sub
End Class

Este é um construtor de 15 linhas que existe exclusivamente para gerenciar dois sistemas de chave de licença separados antes que qualquer operação com código de barras possa ocorrer. A proteção IsRuntimeUnlocked não é opcional — sem ela, o serviço retornará silenciosamente valores degradados em qualquer ambiente onde a chave de tempo de execução esteja ausente ou mal configurada.

Abordagem do IronBarcode

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

' In Program.vb or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY"

Essa é a configuração completa de licenciamento. Sem desbloqueio de tempo de execução separado, sem nome de solução, sem chamada de dois argumentos UnlockRuntime. No Docker, isso se torna uma variável de ambiente lida na inicialização. Em um pipeline de CI/CD, é um segredo. Em um orquestrador de contêineres, trata-se de uma variável de ambiente injetada no pod.

Abordagem BarcodeXpress

A leitura com BarcodeXpress envolve a configuração do leitor através de SetPropertyValue, que recebe uma constante e um valor, e então a chamada de Analyze() para recuperar os resultados:

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress()
    barcodeXpress.Licensing.SolutionName = "AcmeCorp"
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"))

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath)
    barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.DataMatrixBarcode Or BarcodeType.QRCodeBarcode

    Dim results = barcodeXpress.reader.Analyze()
    Return results.Select(Function(r) r.BarcodeValue)
End Function

A constante cycBxeSetFilename é a forma que a API utiliza para especificar o arquivo a ser processado. Esse padrão — passar um identificador constante mais um valor para um método genérico SetPropertyValue — lembra APIs antigas baseadas em COM. Se um documento contiver um formato não listado em BarcodeTypes, ele não será encontrado. Isso se torna um custo adicional de manutenção quando as fontes de documentos mudam.

Abordagem do IronBarcode

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

Imports IronBarCode

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim results = BarcodeReader.Read(imagePath)
    Return results.Select(Function(r) r.Value)
End Function

OIronBarcodedetecta automaticamente o formato em todas as simbologias suportadas. Se a imagem contiver um código 128, um código QR e um DataMatrix, os três serão retornados na coleção de resultados sem qualquer alteração de configuração. Para maior controle sobre o comportamento de leitura, a classe BarcodeReaderOptions expõe configurações de velocidade, número de threads e múltiplos códigos de barras.

A leitura nativa de PDFs também está disponível pelo mesmo método:

using IronBarCode;

// Nativo PDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

using IronBarCode;

// Nativo PDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

Imports IronBarCode

' Nativo PDF support — no separate library needed
Dim results = BarcodeReader.Read("invoice-batch.pdf")

For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}")
Next

O BarcodeXpress não lê PDFs nativamente. Primeiro, você precisa renderizar cada página como uma imagem, usando uma biblioteca separada, e depois passar essas imagens para o leitor BarcodeXpress. Isso adiciona uma dependência, uma etapa de conversão e outro custo de licenciamento, dependendo da biblioteca de PDF escolhida.

Abordagem BarcodeXpress

BarcodeXpress é baseado em instâncias e seu objeto reader é stateful. O processamento paralelo requer uma instância por thread, com a inicialização completa da licença de duas camadas repetida em cada contexto de thread:

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic

Public Function ProcessBatch(imagePaths As IEnumerable(Of String)) As Dictionary(Of String, String)
    Dim results As New Dictionary(Of String, String)()

    For Each path In imagePaths
        _barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, path)
        _barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.QRCodeBarcode

        Dim barcodes = _barcodeXpress.reader.Analyze()
        If barcodes.Length > 0 Then
            results(path) = barcodes(0).BarcodeValue
        End If
    Next

    Return results
End Function

A Edição Padrão também impõe um limite máximo de 40 páginas por minuto. Um lote de 100.000 documentos a 40 PPM leva aproximadamente 41 horas para ser concluído. A Edição Professional remove esse limite, mas a um custo mais elevado por desenvolvedor — além das licenças de tempo de execução já adquiridas.

Abordagem do IronBarcode

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

//IronBarcode— parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

//IronBarcode— parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.Threading.Tasks

'IronBarcode— parallel batch with thread-safe static API
Dim files = Directory.GetFiles("/incoming/scans", "*.png")
Dim allResults = New ConcurrentBag(Of String)()

Parallel.ForEach(files, Sub(file)
    Dim r = BarcodeReader.Read(file)
    For Each barcode In r
        allResults.Add($"{file}: {barcode.Value}")
    Next
End Sub)

Como os métodos estáticos doIronBarcodenão têm estado, Parallel.ForEach sobre eles é seguro, sem necessidade de isolamento de instância. AIronBarcodenão impõe limite de produção em nenhum nível de preço. Para otimizar o desempenho de leitura, a classe BarcodeReaderOptions fornece as configurações ReadingSpeed e MaxParallelThreads:

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim results = BarcodeReader.Read("warehouse-scan.png", options)

ReadingSpeed.Balanced é o padrão. Use ReadingSpeed.Faster para fluxos de trabalho de alto rendimento onde os códigos de barras estão limpos, ou ReadingSpeed.Detailed para imagens danificadas ou de baixo contraste.

Superando a barreira dos 40 PPM

O limite da Edição Padrão de 40 páginas por minuto parece generoso até que uma equipe comercial decida executar um processamento em lote no final do dia em um ano inteiro de faturas arquivadas. Um lote de 100.000 documentos, nesse ritmo, leva aproximadamente 41 horas para ser concluído. A migração para a Edição Professional remove o limite, mas com um custo mais elevado por licença de desenvolvedor — além das licenças de tempo de execução já adquiridas. As equipes que descobrem o limite de produção após a assinatura de um pedido de compra frequentemente constatam que o custo total para removê-lo excede substancialmente as estimativas iniciais.

Complexidade do licenciamento do pipeline CI/CD

Uma configuração típica de CI/CD executa builds em contêineres efêmeros. Com o BarcodeXpress, cada ambiente de compilação precisa ter disponíveis tanto o par de chaves do SDK quanto as chaves de desbloqueio em tempo de execução, gerenciadas como segredos separados. Se a chave de tempo de execução estiver ausente ou mal configurada, a compilação pode ser bem-sucedida, mas os testes de integração retornarão valores ocultos — um modo de falha silencioso que é fácil de passar despercebido em um pipeline de testes se as asserções de teste não forem escritas cuidadosamente em relação ao conteúdo real do código de barras.

Requisitos de implantação em ambiente isolado e seguro

Alguns ambientes — como sistemas de saúde que processam registros de pacientes, fluxos de trabalho de documentos governamentais e processamento administrativo de instituições financeiras — não podem ter a validação de licenças para fazer chamadas de rede de saída. O sistema de licenciamento de tempo de execução do BarcodeXpress envolve a infraestrutura de licenciamento da Accusoft, o que pode representar um problema de conformidade em ambientes com restrições rigorosas de saída de rede. As equipes que operam nesses ambientes geralmente optam por bibliotecas cuja validação de licença é inteiramente local.

Implantação de contêineres e Docker

Normalmente, o BarcodeXpress no Docker exige que o contêiner monte um arquivo de licença em um caminho conhecido ou que configure um servidor de licenças e direcione o contêiner para ele. Ambas as abordagens aumentam a complexidade de implementação — os arquivos de licença precisam ser distribuídos e mantidos sincronizados, e um servidor de licenças é uma peça adicional de infraestrutura que precisa ser mantida. Equipes que migram para arquiteturas de microsserviços ou padrões de implantação sem servidor descobrem que a abordagem de arquivo de configuração não se traduz facilmente em imagens de contêiner imutáveis.

Requisitos de precisão da avaliação

Equipes que precisam validar a precisão de leitura em seus próprios documentos antes de efetuar uma compra consideram o modo de avaliação do BarcodeXpress fundamentalmente limitante. Os testes com base em digitalizações de documentos reais — verificando se a biblioteca lida bem com códigos de barras de baixo contraste, imagens distorcidas ou páginas com vários códigos de barras — exigem valores decodificados completos. A saída parcialmente oculta revela apenas que a biblioteca encontrou um código de barras, não se o leu corretamente.

Gerenciamento de instâncias para chamadas estáticas

O BarcodeXpress requer que uma instância BarcodeXpress seja criada e licenciada antes de qualquer operação. Os métodos estáticos doIronBarcodenão precisam de instância. As equipes em processo de migração geralmente possuem uma classe BarcodeService cujo construtor é basicamente código padrão de licenciamento — após a migração, esse construtor pode ser removido completamente ou reduzido a uma única atribuição de chave de licença.

Remoção da enumeração de tipos de código de barras

Cada operação de leitura do BarcodeXpress requer a atribuição de um sinalizador BarcodeTypes para enumerar quais simbologias devem ser pesquisadas. Por padrão, oIronBarcodedetecta automaticamente todos os formatos suportados. Durante a migração, todas as atribuições reader.BarcodeTypes = ... podem ser excluídas sem substituição. Se houver um motivo de desempenho para restringir o espaço de pesquisa, o BarcodeReaderOptions oferece suporte à filtragem de formato como uma opção explícita, em vez de um padrão obrigatório.

Alterações no nome da propriedade de resultado

Duas alterações de renomeação de propriedades afetam todo o código de processamento de resultados: @@--CÓDIGO-63235--@@ torna-se result.Value, e @@--CÓDIGO-63237--@@ torna-se result.Format. Uma função de busca e substituição em toda a solução resolve ambos os problemas. Os resultados doIronBarcodetambém expõem result.Confidence e result.PageNumber, que não têm equivalente no BarcodeXpress e podem ser usados para filtragem adicional sem alterações no código de tratamento de resultados existente.

Configuração de licença do Docker

As implementações do BarcodeXpress em Docker normalmente usam um arquivo de configuração de licença montado. OIronBarcodeusa uma variável de ambiente. A migração envolve a remoção da instrução COPY do arquivo de configuração e a adição de uma única atribuição de variável de ambiente. No Kubernetes, a chave de licença se torna uma referência secreta na especificação do pod, em vez de um volume montado.