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

Patrón de generación principal de BarcodeLib

El flujo de trabajo estándar de generación de BarcodeLibrequiere crear una instancia, configurar las propiedades y llamar a Encode():

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging

Dim b As New Barcode()
b.IncludeLabel = True
b.Width = 300
b.Height = 100
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")
img.Save("barcode.png", ImageFormat.Png)

Este es el flujo de trabajo de generación completo. El patrón property-setter es el diseño: toda la configuración ocurre en la instancia antes de la llamada Encode(), y el valor de retorno es un System.Drawing.Image que debe ser guardado por separado o convertido a bytes.

Comparación detallada de características

Enfoque BarcodeLib

BarcodeLib requiere construir una instancia y establecer propiedades antes de llamar a Encode(). El resultado es un objeto System.Drawing.Image:

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.IO

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    b.Width = 300
    b.Height = 100
    Dim img As Image = b.Encode(TYPE.CODE128, data)

    Using ms As New MemoryStream()
        img.Save(ms, ImageFormat.Png)
        Return ms.ToArray()
    End Using
End Function

El tipo de retorno System.Drawing.Image significa que la salida de la matriz de bytes requiere un intermediario MemoryStream. La propiedad IncludeLabel es un conmutador booleano - BarcodeLibmuestra automáticamente la cadena de datos codificada como la etiqueta visible debajo de las barras.

Enfoque IronBarcode

