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

Flujo de trabajo de generación de paquetes múltiples

El relato de la instalación ilustra de inmediato la diferencia de alcance. Con Barcoder, la salida PNG básica requiere dos paquetes separados:

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

El flujo de trabajo completo para generar un código de barras Code128 y guardarlo como PNG requiere tres importaciones de espacios de nombres, una llamada al codificador específica del formato, una construcción de renderizador con un objeto de opciones, un flujo de archivos y una llamada de renderizado:

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

Cambiar el formato del código de barras no es un cambio de parámetro, sino que requiere importar un espacio de nombres diferente y llamar a una clase diferente. Code128Encoder.Encode toma un bool para includeChecksum, QrEncoder.Encode toma un nivel de corrección de errores y dos bools adicionales, y DataMatrixEncoder.Encode toma sólo la cadena. No existe una interfaz unificada para crear un código de barras en un formato específico.

Comparación detallada de características

Enfoque de código de barras

El lector de códigos de barras dirige la selección de formato a través de clases de codificadores separadas en espacios de nombres separados. Cambiar de formato significa añadir una nueva directiva using y utilizar una clase diferente con una firma de método distinta:

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

Cada codificador tiene su propio contrato de parámetros. Agregar un nuevo formato a un proyecto existente no es un cambio de una sola palabra: implica importar un nuevo espacio de nombres, aprender una nueva clase y comprender nuevos parámetros.

Enfoque IronBarcode

IronBarcode dirige toda la selección de formato a través del enum BarcodeEncoding de la clase unificada BarcodeWriter. Agregar un nuevo formato es un cambio de una sola palabra en el valor de enumeración:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

Para su uso en producción, añada la clave de licencia al iniciar la aplicación:

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

La documentación de generación de códigos de barras de IronBarcode abarca toda la gama de opciones de generación, incluyendo estilos, márgenes y personalización de colores.

Enfoque de código de barras

La separación entre codificación y renderizado en Código de barras es una arquitectura acertada, pero genera una sobrecarga con cada cambio de formato de salida. Para guardar en un archivo es necesario abrir un FileStream. Obtener datos binarios requiere abrir un MemoryStream y llamar a ToArray(). Cada escenario de salida requiere la construcción de un renderizador con un objeto de opciones:

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

El control de tamaño es indirecto: PixelSize es un multiplicador de escala sobre el tamaño del módulo del código de barras, no una especificación directa de anchura y altura.

Enfoque IronBarcode

IronBarcode devuelve un objeto GeneratedBarcode desde el que se puede acceder a cualquier formulario de salida mediante llamadas a métodos encadenados. Sin construcción de renderizadores, sin gestión de flujos:

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height) toma dimensiones explícitas de píxeles y encadena con cualquier método de salida en el mismo objeto.

Enfoque de código de barras

El lector de códigos de barras no tiene capacidad de lectura ni de decodificación. No existe ninguna API, ni ninguna API planificada, ni ninguna solución alternativa dentro de la biblioteca. Si una aplicación necesita leer códigos de barras, se debe agregar una segunda biblioteca —una dependencia NuGet independiente con su propia interfaz API y su propia versión que controlar— junto con Barcoder. Eso significa, como mínimo, dos dependencias relacionadas con la lectura: Código de barras para la generación y algún otro sistema para la lectura.

Enfoque IronBarcode

IronBarcode abarca tanto la generación como la lectura con el mismo paquete y patrones de API consistentes. El método BarcodeReader.Read() acepta de forma nativa archivos de imagen, matrices de bytes, flujos y PDF:

using IronBarCode;

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

// Leer desde PDF — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

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

// Leer desde PDF — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

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

' Leer desde PDF — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

La lectura de archivos PDF es nativa: no requiere extracción intermedia de imágenes, ni biblioteca de conversión, ni paquete adicional. La documentación de IronBarcode sobre lectura de códigos de barras abarca archivos PDF de varias páginas, lectura de regiones de interés y optimización del rendimiento.

Se añade la lectura a los requisitos.

Muchos proyectos comienzan como simples procesos de generación de código: imprimir etiquetas, generar códigos para documentos, insertar códigos de barras en informes. Código de barras presta servicio a estos proyectos desde el principio. Cuando la misma aplicación necesita posteriormente verificar códigos de barras entrantes, procesar documentos escaneados o decodificar códigos de barras de archivos PDF cargados, Código de barras no ofrece ninguna solución. El equipo debe evaluar una segunda biblioteca, aprender su API, gestionar su versión NuGet por separado y manejar la superficie de integración entre ambas bibliotecas. Los equipos que llegan a este punto suelen consolidar sus sistemas en una biblioteca que gestiona ambos lados, en lugar de mantener dos dependencias de códigos de barras separadas.

