Barcode4.NET vs IronBarcode: Comparación de bibliotecas de códigos de barras C#

API de generación de códigos de barras Barcode4NET

El flujo de trabajo completo de generación en Código de barras4NETutilizaba un patrón de establecimiento de propiedades:

// Código de barras4NET— manual DLL, .NET Frameworkonly
// No Paquete NuGet— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

// Código de barras4NET— manual DLL, .NET Frameworkonly
// No Paquete NuGet— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Dim barcode As New Barcode4NET.Barcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.Width = 300
barcode.Height = 100
Dim barcodeImage As Bitmap = barcode.GenerateBarcode()
barcodeImage.Save(outputPath, ImageFormat.Png)

Esto representa la totalidad de la superficie de la API de Barcode4NET. La biblioteca no ofrecía encadenamiento fluido, ni capacidad de lectura, ni salida en PDF, ni opciones avanzadas de QR, como la incrustación de logotipos o el control de corrección de errores.

Comparación detallada de características

Enfoque Barcode4NET

Barcode4NET utilizó un patrón imperativo de asignación de propiedades. Los desarrolladores instancian un objeto Barcode, le asignan propiedades individuales y llaman a GenerateBarcode() para recibir un System.Drawing.Bitmap:

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Public Function GenerateLabel(sku As String) As Bitmap
    Dim barcode As New Barcode4NET.Barcode()
    barcode.Symbology = Symbology.Code128
    barcode.Data = sku
    barcode.Width = 400
    barcode.Height = 120
    Return barcode.GenerateBarcode()
End Function

El tipo de retorno - System.Drawing.Bitmap - significaba que el código de llamada era responsable de guardar, mostrar o transmitir la imagen. Esto era apropiado para aplicaciones WinForms en las que un Bitmap podía asignarse directamente a un PictureBox, pero requería pasos de conversión adicionales para cualquier otro destino de salida.

Enfoque IronBarcode

IronBarcode utiliza una API estática fluida. Una única llamada a un método inicia la generación, y los métodos encadenables configuran el resultado antes de un método de guardado o conversión en la terminal:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateLabel(sku As String) As Byte()
    Return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .ToPngBinaryData()
End Function

El BarcodeEncoding enum corresponde directamente al Symbology enum. .ResizeTo() sustituye a las asignaciones de propiedades Width y Height. Los métodos de terminal - .SaveAsPng(), .SaveAsJpeg(), .ToPngBinaryData() - sustituyen a las llamadas separadas GenerateBarcode() y bitmap-save. Para escenarios de generación más avanzados, consulte la documentación de generación de códigos de barras de IronBarcode .

Enfoque Barcode4NET

Barcode4NET no tenía una API de lectura. Los equipos que necesitaban decodificar códigos de barras a partir de imágenes o documentos escaneados tenían que integrar una biblioteca completamente independiente: ya fuera ZXing .NET, una alternativa de código abierto, o un SDK de escáner comercial. El resultado fueron dos cadenas de dependencias separadas: Código de barras4NETpara la generación y una segunda biblioteca para la lectura.

Enfoque IronBarcode

IronBarcode proporciona BarcodeReader.Read() como método estático que acepta rutas de archivos de imagen, objetos de flujo y documentos PDF:

using IronBarCode;

// Read from an image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
}

// Read all barcodes from a multi-page PDF — no extra PDF library required
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

using IronBarCode;

// Read from an image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
}

// Read all barcodes from a multi-page PDF — no extra PDF library required
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

Imports IronBarCode

' Read from an image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"Value: {result.Value}")
    Console.WriteLine($"Format: {result.Format}")
Next

' Read all barcodes from a multi-page PDF — no extra PDF library required
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

Para escenarios de gran volumen o imágenes ruidosas, la clase BarcodeReaderOptions proporciona control sobre la velocidad de lectura y la detección de múltiples códigos de barras. Consulte la documentación de lectura de códigos de barras para conocer las opciones de configuración.

Enfoque Barcode4NET

