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;

// Constructor takes the path to the runtime files (e.g. ".").
var barcodeXpress = new BarcodeXpress(".");

// Step 1: SDK license (for development).
// SetSolutionName and SetSolutionKey are methods, not properties.
// SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName");
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

// Step 2: OEM/runtime license (for production — minimum 5 purchased).
try
{
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString");
}
catch (Exception ex)
{
    // Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}");
}

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

// Constructor takes the path to the runtime files (e.g. ".").
var barcodeXpress = new BarcodeXpress(".");

// Step 1: SDK license (for development).
// SetSolutionName and SetSolutionKey are methods, not properties.
// SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName");
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

// Step 2: OEM/runtime license (for production — minimum 5 purchased).
try
{
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString");
}
catch (Exception ex)
{
    // Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}");
}

Imports Accusoft.BarcodeXpressSdk

' BarcodeXpress: two separate license keys required

' Constructor takes the path to the runtime files (e.g. ".").
Dim barcodeXpress As New BarcodeXpress(".")

' Step 1: SDK license (for development).
' SetSolutionName and SetSolutionKey are methods, not properties.
' SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName")
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)

' Step 2: OEM/runtime license (for production — minimum 5 purchased).
Try
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString")
Catch ex As Exception
    ' Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}")
End Try

El par SetSolutionKey activa el propio SDK. La llamada SetOEMLicenseKey activa las capacidades de despliegue de producción. Ambos deben estar presentes y ser válidos para que un despliegue de producción devuelva valores de código de barras sin el sello " UNLICENSED accusoft.com ".

En la revisión de código, este patrón produce una pregunta predecible: "¿Por qué tenemos dos activaciones de licencia separadas?" La respuesta: que Accusoft trata el licenciamiento del SDK y el licenciamiento 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.

Sin una licencia OEM válida, SetOEMLicenseKey lanza una excepción y el SDK vuelve al modo de evaluación. Los equipos generalmente envuelven la activación en try/catch para que la falla se registre ruidosamente en lugar de producir silenciosamente valores de códigos de barras estampados en producción:

try
{
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey);
}
catch (Exception ex)
{
    // In evaluation mode, barcode values are stamped with
    // " UNLICENSED accusoft.com " in the output.
    throw new InvalidOperationException(
        "OEM license activation failed — barcode values will be stamped", ex);
}

try
{
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey);
}
catch (Exception ex)
{
    // In evaluation mode, barcode values are stamped with
    // " UNLICENSED accusoft.com " in the output.
    throw new InvalidOperationException(
        "OEM license activation failed — barcode values will be stamped", ex);
}

Try
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey)
Catch ex As Exception
    ' In evaluation mode, barcode values are stamped with
    ' " UNLICENSED accusoft.com " in the output.
    Throw New InvalidOperationException("OEM license activation failed — barcode values will be stamped", ex)
End Try

