La arquitectura del SDK dividido

Un proyecto que compra ambos SDKs de Neodynamic debe configurar dos bloques de licencia separados al inicio. Las asignaciones duales LicenseOwner y LicenseKey utilizan diferentes espacios de nombres y diferentes nombres de clases, y ninguno de los bloques es consciente del otro:

// Neodynamic: two products, two license configurations
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

// Neodynamic: two products, two license configurations
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

Imports Neodynamic.SDK.Barcode
Imports Neodynamic.SDK.BarcodeReader

' Neodynamic: two products, two license configurations

' Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company"
BarcodeProfessional.LicenseKey = "GEN-KEY"

' Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company"
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY"

Este patrón se repite en todos los entornos (desarrollo, pruebas y producción) y debe mantenerse siempre que se actualice o renueve cualquiera de los productos.

Comparación detallada de características

Enfoque neodinámico para lectores de códigos de barras

El lector de códigos de barras Neodynamic solo admite códigos de barras lineales. Cuando se introduce un código de barras 2D en el lector, el SDK devuelve un conjunto de resultados vacío o nulo. No se genera ninguna excepción ni aparece ningún mensaje de error que indique lo sucedido. Los equipos que trabajan con este SDK suelen descubrir la limitación después de implementar código que llama al lector en imágenes de códigos QR y observar que la colección de resultados siempre está vacía.

Un patrón defensivo común en las bases de código que utilizan Neodynamic Reader es una comprobación explícita que genera una excepción cuando se espera un formato 2D:

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

Imports Neodynamic.SDK.BarcodeReader
Imports System.Drawing

Public Function ReadQrCode(imagePath As String) As String
    Using bitmap As New Bitmap(imagePath)
        Dim reader As New BarcodeReader()
        Dim results = reader.Read(bitmap)

        ' Results will be null or empty — QR codes are not recognised by this SDK
        If results Is Nothing OrElse Not results.Any() Then
            Throw New NotSupportedException("Neodynamic Barcode Reader does not support QR codes")
        End If

        Return results.First().Value
    End Using
End Function

Este método no se puede completar únicamente con el SDK de Neodynamic Reader. El NotSupportedException no es una solución temporal: refleja el límite real de capacidad del lector para la entrada 2D.

Enfoque IronBarcode

IronBarcode lee todas las simbologías compatibles a través de la misma llamada BarcodeReader.Read(). El formato se detecta automáticamente a partir del contenido de la imagen. Un código QR, un código Code 128 y un código de barras DataMatrix utilizan el mismo código de llamada:

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

Imports IronBarCode

Public Function ReadQrCode(imagePath As String) As String
    ' QR codes, DataMatrix, PDF417 — all handled automatically
    Dim result = BarcodeReader.Read(imagePath).FirstOrDefault()
    Return If(result?.Value, Nothing)
End Function

La persona que realiza la llamada no especifica un formato esperado. IronBarcode identifica la simbología y devuelve el valor. Para obtener información completa sobre las opciones de lectura de imágenes, incluida la detección de múltiples códigos de barras y el preprocesamiento de imágenes, consulte la guía de lectura de códigos de barras a partir de imágenes .

Enfoque Professional del código de barras neodinámico

La API de generación de Neodynamic se basa en instancias. Se construye un objeto BarcodeProfessional, se asignan sus propiedades individualmente, y se llama a GetBarcodeImage() para devolver un System.Drawing.Image. La imagen se guarda entonces utilizando la enumeración System.Drawing.Imaging.ImageFormat:

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

Imports Neodynamic.SDK.Barcode
Imports System.Drawing

' Configure license first
BarcodeProfessional.LicenseOwner = "Your Company"
BarcodeProfessional.LicenseKey = "YOUR-KEY"

' Build the barcode through property assignment
Dim barcode As New BarcodeProfessional()
barcode.Code = "12345678"
barcode.Symbology = Symbology.Code128
barcode.BarcodeUnit = BarcodeUnit.Pixel

