Accusoft BarcodeXpress vs IronBarcode: Comparación de bibliotecas de códigos de barras C#

Explicación del sistema de dos teclas

BarcodeXpress divide la concesión de licencias en dos capas conceptualmente separadas:

// 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"))

El par SolutionName y SolutionKey activa el propio SDK. La llamada UnlockRuntime, que toma su propia clave y su propia clave de solución como argumentos separados, activa las capacidades de despliegue en producción. Ambos deben estar presentes y ser válidos para que una implementación en producción devuelva valores de código de barras completos y sin ocultar.

En la revisión de código, este patrón produce una pregunta predecible: "¿Por qué estamos llamando a UnlockRuntime con dos claves diferentes?" La respuesta -que Accusoft trata la licencia SDK y la licencia de implementación como productos separados con facturación separada- no siempre es obvia desde la propia API. Los equipos que mantienen este código seis meses después de su configuración inicial a menudo necesitan consultar la documentación para comprender qué clave corresponde a cada función.

La propiedad IsRuntimeUnlocked permite comprobar si la capa de tiempo de ejecución está activa:

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

Esta comprobación es la que añaden los equipos de seguridad cuando se dan cuenta de que la salida del modo de evaluación devuelve silenciosamente datos parciales en lugar de generar una excepción o fallar claramente.

Comparación detallada de características

Enfoque de 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

Se trata de un constructor de 15 líneas cuya única función es gestionar dos sistemas de claves de licencia independientes antes de que pueda realizarse cualquier operación con códigos de barras. La protección IsRuntimeUnlocked no es opcional - sin ella, el servicio devolverá silenciosamente valores degradados en cualquier entorno en el que falte la clave de tiempo de ejecución o esté mal configurada.

Enfoque 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"

Esta es la configuración completa de la licencia. Sin desbloqueo de tiempo de ejecución separado, sin nombre de solución, sin llamada UnlockRuntime de dos argumentos. En Docker, esto se convierte en una variable de entorno que se lee al iniciar. En una canalización de CI/CD, es un secreto. En un orquestador de contenedores, se trata de una variable de entorno que se inyecta en el pod.

Enfoque de BarcodeXpress

La lectura con BarcodeXpress implica configurar el lector a través de SetPropertyValue, que toma una constante y un valor, y luego llamar a Analyze() para recuperar los 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

La constante cycBxeSetFilename es la forma que tiene la API de especificar el archivo que se va a procesar. Este patrón (pasar un identificador constante más un valor a un método genérico SetPropertyValue) recuerda a las antiguas API basadas en COM. Si un documento contiene un formato no listado en BarcodeTypes, no será encontrado. Esto se convierte en una carga de mantenimiento cuando cambian las fuentes de los documentos.

Enfoque 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

IronBarcode detecta automáticamente el formato en todas las simbologías compatibles. Si la imagen contiene un código Code 128, un código QR y un DataMatrix, los tres se incluyen en la colección de resultados sin necesidad de modificar ninguna configuración. Para un mayor control sobre el comportamiento de lectura, la clase BarcodeReaderOptions expone ajustes de velocidad, número de subprocesos y compatibilidad con múltiples códigos de barras.

La lectura nativa de PDF también está disponible mediante el mismo método:

using IronBarCode;

// NativoPDF 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;

// NativoPDF 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

' NativoPDF 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

BarcodeXpress no lee archivos PDF de forma nativa. Primero, debes convertir cada página en una imagen utilizando una biblioteca independiente y, a continuación, pasar esas imágenes al lector de BarcodeXpress. Eso añade una dependencia, un paso de conversión y un coste de licencia adicional dependiendo de la biblioteca PDF elegida.

Enfoque de BarcodeXpress

BarcodeXpress está basado en instancias y su objeto reader tiene estado. El procesamiento paralelo requiere una instancia por hilo, con la inicialización completa de la licencia de dos capas repetida en cada contexto de hilo:

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

La edición estándar también impone un límite de 40 páginas por minuto. Procesar un lote de 100.000 documentos a una velocidad de 40 páginas por minuto (PPM) lleva aproximadamente 41 horas. La edición Professional elimina este límite, pero a un coste más elevado por desarrollador, además de las licencias de ejecución ya adquiridas.

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

Debido a que los métodos estáticos de IronBarcode no tienen estado, Parallel.ForEach sobre ellos es seguro sin necesidad de aislamiento de instancias. IronBarcode no impone ningún límite de rendimiento en ningún nivel de precios. Para ajustar el rendimiento de la lectura, la clase BarcodeReaderOptions proporciona las opciones ReadingSpeed y 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 es el predeterminado. Utilice ReadingSpeed.Faster para procesos de alto rendimiento en los que los códigos de barras están limpios, o ReadingSpeed.Detailed para imágenes dañadas o de bajo contraste.

Superando el límite de las 40 ppm