La generación de IronBarcode es completamente estática. Las cadenas de configuración después de CreateBarcode(), y los métodos de salida terminan la cadena directamente:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddAnnotationTextBelowBarcode(data)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddAnnotationTextBelowBarcode(data)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateCode128(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .AddAnnotationTextBelowBarcode(data) _
        .ToPngBinaryData()
End Function

.ToPngBinaryData() devuelve la matriz de bytes directamente, sin objetos intermedios Image o MemoryStream. .AddAnnotationTextBelowBarcode() toma la cadena de etiquetas explícitamente, dando control sobre qué texto aparece debajo de las barras. Para escenarios de generación avanzados, consulte la documentación de generación de códigos de barras de IronBarcode .

Enfoque BarcodeLib

BarcodeLib no tiene una API de lectura. No hay ningún método Decode(), Scan() o ReadBarcode(). La ausencia no se debe a una diferencia de versión; la lectura nunca ha formado parte del diseño de la biblioteca. Cualquier intento de llamar a un método decodificador produce un error de compilación:

// BarcodeLib— reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

// BarcodeLib— reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

Imports BarcodeLib

Dim b As New Barcode()

' This will not compile — there is no Decode or Read method
' Dim value = b.Decode("barcode.png")       ' CS1061: no definition
' Dim value = b.Scan("barcode.png")         ' CS1061: no definition
' Dim value = b.ReadBarcode("barcode.png")  ' CS1061: no definition

' The only thing you can do is generate:
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")  ' this works

Los equipos que necesitan tanto la generación como la lectura de BarcodeLibdeben añadir una segunda biblioteca, normalmente ZXing .NET , lo que introduce su propia carga de gestión de dependencias y una segunda interfaz API que mantener.

Enfoque IronBarcode

BarcodeReader.Read() acepta archivos de imagen, archivos PDF, secuencias y objetos System.Drawing.Bitmap. Para leer un PDF no se necesita ninguna biblioteca adicional:

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

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

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

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

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

' Read from an image
Dim results = BarcodeReader.Read("barcode.png")
Console.WriteLine(results.First().Value)  ' "PRODUCT-12345"

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

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

El ReadingSpeed enum permite ajustar el rendimiento del escaneado para escenarios de gran volumen. Para obtener orientación sobre la configuración de lectura, consulte la documentación de lectura de IronBarcode .

Enfoque BarcodeLib

A partir de BarcodeLib3.x, la biblioteca introdujo SkiaSharp como backend gráfico para sustituir a System.Drawing.Common, que pasó a ser exclusivo de Windowsa partir de .NET 6. BarcodeLibse vincula a un rango específico de versiones de SkiaSharp. Si un proyecto ya utiliza SkiaSharp a través de otra dependencia - común en proyectos MAUI utilizando SkiaSharp.Views.Maui y Microsoft.Maui.Graphics - la versión resuelta puede quedar fuera del rango esperado de BarcodeLib. El resultado es, como mínimo, una advertencia NU1608 y, en el peor de los casos, un fallo de enlace de ensamblado en tiempo de ejecución:

Advertencia NU1608: Se detectó una versión del paquete fuera de la restricción de dependencia:
BarcodeLib 3.1.5 requiere SkiaSharp (>= 2.88.7 && < 2.89.0) pero
Se ha solucionado el problema con la versión SkiaSharp 3.116.1.

Forzar una resolución mediante referencias explícitas a paquetes añade complejidad sin garantía alguna:

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

Incluso con anulaciones explícitas, la compatibilidad depende de que las llamadas a la API interna de BarcodeLibcoincidan con lo que expone la versión fija. No existe ningún contrato de soporte que garantice una solución en un plazo que sea relevante para el proyecto.

Enfoque IronBarcode

IronBarcode no comparte el gráfico de dependencias de SkiaSharp con el código de la aplicación. No hay negociación de versiones que gestionar, ni NU1608 que diagnosticar, ni riesgo de vinculación de ensamblados en tiempo de ejecución relacionado con la resolución de versiones de SkiaSharp. Los proyectos MAUI, los proyectos Blazor y cualquier otra aplicación que dependa de SkiaSharp pueden instalar IronBarcode sin ningún conflicto de versiones. Para conocer los patrones de integración específicos de MAUI, consulte la documentación de IronBarcode MAUI .

Aparece el requisito de lectura

Un sistema que lleva meses generando etiquetas de envío recibe un nuevo requisito: la aplicación también debe procesar las etiquetas devueltas por los proveedores. La integración del almacén necesita analizar los códigos de barras de los manifiestos de envío entrantes. Un sistema de gestión documental necesita indexar los códigos de barras de los archivos PDF escaneados. BarcodeLibno cumple con ninguno de estos requisitos, ya que no dispone de una API de lectura. El equipo evalúa la posibilidad de integrar ZXing .NET junto con BarcodeLib, sopesa la carga de mantenimiento que supone tener dos bibliotecas y los dos gráficos de dependencias separados, y decide que la solución más limpia es una biblioteca que gestione tanto la generación como la lectura mediante una única instalación de NuGet .

Conflicto de SkiaSharp en un proyecto MAUI

Un equipo agrega BarcodeLiba una aplicación MAUI existente e inmediatamente se encuentra con advertencias NU1608 durante la restauración. Investigan, identifican el desajuste de versión entre el rango esperado de SkiaSharp de BarcodeLiby la versión que requiere MAUI, añaden anulaciones explícitas <PackageReference> para forzar una resolución y consiguen que se apruebe la compilación. Entonces, se produce un fallo en tiempo de ejecución en el dispositivo cuando los binarios nativos de SkiaSharp cargan la versión incorrecta. La solución requiere una investigación más profunda del registro de vinculación del ensamblado. Cambiar a IronBarcode elimina el conflicto de raíz, no encontrando una versión compatible de SkiaSharp, sino eliminando por completo la dependencia compartida.

Se requiere el procesamiento de códigos de barras PDF.

Las aplicaciones que generan documentos PDF con códigos de barras incrustados (facturas, órdenes de trabajo, manifiestos de envío) a veces necesitan leer esos códigos de barras durante el procesamiento posterior. BarcodeLibgenera imágenes de códigos de barras, pero no tiene soporte para PDF en ninguno de los extremos. Para leer códigos de barras desde un PDF con BarcodeLib, primero hay que convertir el PDF en imágenes utilizando una biblioteca de PDF independiente y, a continuación, pasar esas imágenes a una biblioteca de lectura independiente. IronBarcode maneja la cadena completa de forma nativa: BarcodeReader.Read("file.pdf") recorre cada página y devuelve todos los códigos de barras detectados sin un paso intermedio de renderización.

Las funcionalidades de los códigos QR superan la generación básica.

Los proyectos que inicialmente solo requerían la generación básica de códigos QR a menudo evolucionan hasta necesitar la incrustación de logotipos, la personalización del color o la configuración del nivel de corrección de errores. BarcodeLibadmite códigos QR a través de TYPE.QR_Code, pero no ofrece más opciones que las propiedades estándar Width, Height y IncludeLabel. El QRCodeWriter de IronBarcode expone la incrustación de logotipos, el control del color y el ajuste de la corrección de errores mediante métodos encadenados. Los equipos cuyos requisitos de códigos QR han superado las capacidades de la implementación básica de BarcodeLibdescubren que la falta de funcionalidades es el factor determinante en la decisión de migrar.

API de instancia a API fluida estática

El código de BarcodeLibutiliza un patrón de objeto mutable: crear una instancia Barcode, establecer propiedades, llamar a Encode(). IronBarcode utiliza un patrón fluido estático: llamar a BarcodeWriter.CreateBarcode(), encadenar métodos de configuración, terminar con un método de salida. Será necesario reestructurar el código existente que almacena una instancia Barcode como un campo o la pasa entre métodos. El cambio típico consiste en reemplazar el bloque de asignación de propiedades por una cadena de métodos:

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddAnnotationTextBelowBarcode(data)
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddAnnotationTextBelowBarcode(data)
    .SaveAsPng(outputPath);

System.Drawing.Image a salida directa

BarcodeLib devuelve System.Drawing.Image, que requiere MemoryStream para producir bytes. Cualquier código escrito en Image o System.Drawing.Image deberá ser actualizado. La cadena fluida de IronBarcode termina con el formato de salida deseado directamente - .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() - eliminando la necesidad del objeto de imagen intermedio y el paso MemoryStream.

Enumeración de tipo a enumeración BarcodeEncoding

BarcodeLib utiliza la clase TYPE con constantes en mayúsculas como TYPE.CODE128. IronBarcode utiliza el enum BarcodeEncoding con valores PascalCase como BarcodeEncoding.Code128. Los valores se corresponden directamente. Una búsqueda de TYPE\. en los archivos .cs identifica todas las apariciones que necesitan actualización, y una búsqueda y sustitución sistemática cubre los formatos comunes: CODE128 → Code128, EAN13 → EAN13, UPCA → UPCA, QR_Code → QRCode.

Limpieza de referencias de SkiaSharp

Los proyectos que añadieron entradas <PackageReference Include="SkiaSharp"> explícitas sólo para resolver las advertencias NU1608 de BarcodeLibpueden eliminar esas anulaciones después de cambiar a IronBarcode. El comando dotnet list package --include-transitive confirma si SkiaSharp sigue siendo necesario para otros paquetes del proyecto antes de eliminarlo.