La ruptura de compatibilidad de .NET Framework

Barcoder.Renderer.Image se ha eliminado la compatibilidad con .NET Framework. Los equipos que mantienen servicios o aplicaciones de escritorio en .NET Framework4.x y que actualizan el paquete de renderizado de imágenes durante el mantenimiento rutinario de dependencias se encuentran con un fallo de compilación. Esto no es un error de configuración, sino una decisión de la biblioteca en cuanto al soporte de la plataforma. IronBarcode es compatible con .NET Frameworkdesde la .NET hasta la 9 sin necesidad de paquetes especiales ni dependencias condicionales para diferentes plataformas.

La desviación de la versión del paquete crea problemas de coordinación.

Con Barcoder y Barcoder.Renderer.Image versionados independientemente, la actualización de uno sin el otro durante una actualización de dependencia puede introducir incompatibilidades sutiles. En un repositorio con múltiples proyectos, cada uno de los cuales consume una versión diferente de cada paquete de renderizado, garantizar un comportamiento coherente entre los proyectos se convierte en un problema de coordinación que crece con el tamaño del equipo. Los equipos que se están unificando en IronBarcode informan que gestionar un único paquete y una única versión elimina por completo este tipo de problema.

La cobertura de formatos se amplía con el tiempo.

Un proyecto podría comenzar con etiquetas Code128 y posteriormente agregar códigos QR para enlaces orientados al cliente, y luego DataMatrix para cumplir con los requisitos normativos. Con Barcoder, cada nuevo formato implica la importación de un nuevo espacio de nombres, una clase de codificador diferente con parámetros de método distintos y, potencialmente, un nuevo paquete NuGet . Con IronBarcode, añadir un formato es un cambio en el valor BarcodeEncoding enum de una llamada existente. Los equipos con planes de desarrollo que incluyen la ampliación de la cobertura de formatos de código de barras encuentran que el modelo basado en enumeraciones es mucho más fácil de mantener.

Requisitos de MAUI y de implementación multiplataforma

Barcoder no documenta la compatibilidad con implementaciones de MAUI, Docker, AWS Lambda o Azure. Los equipos que desarrollan aplicaciones MAUI multiplataforma o que implementan el procesamiento de códigos de barras en infraestructuras sin servidor descubren que la documentación y las pruebas de Código de barras no cubren estos objetivos. IronBarcode documenta y prueba activamente la implementación en iOS, Android, Windows, macOS MAUI, contenedores Docker y las principales plataformas en la nube.

El cambio de tipo IBarcode a GeneratedBarcode

El código BarCode que almacena una variable IBarcode y la pasa posteriormente a un renderizador debe ser refactorizado. En IronBarcode, GeneratedBarcode tiene sus propios métodos de salida - no hay un paso de renderizado separado. Cualquier firma de método que actualmente acepte IBarcode debería cambiar para aceptar GeneratedBarcode, y la llamada de renderizado dentro de ese método debería convertirse en una llamada directa como .SaveAsPng() o .ToPngBinaryData(). El sistema de tipos mostrará todas las ubicaciones que deban actualizarse durante la compilación - IBarcode no se resolverá una vez eliminados los paquetes de Barcoder.

PixelSize No tiene equivalente directo

El PixelSize de BarCode es un multiplicador de escala sobre el tamaño natural del módulo del código de barras, no una dimensión explícita en píxeles. El ancho de salida depende del contenido del código de barras, el formato y el multiplicador, que se combinan en conjunto. IronBarcode utiliza .ResizeTo(width, height)con dimensiones de píxel explícitas. Durante la migración, mida las dimensiones de salida reales que produce el código BarCode existente y utilice esos valores en la llamada .ResizeTo():

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

Consolidación de espacios de nombres

Los proyectos BarCode acumulan declaraciones using Barcoder.*, una por cada formato utilizado. Durante la migración, todos estos colapsan en un único using IronBarCode;. Una búsqueda de using Barcoder en la solución identificará todos los archivos que necesiten actualización. La cantidad de archivos afectados suele ser mayor de lo que esperan los equipos, porque cada archivo que utiliza un formato de código de barras importa su propio espacio de nombres específico para ese formato.

Cambios en la ruta de salida SVG

Los proyectos que utilizan Barcoder.Renderer.Svg y la clase SvgRenderer sustituyen la canalización del renderizador por una llamada directa al método GeneratedBarcode:

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

El paquete Barcoder.Renderer.Svg puede eliminarse una vez que se hayan migrado todos los sitios de renderizado SVG.