' Get image and save via System.Drawing
Dim image As Image = barcode.GetBarcodeImage()
image.Save("output.png", Imaging.ImageFormat.Png)

El SDK ofrece opciones de personalización legítimas, que incluyen control de DPI, alineación de texto, configuración de color y dimensionamiento de la zona silenciosa. Son útiles para flujos de trabajo de impresión donde las dimensiones físicas precisas son importantes. La capacidad de generación en sí misma está completa; Las limitaciones que impulsan la migración se encuentran en el lado de la lectura, no en el de la generación.

Enfoque IronBarcode

IronBarcode utiliza un enfoque estático fluido. La codificación y los datos se pasan como parámetros a BarcodeWriter.CreateBarcode(), y el formato de salida se expresa como un nombre de método en el objeto devuelto. No se requiere una importación de System.Drawing:

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("output.png")

Para la generación de códigos de barras 2D, la clase dedicada QRCodeWriter proporciona opciones adicionales específicas para códigos QR:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .SaveAsPng("qrcode.png")

Para obtener orientación sobre cómo generar simbologías 1D con opciones de tamaño y anotación, consulte la guía para crear códigos de barras 1D . Para la creación de códigos de barras 2D, incluidos DataMatrix y PDF417, consulte la guía para la creación de códigos de barras 2D .

Enfoque neodinámico

La funcionalidad de código de barras de Neodynamic se reparte entre dos productos con licencia independiente. El SDK de Barcode Professional se encarga de la generación y el SDK de Barcode Reader se encarga de la lectura. Cada producto requiere una compra por separado y tiene una clave de licencia independiente. Un equipo que compra ambos productos debe mantener dos bloques de configuración LicenseOwner / LicenseKey, rastrear dos fechas de renovación separadas y tratar con dos canales de soporte separados cuando surjan problemas.

El SDK Barcode Professional tiene un precio de aproximadamente $352 para una licencia de un solo desarrollador en la edición Basic y de aproximadamente $705 en la edición Ultimate (licencias de desarrollador a través de ComponentSource). El SDK de Lector de Códigos de Barras tiene un costo separado y se suministra bajo precios heredados: el producto fue marcado fin de vida útil el 31 de diciembre de 2019. Un proyecto que requiere lectura 2D no puede cumplir con ese requisito con productos de Neodynamic, ya que a cualquier precio se debe agregar una tercera biblioteca. Consulte la página de formatos de código de barras compatibles con IronBarcode para obtener una lista completa de lo que cubre una única licencia unificada.

Enfoque IronBarcode

IronBarcode se vende como un único producto que abarca todas las operaciones de códigos de barras (generación y lectura en todas las simbologías compatibles) bajo una sola clave de licencia. No se requiere una licencia de lector independiente, ni una licencia de generador independiente, ni ningún costo adicional por la compatibilidad con formatos 2D. La clave de licencia se configura una sola vez al iniciar la aplicación y no requiere ninguna configuración adicional:

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

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

Imports IronBarCode

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

IronBarcode Lite tiene un precio de 749 dólares para un solo desarrollador e incluye todas las funcionalidades. Para conocer los precios actuales y las opciones de volumen, consulte la página de licencias de IronBarcode .

Requisitos de lectura de códigos QR

El escenario más común que lleva a los equipos de Neodynamic a IronBarcode es el descubrimiento de que los códigos QR generados por el SDK de Barcode Professional no pueden ser leídos por el SDK de Barcode Reader. Los equipos que desarrollan sistemas de etiquetado de productos, herramientas de gestión de inventario o flujos de trabajo de seguimiento de documentos suelen implementar la generación y la lectura como fases separadas de un sistema más amplio. Cuando la generación se realiza primero con Barcode Professional, la limitación del lector solo se hace evidente cuando se intenta utilizar el componente de lectura. En ese momento, el proyecto ya se ha comprometido con Neodynamic para la generación, y agregar una tercera biblioteca para cubrir la lectura 2D introduce una complejidad en la gestión de versiones que no existiría con un SDK unificado.