Barcode4NET se compiló utilizando ensamblados de .NET Framework. Funcionaba en Windows, en aplicaciones .NET Framework, en proyectos de formularios web y formularios de Windows alojados en IIS. No había compilaciones para Linux, ni compilaciones .NET Core , ni soporte para entornos de ejecución en la nube. Cuando Microsoft presentó .NET Core y posteriormente unificó la plataforma como .NET 5+, Código de barras4NETno recibió actualizaciones correspondientes. Cualquier proyecto que tenga como objetivo net5.0 o posterior no podrá hacer referencia alguna a la biblioteca.

El modelo de distribución de DLL complicó aún más la limitación de la plataforma. Cada entorno de compilación (estación de trabajo del desarrollador, agente de compilación, contenedor Docker) requería que la DLL estuviera presente en una ruta conocida. En los despliegues basados en contenedores, esto significaba o bien incluir la DLL en una imagen base personalizada o copiarla durante la compilación del contenedor, ninguna de las cuales es compatible con los flujos de trabajo estándar dotnet restore.

Enfoque IronBarcode

IronBarcode es compatible con múltiples frameworks desde un único paquete NuGet : .NET Framework4.6.2 hasta .NET 9, y todas las versiones actuales de .NET en Windows, Linux y macOS. El despliegue en contenedores Dockerutiliza las imágenes de tiempo de ejecución estándar de .NET sin modificaciones. Azure Functions, AWS Lambda y otros entornos de ejecución sin servidor son compatibles a través del mismo paquete NuGet . El comando dotnet restore resuelve todas las dependencias sin ninguna gestión manual de DLL.

Enfoque Barcode4NET

Barcode4NET ha llegado al final de su ciclo de vida. No se pueden adquirir nuevas licencias a través de ComponentSource ni de ningún otro canal. Si un desarrollador se une a un equipo que utiliza Barcode4NET, no existe ningún mecanismo para comprarle una licencia. Dependiendo de cómo estén estructuradas las licencias existentes, es posible que un nuevo desarrollador no tenga autorización legal para ejecutar o depurar código relacionado con códigos de barras durante el desarrollo. No existe un sistema de seguimiento de incidencias, ni un canal de soporte, ni un proveedor al que contactar en caso de defectos. Las vulnerabilidades de seguridad descubiertas tras la última versión permanecen sin solucionarse.

Enfoque IronBarcode

IronBarcode es un producto comercial con mantenimiento activo y licencia perpetua. Los planes comienzan en $749 para una licencia Lite de un solo desarrollador, con los planes Plus ($1,499, 3 desarrolladores), Professional ($2,999, 10 desarrolladores) e Unlimited ($5,999) disponibles. Todos los planes incluyen la implementación sin pago de regalías. Los parches de seguridad, las correcciones de errores y las actualizaciones de compatibilidad de la versión .NET se publican con una periodicidad de lanzamiento regular. Se ofrece una prueba gratuita de 30 días para su evaluación, sin necesidad de clave de licencia.

Actualización de .NET bloqueada

El factor desencadenante más común es un proyecto de modernización de .NET . Un equipo selecciona net8.0 en su .csproj, ejecuta la compilación y encuentra un error de compilación porque Código de barras4NETse compiló con ensamblados de .NET Frameworka los que ya no se hace referencia. El error es inequívoco: la biblioteca no se cargará bajo el nuevo marco de destino. En este punto, el equipo se enfrenta a una elección binaria: revertir el cambio de marco de trabajo de destino y permanecer en .NET Framework, o reemplazar Barcode4NET. La migración no puede posponerse sin obstaculizar el esfuerzo de modernización en general.

Fallos en la canalización de CI/CD tras cambios en la infraestructura

El modelo de distribución de DLL de Código de barras4NETcrea una fragilidad latente en los procesos de compilación. Cuando se vuelve a aprovisionar un agente de compilación, se actualiza una imagen de contenedor o se configura un nuevo entorno de CI, la DLL de Código de barras4NETdebe colocarse manualmente en la ruta que espera el archivo del proyecto. Los equipos que no han documentado este paso cuidadosamente solo descubren el problema cuando el proceso falla. La transición a IronBarcode significa que dotnet restore se encarga de todo: el problema de la localización de DLL deja de existir.

