Registro de la plataforma y del mantenimiento

Los metadatos del paquete NuGet para MessagingToolkit.Barcode documentan sus destinatarios previstos. Cada entrada en la siguiente tabla representa una plataforma que estaba vigente o casi vigente en el momento del desarrollo de la biblioteca:

La biblioteca no tiene un marco de destino compatible con .NET Core, .NET 5, .NET 6, .NET 7, .NET 8 o .NET 9. Los proyectos que tengan como destino estos entornos de ejecución encontrarán un fallo en tiempo de compilación cuando el paquete no pueda resolver un identificador de marco de trabajo compatible; no se trata de una advertencia en tiempo de ejecución, sino de un error de compilación.

Comparación detallada de características

Kit de herramientas de mensajería. Enfoque de código de barras.

MessagingToolkit.Barcode está dirigido exclusivamente a .NET Framework 3.5, 4.0 y 4.5. No tiene la denominación .NET Standard , ni está dirigido a .NET Core, ni cuenta con un adaptador de compatibilidad para entornos de ejecución modernos. Cuando un archivo de proyecto hace referencia a este paquete y está dirigido a cualquier versión moderna de .NET , la operación de restauración de NuGet falla con un error de compatibilidad del framework; la compilación no continúa.

La tabla de plataforma en los metadatos de NuGet lo deja claro. Silverlight 3, 4 y 5 son objetivos incluidos en la lista; Los tres sistemas operativos se descontinuaron en 2021. Se enumeran Windows Phone 7.0, 7.5, 7.8 y 8.0; Todas ellas dejaron de recibir soporte entre 2014 y 2017. Las versiones restantes .NET Framework 3.5, 4.0 y 4.5— siguen siendo técnicamente funcionales en Windows, pero solo reciben parches de seguridad de Microsoft, sin desarrollo de nuevas funcionalidades.

La consecuencia práctica es que MessagingToolkit.Barcode bloquea una actualización del marco. Un archivo de proyecto que se dirige a net472 y referencia este paquete no puede cambiarse a net8.0 sin antes eliminar el paquete. El paquete no solo está desactualizado, su ausencia de un nombre de marco objetivo moderno impide el cambio de marco objetivo que permitiría al proyecto acceder a capacidades modernas de .NET.

Consulta la documentación de la plataforma IronBarcode para obtener la lista completa de frameworks y plataformas de implementación compatibles.

Enfoque IronBarcode

IronBarcode es compatible con .NET Framework desde la versión 4.6.2 hasta la 9, abarcando tanto aplicaciones Windows heredadas como implementaciones multiplataforma modernas. Un único paquete NuGet se instala en todas las plataformas compatibles sin necesidad de bibliotecas gráficas separadas ni configuración específica de la plataforma.

El soporte multiplataforma es significativo en la práctica. El pipeline de imagen interno de IronBarcode no depende de System.Drawing, que se convirtió en exclusivo para Windows en .NET 6. Las aplicaciones dirigidas a Linux o macOS, incluidas aquellas ejecutándose en contenedores Docker, Azure App Service en Linux o AWS Lambda, utilizan la misma API y comportamiento de IronBarcode que las implementaciones en Windows.

Kit de herramientas de mensajería. Enfoque de código de barras.

La lectura con MessagingToolkit.Barcode requería crear una instancia de BarcodeDecoder, construir un Bitmap a partir del archivo de imagen, pasar el mapa de bits a .Decode() y verificar si el resultado es nulo antes de acceder a .Text. La generación seguía el mismo patrón de instancia: crear un BarcodeEncoder, establecer su propiedad .Format, llamar a .Encode() para recibir un Bitmap, luego llamar a .Save() en ese mapa de bits.

// MessagingToolkit.Barcode — .NET Framework target frameworks
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

// MessagingToolkit.Barcode — .NET Framework target frameworks
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

Imports MessagingToolkit.Barcode
Imports System.Drawing

' Reading
Dim barcodeReader As New BarcodeDecoder()
Dim bitmap As New Bitmap("barcode.png")
Dim result = barcodeReader.Decode(bitmap)
Dim value As String = result?.Text
Dim format As String = result?.BarcodeFormat.ToString()

' Writing
Dim barcodeWriter As New BarcodeEncoder()
barcodeWriter.Format = BarcodeFormat.QrCode
Dim outputBitmap = barcodeWriter.Encode("Hello World")
outputBitmap.Save("output.png")

