Spire.Barcode vs IronBarcode: Comparación de bibliotecas de códigos de barras C#

El requisito de especificación de tipo

El BarcodeScanner.Scan() de Spire.BarCode no tiene una sobrecarga que acepte sólo una ruta de archivo. Cada operación de lectura exige que el código que la realiza declare el formato del código de barras con antelación. Para flujos de trabajo de formato único esto funciona, pero para el procesamiento de documentos de formato mixto produce un bucle de iteración candidato:

// 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 que se agrega al array de candidatos supone una pasada de escaneo adicional. Cualquier formato que falte en la lista se omite silenciosamente. El desarrollador es responsable de mantener un inventario exhaustivo de tipos y de volver a realizar pruebas cada vez que se incorpore un nuevo formato al flujo de trabajo.

Comparación detallada de características

Spire. Enfoque de código de barras

Spire.Barcode's BarcodeScanner.Scan() requiere un parámetro BarCodeType en cada llamada. La llamada de un solo tipo es apropiada cuando el formato es conocido y está garantizado:

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

Cuando el formato no se conoce de antemano, el único método disponible es iterar a través de los tipos candidatos. Cada iteración consiste en un escaneo completo, y cualquier formato que no esté en la lista se omite silenciosamente. El resultado es un string[] que no contiene información de tipo, por lo que el enrutamiento descendente basado en el formato requiere una gestión de estado adicional por parte de la persona que llama.

Enfoque IronBarcode

El BarcodeReader.Read() de IronBarcode no requiere ningún parámetro de tipo. La biblioteca detecta automáticamente el formato en todas las simbologías compatibles en una sola pasada. La lectura de códigos de barras a partir de imágenes se realiza mediante una única llamada a un método, independientemente de la cantidad de formatos diferentes que pueda contener la fuente:

// 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 resultante incluye BarcodeType, Value y metadatos de posición. El enrutamiento descendente basado en el formato no requiere ningún estado adicional; el tipo está presente en el propio resultado.

Spire.Barcode Nivel gratuito

FreeSpire.Barcode aplica una marca de agua de evaluación grande a las imágenes de códigos de barras generadas. La marca de agua cubre el código de barras de tal manera que lo hace inadecuado para su uso en producción y dificulta una evaluación significativa de la calidad de generación. En la versión gratuita, el rendimiento del escaneo se ve intencionadamente reducido, lo que significa que las mediciones de rendimiento realizadas durante la evaluación no representan el rendimiento de la versión comercial de Spire.Barcode. El paquete gratuito también requiere una clave de registro obtenida de E-iceblue para que se supriman los cuadros de diálogo de advertencia durante la ejecución. La simbología disponible en el nivel gratuito es un subconjunto de la oferta comercial. En conjunto, estas restricciones implican que una evaluación basada en FreeSpire.Barcode no representa con precisión lo que ofrece el producto comercial.

Modo de prueba de IronBarcode

La versión de prueba de IronBarcode es el paquete con licencia que se utiliza sin una clave de licencia. La lectura se realiza a máxima velocidad con soporte completo para la simbología y sin restricciones de comportamiento. Las opciones de velocidad y precisión de lectura funcionan de forma idéntica tanto en el modo de prueba como en el modo con licencia. El código de barras generado en modo de prueba incluye una pequeña marca de agua en el borde de la imagen; No oculta el código de barras en sí. El comportamiento que se mide durante una evaluación de IronBarcode es el comportamiento que se implementa en producción.

Spire. Enfoque de código de barras

Spire.Barcode no tiene capacidad nativa para leer archivos PDF. Para extraer códigos de barras de un archivo PDF, un desarrollador debe instalar el paquete Spire.PDF por separado, adquirir una licencia de Spire.PDF por separado y escribir un código manual de iteración de páginas y extracción de imágenes antes de poder comenzar a escanear códigos de barras:

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

Este patrón requiere dos paquetes NuGet , dos acuerdos de licencia y código de gestión de páginas escrito por el desarrollador. Si los códigos de barras están incrustados en contenido vectorial en lugar de imágenes rasterizadas dentro del PDF, el método de extracción de imágenes podría no detectarlos por completo.

Enfoque IronBarcode

IronBarcode maneja archivos PDF de forma nativa sin ninguna dependencia adicional. Leer códigos de barras de documentos PDF es una llamada a un único método que utiliza la misma API BarcodeReader.Read() que se utiliza para los archivos de imagen. Los números de página se incluyen en 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

No se requiere extracción manual de páginas, ni paquete secundario, ni compra de licencias adicionales.

Spire. Enfoque de código de barras

El modelo de generación de Spire.Barcode se centra en un objeto de configuración mutable BarcodeSettings. Un desarrollador instancia la configuración, asigna propiedades individualmente, pasa el objeto de configuración a un BarCodeGenerator, y luego llama a 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)

El hecho de que el objeto de configuración sea mutable implica que las configuraciones pueden compartirse accidentalmente entre llamadas cuando se reutiliza una única instancia en múltiples operaciones de generación. La clase generadora añade un paso de instanciación adicional que no contiene lógica de configuración propia.