El límite de 40 páginas por minuto de la edición estándar parece generoso hasta que un equipo de negocios decide procesar por lotes al final del día las facturas archivadas de todo un año. Procesar un lote de 100.000 documentos a ese ritmo lleva aproximadamente 41 horas. Al pasar a la edición Professional , se elimina el límite, pero a un coste mayor por puesto de desarrollador, además de las licencias de ejecución ya adquiridas. Los equipos que descubren el límite de rendimiento después de firmar una orden de compra a menudo se encuentran con que el coste total de eliminarlo supera sustancialmente las estimaciones iniciales.

Complejidad de las licencias de la canalización CI/CD

Una configuración típica de CI/CD ejecuta las compilaciones en contenedores efímeros. Con BarcodeXpress, cada entorno de compilación necesita tener disponibles tanto el par de claves del SDK como las claves de desbloqueo en tiempo de ejecución, gestionadas como secretos independientes. Si la clave de ejecución falta o está mal configurada, la compilación puede tener éxito, pero las pruebas de integración devuelven valores ocultos: un modo de fallo silencioso que es fácil de pasar por alto en una canalización de pruebas si las aserciones de prueba no están escritas cuidadosamente en función del contenido real del código de barras.

Requisitos de implementación segura y aislada de la red

En algunos entornos, como los sistemas sanitarios que procesan historiales de pacientes, los flujos de trabajo de documentos gubernamentales y el procesamiento administrativo de las instituciones financieras, no se permite la validación de licencias para realizar llamadas salientes a la red. El sistema de licencias en tiempo de ejecución de BarcodeXpress utiliza la infraestructura de licencias de Accusoft, lo que puede suponer un problema de cumplimiento en entornos con estrictas restricciones de salida de red. Los equipos que operan en esos entornos suelen elegir bibliotecas cuya validación de licencias es totalmente local.

Implementación de contenedores y Docker

Normalmente, para usar BarcodeXpress en Docker, es necesario montar un archivo de licencia en el contenedor en una ruta conocida o configurar un servidor de licencias y apuntar el contenedor hacia él. Ambos enfoques añaden complejidad a la implementación: los archivos de licencia deben distribuirse y mantenerse sincronizados, y un servidor de licencias es una pieza adicional de infraestructura que mantener. Los equipos que migran a arquitecturas de microservicios o patrones de implementación sin servidor descubren que el enfoque de archivos de configuración no se traduce fácilmente en imágenes de contenedores inmutables.

Requisitos de precisión de la evaluación

Los equipos que necesitan validar la precisión de lectura de sus propios documentos antes de comprometerse con una compra consideran que el modo de evaluación de BarcodeXpress es fundamentalmente limitante. Las pruebas realizadas con escaneos de documentos reales —para comprobar si la biblioteca admite códigos de barras de bajo contraste, imágenes distorsionadas o páginas con varios códigos de barras— requieren valores decodificados completos. La salida parcialmente oculta solo revela que la biblioteca encontró un código de barras, no si lo leyó correctamente.

Gestión de instancias para llamadas estáticas

BarcodeXpress requiere la creación de una instancia BarcodeXpress y la obtención de una licencia antes de cualquier operación. Los métodos estáticos de IronBarcode no necesitan instanciarse. Los equipos que migran suelen tener una clase BarcodeService cuyo constructor es en gran parte una repetición de la licencia; tras la migración, ese constructor puede eliminarse por completo o reducirse a una única asignación de clave de licencia.

Eliminación de enumeración de tipos de código de barras

Cada operación de lectura de BarcodeXpress requiere una BarcodeTypes asignación de bandera para enumerar qué simbologías buscar. IronBarcode detecta automáticamente todos los formatos compatibles por defecto. Durante la migración, todas las asignaciones reader.BarcodeTypes = ...pueden eliminarse sin reemplazo. Si hay una razón de rendimiento para restringir el espacio de búsqueda, BarcodeReaderOptions admite el filtrado de formato como una opción explícita en lugar de un requisito por defecto.

Cambios en el nombre de la propiedad de resultado

Dos cambios de nombre de propiedades afectan a todo el código de procesamiento de resultados: result.BarcodeValuese convierte en result.Value, y result.BarcodeTypese convierte en result.Format. Una función de búsqueda y reemplazo a nivel de toda la solución resuelve ambos problemas. Los resultados de IronBarcode también exponen result.Confidence y result.PageNumber, que no tienen equivalente en BarcodeXpress y pueden utilizarse para filtrado adicional sin cambios de código en el manejo de resultados existente.

Configuración de licencia de Docker

Las implementaciones de BarcodeXpress en Docker suelen usar un archivo de configuración de licencia montado. IronBarcode usa una variable de entorno. La migración consiste en eliminar la instrucción COPY para el archivo config y añadir una única asignación de variable de entorno. En Kubernetes, la clave de licencia se convierte en una referencia secreta en la especificación del pod en lugar de un volumen montado.