La dependencia de Bitmap no es incidental. System.Drawing.Bitmap requiere GDI+ en Windows. En .NET 6 y posteriores, intentar usar System.Drawing en Linux o macOS lanza un PlatformNotSupportedException en tiempo de ejecución. Incluso si el ensamblado de MessagingToolkit.Barcode pudiera cargarse en un proyecto .NET moderno — no se puede debido al objetivo de marco faltante — la dependencia de Bitmap impediría la implementación multiplataforma de todas formas.

Enfoque IronBarcode

IronBarcode utiliza métodos estáticos en todo momento. BarcodeReader.Read() acepta una ruta de archivo, un Stream, una matriz de bytes o una ruta de archivo PDF — no se requiere Bitmap. El resultado es una colección, no un único objeto que pueda ser nulo. La generación utiliza BarcodeWriter.CreateBarcode() con el tipo de codificación pasado como parámetro, y el objeto de resultado expone directamente métodos de guardado.

// IronBarcode — .NET Framework 4.6.2 through .NET 9
using IronBarCode;

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

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

// IronBarcode — .NET Framework 4.6.2 through .NET 9
using IronBarCode;

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

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

Imports IronBarCode

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

' Reading
Dim results = BarcodeReader.Read("barcode.png")
Dim value As String = results.FirstOrDefault()?.Value
Dim format As String = results.FirstOrDefault()?.Format.ToString()

' Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode) _
    .SaveAsPng("output.png")

Para obtener instrucciones detalladas sobre cómo leer códigos de barras en imágenes, consulte cómo leer códigos de barras en imágenes . Para generar códigos de barras 1D, incluidos los formatos Code 128, EAN-13 y UPC, consulte cómo crear códigos de barras 1D .

Kit de herramientas de mensajería. Enfoque de código de barras.

MessagingToolkit.Barcode no ha recibido actualizaciones desde abril de 2013. Cualquier vulnerabilidad descubierta después de esa fecha, en la lógica de análisis de imágenes de la biblioteca, en su implementación de decodificación derivada de ZXing o en sus dependencias transitivas, permanece sin parches. No hay un mantenedor público al que notificar, no hay un proceso de asesoramiento de seguridad para monitorear y no hay un mecanismo de versión a través del cual un parche podría llegar a los usuarios incluso si se desarrollara.

Herramientas de escaneo de seguridad, como Snyk, WhiteSource, GitHub Dependabot, y la auditoría de NuGet, comúnmente marcan paquetes no mantenidos como de riesgo elevado. La señalización no depende de la confirmación de una vulnerabilidad CVE; Esto refleja la ausencia de cualquier proceso mediante el cual se puedan remediar las vulnerabilidades confirmadas. Esa es un perfil de riesgo diferente al de una biblioteca con un mantenedor activo y un proceso documentado de respuesta de seguridad.

Para los equipos que operan bajo marcos de cumplimiento normativo —PCI DSS, HIPAA, SOC 2, ISO 27001— esto tiene consecuencias prácticas en materia de auditoría. Estos marcos esperan una gestión activa de parches de software de terceros, y un paquete no mantenido sin mecanismo de respuesta para vulnerabilidades suele ser marcado durante la revisión de auditoría, independientemente de si se ha presentado un CVE específico contra él. El hallazgo se relaciona con la postura de mantenimiento de la dependencia más que con la presencia de una explotación conocida.

Enfoque IronBarcode

IronBarcode recibe actualizaciones periódicas de NuGet que incluyen parches de seguridad, actualizaciones de dependencias y nuevas funcionalidades. La biblioteca está desarrollada por Iron Software, que mantiene un proceso de soporte documentado y publica notas de la versión para cada actualización. Las advertencias de seguridad, cuando corresponda, se abordan en las actualizaciones de seguridad.

IronBarcode admite más de 50 formatos de código de barras, incluidos todos los formatos que manejaba MessagingToolkit.Barcode (código QR, código 128, EAN-13, EAN-8, UPC-A y otros), junto con formatos que la biblioteca anterior nunca admitió: DataMatrix, Aztec, PDF417 y toda la gama de simbologías 2D modernas.

Requisitos de modernización del marco

El desencadenante más común es una actualización de .NET planificada o en curso. Cuando un equipo decide trasladar un proyecto de .NET Framework 4.x a .NET 6 o posterior, se debe auditar el gráfico de dependencias para detectar paquetes que carezcan de compatibilidad con el framework moderno. MessagingToolkit.Barcode aparecerá en esa auditoría como una dependencia que bloquea el proceso, es decir, una que no se puede resolver con un identificador de marco de trabajo de destino moderno. Por lo tanto, la migración a IronBarcode es un requisito previo para la actualización general de .NET , no una iniciativa independiente. Los equipos que llevan a cabo la modernización de aplicaciones suelen descubrir esta dependencia al principio de la fase de análisis de la actualización.