Este guardia es el patrón que los equipos añaden cuando se dan cuenta de que la salida en modo de evaluación estampa silenciosamente los resultados en lugar de lanzar durante la decodificación.

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.SetSolutionName("AcmeCorp");
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

        // Layer 2: OEM/runtime license — separate purchase, minimum 5
        try
        {
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");
        }
        catch (Exception ex)
        {
            throw new InvalidOperationException(
                "OEM license activation failed — barcode values will be stamped", ex);
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

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

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

        // Layer 2: OEM/runtime license — separate purchase, minimum 5
        try
        {
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");
        }
        catch (Exception ex)
        {
            throw new InvalidOperationException(
                "OEM license activation failed — barcode values will be stamped", ex);
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress(".")

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SetSolutionName("AcmeCorp")
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)

        ' Layer 2: OEM/runtime license — separate purchase, minimum 5
        Try
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString")
        Catch ex As Exception
            Throw New InvalidOperationException("OEM license activation failed — barcode values will be stamped", ex)
        End Try
    End Sub
End Class

Este constructor existe completamente para gestionar dos activaciones de licencia separadas antes de que cualquier operación de código de barras pueda tener lugar. El try/catch alrededor de SetOEMLicenseKey no es opcional, sin él, el servicio devolverá silenciosamente valores estampados en cualquier entorno donde la clave OEM falte o esté mal configurada.

Enfoque IronBarcode

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

Esa es la configuración completa del licenciamiento. No hay 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 requiere cargar la imagen en un System.Drawing.Bitmap, asignar el conjunto de simbologías a reader.BarcodeTypes como un System.Array de valores BarcodeType, y llamar a Analyze(bitmap) para recuperar resultados. El SDK no lee PDFs directamente - los formatos de entrada documentados son TIFF, JPEG, PNG, y BMP:

using Accusoft.BarcodeXpressSdk;
using System.Drawing;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress(".");
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");

    using var bitmap = new Bitmap(imagePath);

    // BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
    // enum). Pass Enum.GetValues to scan for everything, or assign a
    // narrower array to restrict the search space.
    barcodeXpress.reader.BarcodeTypes = new[]
    {
        BarcodeType.Code128Barcode,
        BarcodeType.DataMatrixBarcode,
        BarcodeType.QRCodeBarcode
    };

    Result[] results = barcodeXpress.reader.Analyze(bitmap);
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;
using System.Drawing;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress(".");
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");

    using var bitmap = new Bitmap(imagePath);

    // BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
    // enum). Pass Enum.GetValues to scan for everything, or assign a
    // narrower array to restrict the search space.
    barcodeXpress.reader.BarcodeTypes = new[]
    {
        BarcodeType.Code128Barcode,
        BarcodeType.DataMatrixBarcode,
        BarcodeType.QRCodeBarcode
    };

    Result[] results = barcodeXpress.reader.Analyze(bitmap);
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Drawing

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress(".")
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp")
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString")

    Using bitmap As New Bitmap(imagePath)
        ' BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
        ' enum). Pass Enum.GetValues to scan for everything, or assign a
        ' narrower array to restrict the search space.
        barcodeXpress.Reader.BarcodeTypes = New BarcodeType() {
            BarcodeType.Code128Barcode,
            BarcodeType.DataMatrixBarcode,
            BarcodeType.QRCodeBarcode
        }

        Dim results As Result() = barcodeXpress.Reader.Analyze(bitmap)
        Return results.Select(Function(r) r.BarcodeValue)
    End Using
End Function

Analyze toma un Bitmap y devuelve un Result[]. Si un documento contiene un formato no presente en el array BarcodeTypes, no se encontrará. Esto se convierte en una carga de mantenimiento cuando cambian las fuentes de los documentos. Los PDFs requieren pre-renderización a imágenes con una biblioteca separada antes de que puedan ser alimentados en Analyze.

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 mantiene 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;
using System.Drawing;

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

    foreach (var path in imagePaths)
    {
        using var bitmap = new Bitmap(path);

        _barcodeXpress.reader.BarcodeTypes = new[]
        {
            BarcodeType.Code128Barcode,
            BarcodeType.QRCodeBarcode
        };

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

    return results;
}

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

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

    foreach (var path in imagePaths)
    {
        using var bitmap = new Bitmap(path);

        _barcodeXpress.reader.BarcodeTypes = new[]
        {
            BarcodeType.Code128Barcode,
            BarcodeType.QRCodeBarcode
        };

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

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic
Imports System.Drawing

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
        Using bitmap As New Bitmap(path)
            _barcodeXpress.reader.BarcodeTypes = New BarcodeType() {
                BarcodeType.Code128Barcode,
                BarcodeType.QRCodeBarcode
            }

            Dim barcodes = _barcodeXpress.reader.Analyze(bitmap)
            If barcodes.Length > 0 Then
                results(path) = barcodes(0).BarcodeValue
            End If
        End Using
    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 mantienen 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 lectura, la clase BarcodeReaderOptions proporciona configuraciones de 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. Usa ReadingSpeed.Faster para pipelines de alto rendimiento donde 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 que una instancia BarcodeXpress sea creada y licenciada antes de cualquier operación. Los métodos estáticos de IronBarcode no necesitan instanciarse. Los equipos que migran típicamente tienen una clase BarcodeService cuyo constructor es principalmente plantillas de licenciamiento — después de la migración, ese constructor puede ser eliminado por completo o reducido a la asignación de una sola clave de licencia.

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

Cada operación de lectura con BarcodeXpress requiere una asignación de Array BarcodeTypes para enumerar qué simbologías buscar. IronBarcode detecta automáticamente todos los formatos compatibles por defecto. Durante la migración, todas las asignaciones de reader.BarcodeTypes = ... se pueden eliminar 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 predeterminado requerido.

Cambios en el nombre de la propiedad de resultado

Dos cambios de nombre de propiedad afectan a todo el código de procesamiento de resultados: result.BarcodeValue se convierte en result.Value, y result.BarcodeType se 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 se pueden usar para un filtrado adicional sin cambios en el código para 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 implica eliminar la instrucción COPY para el archivo de configuración y agregar una sola 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.