Los nuevos miembros del equipo no pueden obtener la licencia.

Cuando un contratista se une al proyecto o un segundo desarrollador necesita trabajar en las funciones de código de barras, no es necesario comprar ninguna licencia. El equipo debe sortear esta limitación: o bien el nuevo desarrollador evita por completo el código de barras, o alguien transfiere una licencia que puede no ser legalmente transferible según los términos originales. Ninguna de las dos situaciones es sostenible para un equipo que está desarrollando activamente el producto.

Auditorías de seguridad y cumplimiento

Las organizaciones que generan listas de materiales de software o que comprueban las dependencias con bases de datos obsoletas se encuentran con Código de barras4NETcomo un hallazgo. Se trata de un producto comercial sin proveedor activo, sin seguimiento de vulnerabilidades (CVE) y sin disponibilidad de parches. Los auditores de seguridad tratan las dependencias comerciales que han llegado al final de su ciclo de vida de manera diferente a las bibliotecas de código abierto consolidadas: la ausencia de un proceso de respuesta del proveedor significa que cualquier vulnerabilidad queda permanentemente sin mitigar. Normalmente, esto se convierte en un elemento de remediación formal en lugar de un riesgo diferido.

Capacidad de lectura añadida a un flujo de trabajo existente

Los equipos que inicialmente usaban Código de barras4NETsolo para flujos de trabajo de generación, descubren más tarde que necesitan verificar códigos de barras de documentos escaneados, procesar imágenes cargadas por los usuarios o extraer datos de facturas en formato PDF. Con Barcode4NET, esto requiere la integración de una segunda biblioteca. El BarcodeReader.Read() de IronBarcode gestiona tanto imágenes como PDF de forma nativa, consolidando la dependencia en un único paquete mantenido.

Eliminando la referencia a la DLL

Barcode4NET nunca se distribuyó como paquete NuGet, por lo que no existe el comando dotnet remove package. Cada archivo .csproj que hace referencia a la biblioteca contiene un elemento <Reference Include="Barcode4NET"> con un <HintPath> que apunta a la DLL en el disco. Cada uno de estos elementos debe ser localizado y eliminado manualmente. Una búsqueda con grep en la solución los localiza:

grep -rl "Barcode4NET" --include="*.csproj" .

grep -rl "Barcode4NET" --include="*.csproj" .

El directorio DLL en el control de código fuente - normalmente ThirdParty/Barcode4NET/ o lib/ - también debe ser preparado para su eliminación con git rm.

Cambio de tipo de retorno: de mapa de bits a matriz de bytes.

El GenerateBarcode() de Código de barras4NETdevuelve un System.Drawing.Bitmap. La cadena fluida de IronBarcode termina en .ToPngBinaryData() devolviendo byte[], o .SaveAsPng() escribiendo directamente en disco. El código que asigna el valor de retorno a una variable Bitmap o lo pasa a un método que espera un Bitmap - como un WinForms PictureBox - requiere un ajuste de una línea en el sitio de llamada: envuelva la matriz de bytes en un MemoryStream y llame a Image.FromStream().

Simbología Enumeración Renombrar

El Symbology enum de Código de barras4NETcorresponde directamente al BarcodeEncoding enum de IronBarcode. Todos los valores comunes - Code128, Code39, EAN13, UPCA, QRCode - conservan sus nombres. Una búsqueda y sustitución de Symbology. por BarcodeEncoding. cubre la mayoría de los casos, aunque cada sustitución debe revisarse para confirmar el contexto.

Limpieza del script de compilación

Los scripts de compilación y los archivos de configuración de CI/CD que copian la DLL de Código de barras4NETa los directorios de salida o a los agentes de compilación deben actualizarse. Estos pasos no tienen equivalente después de la migración NuGet - dotnet restore reemplaza toda la gestión manual de DLL. Dejar pasos de copia de DLL obsoletos después de la migración no provocará fallos de compilación, pero representan una configuración muerta que genera confusión para los futuros responsables del mantenimiento.