Obligaciones de seguridad y cumplimiento

Un segundo escenario contempla revisiones de seguridad y auditorías de cumplimiento. Los equipos que operan bajo los marcos PCI DSS, HIPAA, SOC 2 o ISO 27001 se someten a auditorías periódicas que examinan la salud de sus dependencias con terceros. Un paquete no mantenido sin mecanismo de respuesta de seguridad tiende a salir a la luz como un hallazgo de auditoría por motivos de proceso, independientemente de si se ha identificado una vulnerabilidad específica. Cuando un equipo de seguridad marca MessagingToolkit.Barcode como una dependencia no conforme, la resolución es el reemplazo: no hay un parche que aplicar, ni una versión a la que actualizar, ni un mantenedor a quien contactar para un aviso de seguridad. La migración a IronBarcode aborda el hallazgo de la auditoría al reemplazar una dependencia sin ruta de mantenimiento por una que recibe actualizaciones regulares de seguridad.

Expansión de capacidades

Un tercer escenario surge cuando los nuevos requisitos van más allá de lo que MessagingToolkit.Barcode puede ofrecer. Las aplicaciones que procesan documentos escaneados o archivos PDF necesitan leer códigos de barras de esos formatos; MessagingToolkit.Barcode solo aceptaba entradas de mapa de bits, lo que hacía imposible la lectura de PDF sin una capa de extracción independiente. Las aplicaciones que generan códigos de barras para entrega web necesitan salida en SVG o base64 — MessagingToolkit.Barcode devolvía un Bitmap, requiriendo pasos de conversión adicionales y una dependencia de System.Drawing.Imaging. Cuando los requisitos del producto se extienden a estas áreas, las limitaciones de la biblioteca anterior se convierten en restricciones de ingeniería que no se pueden sortear dentro de su interfaz de programación de aplicaciones (API).

Crecimiento objetivo de la plataforma

Un cuarto escenario es la adición de nuevos objetivos de despliegue. Los equipos que inicialmente construyeron aplicaciones solo para Windows y se están expandiendo al alojamiento en Linux, entornos de desarrollo en macOS, contenedores Docker o funciones en la nube en tiempos de ejecución Linux encuentran la dependencia System.Drawing como un problema bloqueante. MessagingToolkit.Barcode requiere System.Drawing.Bitmap para todas las operaciones de entrada y salida, y System.Drawing es exclusivo para Windows en .NET 6 y posteriores. Cualquier plataforma de implementación que no sea Windows convierte esta dependencia en un fallo en tiempo de ejecución, y no simplemente en un problema de compatibilidad. La migración a IronBarcode elimina completamente el requisito de System.Drawing, permitiendo la implementación multiplataforma que el equipo está intentando lograr.

Reemplazo de espacio de nombres

Cada archivo que contiene using MessagingToolkit.Barcode; requiere una actualización a using IronBarCode;. La búsqueda en todo el código fuente de la antigua cadena de espacio de nombres es el punto de partida más fiable para identificar el alcance de la migración. Los archivos que importan System.Drawing únicamente para el tipo Bitmap usado con MessagingToolkit.Barcode pueden tener esa importación eliminada por completo una vez que IronBarcode esté implementado, ya que IronBarcode no lo requiere.

Cambio del marco objetivo

Eliminar MessagingToolkit.Barcode del archivo del proyecto permite actualizar el identificador del marco de trabajo de destino. El cambio de <TargetFramework>net472</TargetFramework> a <TargetFramework>net8.0</TargetFramework> se vuelve posible una vez que se elimina la dependencia bloqueante. IronBarcode es compatible con ambos lados de este cambio: es compatible con .NET Framework 4.6.2 y con .NET 8, por lo que se puede instalar antes de que finalice la actualización del framework, lo que permite que la migración se realice por etapas en lugar de llevarse a cabo en un solo paso.

Diferencias en el espacio de nombres de BarcodeWriter

MessagingToolkit.Barcode usaba BarcodeEncoder como la clase de generación, con el formato establecido como una propiedad (barcodeWriter.Format = BarcodeFormat.QrCode) antes de llamar a .Encode(). IronBarcode usa BarcodeWriter.CreateBarcode() como un método estático, con el tipo de codificación pasado como un parámetro. Los nombres de las enumeraciones difieren: BarcodeFormat.QrCode se convierte en BarcodeEncoding.QRCode, y BarcodeFormat.Code128 se convierte en BarcodeEncoding.Code128. El resultado de CreateBarcode() es un objeto fluido con .SaveAsPng(), .SaveAsJpeg(), .SaveAsSvg() y otros métodos de salida — no devuelve un Bitmap.