Reducción de la complejidad del producto

Algunos equipos migran no por una brecha de formato específica, sino porque la sobrecarga de mantener dos productos separados para lo que conceptualmente es una sola funcionalidad se convierte en un punto de fricción recurrente. Dos paquetes en el archivo .csproj, dos ciclos de renovación de licencia, dos conjuntos de notas de lanzamiento para revisar y dos posibles fuentes de incompatibilidad cuando se aplican actualizaciones de .NET o Windows — ninguno de esos gastos generales proporciona funcionalidad más allá de lo que un único paquete unificado ofrecería. Los equipos que realizan una auditoría de dependencias como parte de una actualización de .NET a menudo identifican la disposición de doble paquete de Neodynamic como una oportunidad de simplificación.

Procesamiento de códigos de barras PDF

Las aplicaciones que procesan documentos PDF que contienen códigos de barras representan un escenario en el que ambos SDK de Neodynamic se quedan cortos simultáneamente. Ni el SDK de generación ni el SDK de lectura pueden abrir un archivo PDF y extraer los valores del código de barras de sus páginas. Los equipos que trabajan con manifiestos de envío, documentos de facturación, historiales médicos o cualquier flujo de trabajo de documentos en el que los códigos de barras estén incrustados en archivos PDF deben implementar un paso intermedio de extracción de imágenes antes de que se pueda realizar cualquier lectura. Ese paso de extracción requiere una biblioteca adicional, lo que significa que el proyecto ya incluye una tercera dependencia para solucionar una limitación que una sola instalación de IronBarcode eliminaría.

Coherencia de formato entre lectura y escritura

Los equipos que gestionan flujos de trabajo de códigos de barras a gran escala a veces descubren que las inconsistencias en la compatibilidad de formatos entre la generación y la lectura crean problemas de prueba y validación. Cuando un sistema genera códigos QR para un propósito y lee diferentes tipos de formato para otro, la divergencia entre lo que admite el generador y lo que admite el lector crea lagunas en las pruebas de ida y vuelta. Un sistema en el que la generación y la lectura comparten la misma biblioteca y la misma lista de formatos compatibles es más sencillo de validar. La verificación de que un código de barras generado se puede leer correctamente se convierte en una operación de una sola biblioteca en lugar de una prueba de integración de varias bibliotecas.

Extracción de paquete doble

Migrar desde Neodynamic requiere eliminar ambos paquetes NuGet: Neodynamic.SDK.Barcode y Neodynamic.SDK.BarcodeReader. Ambos deben ser eliminados del archivo .csproj y ambas directivas de using correspondientes deben ser eliminadas de los archivos fuente. Ejecutar dotnet remove package para cada uno es suficiente; No existen dependencias compartidas entre ambos que requieran una limpieza adicional.

Limpieza de la configuración de licencia dual

Los dos bloques de configuración de licencia — uno para BarcodeProfessional y uno para Neodynamic.SDK.BarcodeReader.BarcodeReader — son ambos reemplazados por una sola asignación IronBarCode.License.LicenseKey. Esta asignación se realiza una vez al inicio de la aplicación, típicamente en Program.cs o en la inyección de dependencias de la aplicación. Cualquier archivo de configuración o variable de entorno que almacene claves de licencia de Neodynamic puede dejar de utilizarse después de que se verifique la migración.

Eliminación de NotSupportedException

Bases de código que encontraron la limitación de lectura 2D durante el desarrollo a menudo contienen métodos de marcador de posición que lanzan NotSupportedException para la lectura de código QR o DataMatrix. Estos métodos no son soluciones temporales — son reconocimientos honestos de que la capacidad no existía. Después de migrar a IronBarcode, cada cuerpo de método de este tipo se reemplaza con una llamada BarcodeReader.Read(imagePath) estándar. No se requiere ningún tratamiento especial; El formato se detecta automáticamente.