Enfoque IronBarcode

IronBarcode utiliza un método de fábrica estático con encadenamiento fluido opcional. No hay ningún objeto de configuración ni ninguna instancia de generador que gestionar:

// IronBarcode generation
using IronBarCode;

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

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

// IronBarcode generation
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

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

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

Los códigos QR con logotipos personalizados están disponibles en todos los niveles de licencia de IronBarcode :

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

Procesamiento de documentos de formato mixto

Los equipos que comienzan con un único formato de código de barras conocido suelen descubrir que la diversidad de formatos aumenta con el tiempo. Una aplicación de almacenamiento que empezó con etiquetas Code128 puede recibir envíos de proveedores que utilizan DataMatrix, GS1-128 o códigos QR. Cada nuevo formato que entra en el flujo de trabajo requiere actualizar la matriz de candidatos en el bucle de adivinación de tipos, volver a probar la lógica de detección y confirmar que ningún formato existente se ve desplazado por el orden de iteración. Cuando la diversidad de formatos alcanza un punto en el que la sobrecarga de mantenimiento de ese bucle se convierte en un coste de desarrollo recurrente, los equipos evalúan si la detección automática eliminaría por completo esa carga.

Integración de PDF

Las aplicaciones que manejan gran cantidad de documentos a menudo se encuentran con un momento en el que deben extraer códigos de barras de archivos PDF en lugar de imágenes independientes. En un flujo de trabajo de Spire.Barcode, esta transición requiere adquirir una licencia de Spire.PDF, integrar un segundo paquete y desarrollar la infraestructura de iteración de páginas y extracción de imágenes antes de que se pueda realizar cualquier lectura de códigos de barras. Los equipos que no previeron este requisito al realizar la compra inicial se encuentran gestionando dos licencias de producto y dos interfaces API para una tarea que, conceptualmente, pertenece a la lectura de códigos de barras. Descubrir que la compatibilidad con archivos PDF requiere una compra aparte es un motivo frecuente para reevaluar la selección del producto.

Limitaciones de la evaluación del nivel gratuito

Los equipos que evaluaron FreeSpire.Barcode y luego adquirieron la licencia comercial a veces informan que el producto comercial se comporta de manera diferente a como lo indicaba su evaluación. Esto es intencional: el nivel gratuito degrada deliberadamente el rendimiento de lectura y restringe el conjunto de símbolos, lo que significa que las pruebas de rendimiento y de cobertura de formato realizadas durante la evaluación no se transfieren a la implementación comercial. Cuando un equipo descubre esta discrepancia después de la compra, suele buscar alternativas cuyo comportamiento en las pruebas sea representativo del comportamiento en producción.

Reducción del número de productos

Las organizaciones que estandarizan su conjunto de tecnologías a veces identifican Spire.Barcode como un componente más en un inventario creciente de productos E-iceblue, cada uno con su propio costo de licencia y ciclo de renovación. Si el principal objetivo de Spire.Barcode es la lectura de códigos de barras dentro de un proceso de gestión de documentos, en lugar de una integración profunda con Spire.Doc o Spire.XLS, los equipos evalúan si una única biblioteca de códigos de barras independiente reduciría tanto la complejidad de las licencias como la superficie de soporte.

Eliminación del parámetro BarCodeType

Cada llamada scanner.Scan() en una base de código Spire.Barcode lleva un argumento BarCodeType. La sustitución de estas llamadas por BarcodeReader.Read() elimina por completo el parámetro de tipo. Los bucles de búsqueda de tipo - bloques foreach que iteran a través de valores candidatos BarCodeType - pueden ser eliminados en su totalidad; una sola llamada BarcodeReader.Read() sustituye a todo el bucle.

Actualización del tipo de retorno

El Scan() de Spire.BarCode devuelve el string[]. IronBarcode devuelve una colección BarcodeResults. Los sitios de llamadas que asignan a string[] o pasan resultados a métodos que esperan ese tipo requieren actualización. La extracción de valores como una matriz utiliza .Select(r => r.Value).ToArray(); para acceder al primer resultado se utiliza .First()?.Value.

Eliminación del paquete Spire.PDF

Si Spire.PDF se instaló únicamente para permitir la extracción de códigos de barras de archivos PDF, puede eliminarse después de migrar a IronBarcode. Todas las importaciones using Spire.Pdf; y los bloques de iteración manual de páginas se sustituyen por una única llamada BarcodeReader.Read("file.pdf"). Si Spire.PDF se utiliza para otras operaciones documentales además de la extracción de códigos de barras, debe conservarse y sustituir únicamente las rutas de código relacionadas con los códigos de barras.

Cambios en el espacio de nombres

Sustituya using Spire.Barcode; por using IronBarCode;. El BarCodeType enum se sustituye por BarcodeEncoding para la generación y no requiere ningún equivalente para la lectura. La inicialización de la licencia cambia de BarcodeSettings.ApplyKey() o Spire.License.LicenseProvider.SetLicenseKey() a una única asignación de propiedad IronBarCode.License.LicenseKey al inicio de la aplicación.