El problema fundamental

QRCoder resuelve la generación de códigos QR de manera eficiente. En el momento en que cualquier requisito supere el nivel de complejidad QR, el código fuente debe comenzar a incorporar paquetes adicionales para cubrir cada deficiencia:

// Codificador de códigos QR handles QR generation well — but no further
using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("SHIP-12345", QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrCodeData);
File.WriteAllBytes("qr.png", qrCode.GetGraphic(10));

// Now the shipping team asks for Code 128 — add NetBarcode
// Now the warehouse needs to scan barcodes — add ZXing.Net
// Now a report needs a barcode in a PDF — add a PDF library
// Each addition: new namespace, new API, new maintenance cycle

// Codificador de códigos QR handles QR generation well — but no further
using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("SHIP-12345", QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrCodeData);
File.WriteAllBytes("qr.png", qrCode.GetGraphic(10));

// Now the shipping team asks for Code 128 — add NetBarcode
// Now the warehouse needs to scan barcodes — add ZXing.Net
// Now a report needs a barcode in a PDF — add a PDF library
// Each addition: new namespace, new API, new maintenance cycle

Imports QRCoder
Imports System.IO

Dim generator As New QRCodeGenerator()
Dim qrCodeData = generator.CreateQrCode("SHIP-12345", QRCodeGenerator.ECCLevel.M)
Dim qrCode As New PngByteQRCode(qrCodeData)
File.WriteAllBytes("qr.png", qrCode.GetGraphic(10))

' Now the shipping team asks for Code 128 — add NetBarcode
' Now the warehouse needs to scan barcodes — add ZXing.Net
' Now a report needs a barcode in a PDF — add a PDF library
' Each addition: new namespace, new API, new maintenance cycle

IronBarcode consolida la generación, la lectura y la integración de PDF bajo una única API:

// IronBarcode — one library covers all of the above
using IronBarCode;

// Generate QR
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Generate Code 128 — same API
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("label.png");

// Read a barcode from an image — built in
var results = BarcodeReader.Read("incoming.png");

// IronBarcode — one library covers all of the above
using IronBarCode;

// Generate QR
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Generate Code 128 — same API
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("label.png");

// Read a barcode from an image — built in
var results = BarcodeReader.Read("incoming.png");

Imports IronBarCode

' Generate QR
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

' Generate Code 128 — same API
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("label.png")

' Read a barcode from an image — built in
Dim results = BarcodeReader.Read("incoming.png")

Paso 1: Sustituir el paquete NuGet

Eliminar Codificador de códigos QR del proyecto:

dotnet remove package QRCoder

dotnet remove package QRCoder

Instalar IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

Si el proyecto utilizaba ZXing .NET junto con Codificador de códigos QR para la lectura de códigos de barras, ese paquete también se puede eliminar en esta etapa:

dotnet remove package ZXing.Net

dotnet remove package ZXing.Net

Paso 2: Actualizar los espacios de nombres

Reemplace la importación del espacio de nombres Codificador de códigos QR con el espacio de nombres IronBarcode :

// Before (QRCoder)
using QRCoder;

// After (IronBarcode)
using IronBarCode;

// Before (QRCoder)
using QRCoder;

// After (IronBarcode)
using IronBarCode;

' Before (QRCoder)
Imports QRCoder

' After (IronBarcode)
Imports IronBarCode

Paso 3: Inicializar licencia

Agregue la inicialización de la licencia al inicio de la aplicación — Program.cs, Startup.cs o un constructor estático:

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

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

Imports IronBarCode

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

Se puede obtener una clave de prueba gratuita sin necesidad de registrarse. Las implementaciones en entornos de producción requieren la compra de una licencia.

Generación básica de códigos QR

El patrón más común de Codificador de códigos QR requiere tres objetos: una instancia QRCodeGenerator, un objeto intermedio QRCodeData y una clase de renderizador como PngByteQRCode. En IronBarcode, una única llamada estática reemplaza esta cadena.

Enfoque de QRCoder:

using QRCoder;

public class BarcodeService
{
    private readonly QRCodeGenerator _generator = new QRCodeGenerator();

    public byte[] GenerateQR(string content)
    {
        var qrCodeData = _generator.CreateQrCode(content, QRCodeGenerator.ECCLevel.M);
        var qrCode = new PngByteQRCode(qrCodeData);
        return qrCode.GetGraphic(10); // 10px per module
    }
}

using QRCoder;

public class BarcodeService
{
    private readonly QRCodeGenerator _generator = new QRCodeGenerator();

    public byte[] GenerateQR(string content)
    {
        var qrCodeData = _generator.CreateQrCode(content, QRCodeGenerator.ECCLevel.M);
        var qrCode = new PngByteQRCode(qrCodeData);
        return qrCode.GetGraphic(10); // 10px per module
    }
}

Imports QRCoder

Public Class BarcodeService
    Private ReadOnly _generator As New QRCodeGenerator()

    Public Function GenerateQR(content As String) As Byte()
        Dim qrCodeData = _generator.CreateQrCode(content, QRCodeGenerator.ECCLevel.M)
        Dim qrCode = New PngByteQRCode(qrCodeData)
        Return qrCode.GetGraphic(10) ' 10px per module
    End Function
End Class

Enfoque de IronBarcode :

using IronBarCode;

public class BarcodeService
{
    public byte[] GenerateQR(string content)
    {
        return BarcodeWriter.CreateBarcode(content, BarcodeEncoding.QRCode)
            .ResizeTo(200, 200)
            .ToPngBinaryData();
    }
}

using IronBarCode;

public class BarcodeService
{
    public byte[] GenerateQR(string content)
    {
        return BarcodeWriter.CreateBarcode(content, BarcodeEncoding.QRCode)
            .ResizeTo(200, 200)
            .ToPngBinaryData();
    }
}

Imports IronBarCode

Public Class BarcodeService
    Public Function GenerateQR(content As String) As Byte()
        Return BarcodeWriter.CreateBarcode(content, BarcodeEncoding.QRCode) _
            .ResizeTo(200, 200) _
            .ToPngBinaryData()
    End Function
End Class

BarcodeWriter es una clase estática; no se requiere instancia y no hay objeto de datos intermedio. El método ResizeTo(width, height) reemplaza el entero píxeles-por-módulo que acepta Codificador de códigos QR en GetGraphic. Donde Codificador de códigos QR dimensiona la salida por el conteo de módulos (por ejemplo, GetGraphic(10) para una imagen de 10px por módulo), IronBarcode toma dimensiones absolutas en píxeles.

Guardar códigos QR en un archivo

QRCoder separa los bytes en memoria de la salida del archivo únicamente en el paso de terminal; la cadena de renderizado es la misma. IronBarcode utiliza diferentes métodos de terminal en la misma cadena.

Enfoque de QRCoder:

using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
var pngBytes = new PngByteQRCode(qrCodeData).GetGraphic(10);
File.WriteAllBytes("output.png", pngBytes);

using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
var pngBytes = new PngByteQRCode(qrCodeData).GetGraphic(10);
File.WriteAllBytes("output.png", pngBytes);

Imports QRCoder
Imports System.IO

Dim generator As New QRCodeGenerator()
Dim qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)
Dim pngBytes = New PngByteQRCode(qrCodeData).GetGraphic(10)
File.WriteAllBytes("output.png", pngBytes)

Enfoque de IronBarcode :

using IronBarCode;

// Save directly — no intermediate byte array needed
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .SaveAsPng("output.png");

// Or obtain bytes for in-memory use
byte[] pngBytes = BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .ToPngBinaryData();

using IronBarCode;

// Save directly — no intermediate byte array needed
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .SaveAsPng("output.png");

// Or obtain bytes for in-memory use
byte[] pngBytes = BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .ToPngBinaryData();

Imports IronBarCode

' Save directly — no intermediate byte array needed
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(300, 300) _
    .SaveAsPng("output.png")

' Or obtain bytes for in-memory use
Dim pngBytes As Byte() = BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(300, 300) _
    .ToPngBinaryData()

El método SaveAsPng es un terminal que escribe directamente al disco. ToPngBinaryData devuelve un byte[] para transmisión, respuestas HTTP o almacenamiento en base de datos.

Salida SVG

Enfoque de QRCoder:

using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("output.svg", svgContent);

using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("output.svg", svgContent);

Imports QRCoder
Imports System.IO

Dim generator As New QRCodeGenerator()
Dim qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)
Dim svgContent As String = New SvgQRCode(qrCodeData).GetGraphic(10)
File.WriteAllText("output.svg", svgContent)

Enfoque de IronBarcode :

using IronBarCode;

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsImage("output.svg");

using IronBarCode;

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsImage("output.svg");

Imports IronBarCode

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsImage("output.svg")

La clase de renderizador SvgQRCode y su llamada GetGraphic se combinan en un único método terminal SaveAsImage (pasar una extensión .svg produce salida SVG).

Mapeo del nivel de corrección de errores

QRCoder requiere selección explícita de ECC en cada llamada CreateQrCode usando el enum QRCodeGenerator.ECCLevel. IronBarcode aplica un valor predeterminado sensato al usar BarcodeWriter.CreateBarcode, y expone control explícito a través de QRCodeWriter.QrErrorCorrectionLevel.

Enfoque de QRCoder:

using QRCoder;

var generator = new QRCodeGenerator();

// Medium — suitable for most generation without logos
var dataMedium = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);

// High — required when a logo will occlude part of the code
var dataHigh = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H);

using QRCoder;

var generator = new QRCodeGenerator();

// Medium — suitable for most generation without logos
var dataMedium = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);

// High — required when a logo will occlude part of the code
var dataHigh = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H);

Imports QRCoder

Dim generator As New QRCodeGenerator()

' Medium — suitable for most generation without logos
Dim dataMedium = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

' High — required when a logo will occlude part of the code
Dim dataHigh = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H)

Enfoque de IronBarcode :

using IronBarCode;

// Default — equivalent to Medium, applied automatically
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("default-ecc.png");

// Explicit level via QRCodeWriter
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.SaveAsPng("high-ecc.png");

using IronBarCode;

// Default — equivalent to Medium, applied automatically
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("default-ecc.png");

// Explicit level via QRCodeWriter
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.SaveAsPng("high-ecc.png");

Imports IronBarCode

' Default — equivalent to Medium, applied automatically
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("default-ecc.png")

' Explicit level via QRCodeWriter
Dim qr = QRCodeWriter.CreateQrCode( _
    "https://example.com", _
    500, _
    QRCodeWriter.QrErrorCorrectionLevel.Highest _
)
qr.SaveAsPng("high-ecc.png")

El mapeo de niveles es: ECCLevel.L → Low, ECCLevel.M → Medium, ECCLevel.Q → High, ECCLevel.H → Highest.

Inserción de logotipo

Ambas bibliotecas permiten la inserción de logotipos en códigos QR. Codificador de códigos QR enruta esto a través de la clase de renderizador QRCode (no PngByteQRCode) con parámetros System.Drawing.Bitmap. IronBarcode proporciona QRCodeWriter.CreateQrCodeWithLogo() como un método de fábrica dedicado que acepta rutas de archivo tanto para la URL como para el logo. La guía de personalización del código QR abarca opciones de tamaño, posicionamiento y combinación de colores para el logotipo.

Enfoque de QRCoder:

using QRCoder;
using System.Drawing;
using System.Drawing.Imaging;

var generator = new QRCodeGenerator();
// ECCLevel.H is required — the logo occludes part of the code
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", ImageFormat.Png);

using QRCoder;
using System.Drawing;
using System.Drawing.Imaging;

var generator = new QRCodeGenerator();
// ECCLevel.H is required — the logo occludes part of the code
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", ImageFormat.Png);

Imports QRCoder
Imports System.Drawing
Imports System.Drawing.Imaging

Dim generator As New QRCodeGenerator()
' ECCLevel.H is required — the logo occludes part of the code
Dim qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H)

Dim qrCode As New QRCode(qrCodeData)
Dim logoBitmap As New Bitmap("logo.png")
Dim qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap)
qrBitmap.Save("qr-logo.png", ImageFormat.Png)

Enfoque de IronBarcode :

using IronBarCode;

QRCodeWriter.CreateQrCodeWithLogo("https://example.com", "logo.png", 500)
    .SaveAsPng("qr-logo.png");

using IronBarCode;

QRCodeWriter.CreateQrCodeWithLogo("https://example.com", "logo.png", 500)
    .SaveAsPng("qr-logo.png");

Imports IronBarCode

QRCodeWriter.CreateQrCodeWithLogo("https://example.com", "logo.png", 500) _
    .SaveAsPng("qr-logo.png")

La dependencia System.Drawing.Bitmap se elimina — CreateQrCodeWithLogo acepta cadenas de ruta de archivo tanto para el contenido como para la imagen del logo. La corrección de errores se configura automáticamente al nivel requerido para la incrustación de logos; no se necesita configuración de ECC explícita.

Generador de carga útil. Migración WiFi

El PayloadGenerator.WiFi de Codificador de códigos QR formatea la cadena de carga útil QR estándar para WiFi. El formato de salida es un estándar público (WIFI:T:{auth};S:{ssid};P:{password};;) definido por la especificación del código QR. Al migrar, estas cadenas se pueden construir directamente.

Enfoque de QRCoder:

using QRCoder;

var wifi = new PayloadGenerator.WiFi(
    ssid: "OfficeNetwork",
    password: "SecurePass123",
    authenticationMode: PayloadGenerator.WiFi.Authentication.WPA
);
// wifi.ToString() produces: WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;

var generator = new QRCodeGenerator();
var qrData = generator.CreateQrCode(wifi.ToString(), QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrData);
System.IO.File.WriteAllBytes("wifi.png", qrCode.GetGraphic(10));

using QRCoder;

var wifi = new PayloadGenerator.WiFi(
    ssid: "OfficeNetwork",
    password: "SecurePass123",
    authenticationMode: PayloadGenerator.WiFi.Authentication.WPA
);
// wifi.ToString() produces: WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;

var generator = new QRCodeGenerator();
var qrData = generator.CreateQrCode(wifi.ToString(), QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrData);
System.IO.File.WriteAllBytes("wifi.png", qrCode.GetGraphic(10));

Imports QRCoder

Dim wifi = New PayloadGenerator.WiFi(
    ssid:="OfficeNetwork",
    password:="SecurePass123",
    authenticationMode:=PayloadGenerator.WiFi.Authentication.WPA
)
' wifi.ToString() produces: WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;

Dim generator = New QRCodeGenerator()
Dim qrData = generator.CreateQrCode(wifi.ToString(), QRCodeGenerator.ECCLevel.M)
Dim qrCode = New PngByteQRCode(qrData)
System.IO.File.WriteAllBytes("wifi.png", qrCode.GetGraphic(10))

Enfoque de IronBarcode :

using IronBarCode;

// Construct the standard WiFi QR string directly
string wifiPayload = "WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;";
BarcodeWriter.CreateBarcode(wifiPayload, BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .SaveAsPng("wifi.png");

using IronBarCode;

// Construct the standard WiFi QR string directly
string wifiPayload = "WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;";
BarcodeWriter.CreateBarcode(wifiPayload, BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .SaveAsPng("wifi.png");

Imports IronBarCode

' Construct the standard WiFi QR string directly
Dim wifiPayload As String = "WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;"
BarcodeWriter.CreateBarcode(wifiPayload, BarcodeEncoding.QRCode) _
    .ResizeTo(300, 300) _
    .SaveAsPng("wifi.png")

Para equipos con muchos tipos PayloadGenerator en uso (vCard, CalendarEvent, Geo, SMS), el enfoque es el mismo: identifique la cadena formateada que cada generador produce usando su salida .ToString(), luego construya esa cadena directamente o a través de un pequeño método de ayuda estático.

Problema 1: Cambio en el formato de la cadena del generador de carga útil

QRCoder: PayloadGenerator.WiFi, PayloadGenerator.ContactData y otros auxiliares producen cadenas formateadas automáticamente. El código pasa la salida .ToString() del objeto auxiliar a CreateQrCode.

Solución: Identifique la cadena que cada tipo PayloadGenerator produce; su formato está documentado en la especificación del código QR y es sencillo de reproducir. Para WiFi: WIFI:T:WPA;S:{ssid};P:{password};;. Para vCard: bloques estándar BEGIN:VCARD / END:VCARD. Escriba métodos auxiliares estáticos si muchos sitios de llamada utilizan el mismo tipo de carga útil:

public static string WifiPayload(string ssid, string password, string auth = "WPA")
    => $"WIFI:T:{auth};S:{ssid};P:{password};;";

public static string WifiPayload(string ssid, string password, string auth = "WPA")
    => $"WIFI:T:{auth};S:{ssid};P:{password};;";

Public Shared Function WifiPayload(ssid As String, password As String, Optional auth As String = "WPA") As String
    Return $"WIFI:T:{auth};S:{ssid};P:{password};;"
End Function

Problema 2: Asignación de enumeraciones ECCLevel

QRCoder: QRCodeGenerator.ECCLevel es un enum anidado con valores L, M, Q, H. Es un parámetro requerido en cada llamada CreateQrCode.

Solución: Mapee cada valor a su equivalente QRCodeWriter.QrErrorCorrectionLevel al usar la ruta QRCodeWriter. Al usar BarcodeWriter.CreateBarcode, el nivel ECC predeterminado es Medio automáticamente y no requiere parámetro. Actualizar cada sitio de llamadas:

// Codificador de códigos QR ECCLevel.H → IronBarcode QrErrorCorrectionLevel.Highest
var qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);

// Codificador de códigos QR ECCLevel.M → IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode);

// Codificador de códigos QR ECCLevel.H → IronBarcode QrErrorCorrectionLevel.Highest
var qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);

// Codificador de códigos QR ECCLevel.M → IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode);

' Codificador de códigos QR ECCLevel.H → IronBarcode QrErrorCorrectionLevel.Highest
Dim qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)

' Codificador de códigos QR ECCLevel.M → IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)

Problema 3: Eliminación de la clase Renderer

QRCoder: Cada formato de salida requiere su propia instancia de clase de renderizador — PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode. Estas clases aceptan QRCodeData y exponen GetGraphic con diferentes tipos de retorno.

Solución: Eliminar todas las instancias de la clase de renderizado. IronBarcode incorpora la salida de formato en los métodos de terminal de la cadena fluida. Reemplace new PngByteQRCode(data).GetGraphic(n) por .ToPngBinaryData() después de .ResizeTo(). Reemplace new SvgQRCode(data).GetGraphic(n) por .SaveAsImage(path) (pasando una extensión .svg). El objeto intermedio QRCodeData también desaparece — no es necesario en IronBarcode.

Problema 4: Eliminación de PngByteQRCode y dimensionamiento basado en módulos

QRCoder: PngByteQRCode.GetGraphic(int pixelsPerModule) dimensiona la salida por el número de píxeles por módulo QR. Las dimensiones de la imagen resultante dependen del número de módulos, que varía según la longitud del contenido y el nivel ECC.

Solución: Reemplace el dimensionamiento basado en módulos con ResizeTo(int width, int height) para dimensiones absolutas en píxeles. Si su código calcula el tamaño de salida esperado de forma dinámica a partir del número de módulos, cambie a un tamaño objetivo fijo que cumpla con sus requisitos de salida:

// Before: GetGraphic(20) — output size varies with content
var bytes = new PngByteQRCode(qrData).GetGraphic(20);

// After: fixed 400×400 regardless of content
byte[] bytes = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .ToPngBinaryData();

// Before: GetGraphic(20) — output size varies with content
var bytes = new PngByteQRCode(qrData).GetGraphic(20);

// After: fixed 400×400 regardless of content
byte[] bytes = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .ToPngBinaryData();

Imports System

' Before: GetGraphic(20) — output size varies with content
Dim bytes = New PngByteQRCode(qrData).GetGraphic(20)

' After: fixed 400×400 regardless of content
Dim bytes As Byte() = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode) _
    .ResizeTo(400, 400) _
    .ToPngBinaryData()

Tareas previas a la migración

Antes de realizar cualquier cambio, revise el código fuente para detectar cualquier uso de QRCoder:

# Find all Codificador de códigos QR namespace imports
grep -r "using QRCoder" --include="*.cs" .

# Find all generator and renderer instantiations
grep -r "QRCodeGenerator\|PngByteQRCode\|SvgQRCode\|AsciiQRCode\|QRCode\b" --include="*.cs" .

# Find all PayloadGenerator usages
grep -r "PayloadGenerator\." --include="*.cs" .

# Find ECCLevel references
grep -r "ECCLevel\." --include="*.cs" .

# Find ZXing.Net usage to remove at the same time
grep -r "using ZXing" --include="*.cs" .

# Find all Codificador de códigos QR namespace imports
grep -r "using QRCoder" --include="*.cs" .

# Find all generator and renderer instantiations
grep -r "QRCodeGenerator\|PngByteQRCode\|SvgQRCode\|AsciiQRCode\|QRCode\b" --include="*.cs" .

# Find all PayloadGenerator usages
grep -r "PayloadGenerator\." --include="*.cs" .

# Find ECCLevel references
grep -r "ECCLevel\." --include="*.cs" .

# Find ZXing.Net usage to remove at the same time
grep -r "using ZXing" --include="*.cs" .

• Documente todos los tipos PayloadGenerator en uso y anote sus formatos de salida de cadena
• Anote todos los valores de nivel ECC en uso y sus ubicaciones de llamada.
• Identifique cualquier código de lectura ZXing .NET que se haya emparejado con Codificador de códigos QR para su decodificación; esto se puede reemplazar al mismo tiempo.
• Obtenga una clave de licencia de IronBarcode (hay claves de prueba disponibles sin necesidad de registro).

Tareas de actualización de código

1. Ejecute dotnet remove package QRCoder
2. Ejecute dotnet remove package ZXing.Net si solo se usaba para lectura junto con QRCoder
3. Ejecute dotnet add package IronBarcode
4. Agregue IronBarCode.License.LicenseKey = "YOUR-KEY"; al inicio de la aplicación
5. Reemplace todas las importaciones using QRCoder; con using IronBarCode;
6. Elimine todas las declaraciones de instancia new QRCodeGenerator() — BarcodeWriter es estático
7. Reemplace todos los patrones de cadena de renderizador generator.CreateQrCode(data, ECCLevel.X) + con cadenas BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
8. Reemplace las llamadas .GetGraphic(n) con .ToPngBinaryData() y agregue .ResizeTo(w, h) antes del terminal
9. Reemplace los patrones de guardado File.WriteAllBytes(path, bytes) con métodos terminales .SaveAsPng(path)
10. Reemplace new SvgQRCode(data).GetGraphic(n) por .SaveAsImage(path) (pasar una extensión .svg)
11. Reemplace PayloadGenerator.WiFi(...) y otras instancias de auxiliares con cadenas de formato directo
12. Mapee cada valor QRCodeGenerator.ECCLevel a su equivalente QRCodeWriter.QrErrorCorrectionLevel
13. Reemplace cualquier llamada BarcodeReaderGeneric.Decode(bitmap) de ZXing.Net por BarcodeReader.Read(path)
14. Para la incrustación de logos, reemplace new QRCode(data).GetGraphic(n, ..., logoBitmap) por QRCodeWriter.CreateQrCodeWithLogo(data, logoPath, size)

Pruebas posteriores a la migración

• Escanee todos los códigos QR generados con al menos dos aplicaciones de escaneo de códigos QR independientes para verificar su legibilidad.
• Verifique que los códigos QR con logo se escaneen correctamente — confirme que el nivel de corrección de errores es Highest
• Comparar la salida visual de los códigos generados con muestras previas a la migración donde se requiere consistencia en la apariencia.
• Pruebe todos los reemplazos PayloadGenerator — confirme que las cadenas de carga útil de WiFi, vCard y otras se decodifiquen correctamente en los dispositivos de destino
• Si ZXing.Net también fue removido, verifique que todas las rutas de lectura de códigos de barras funcionen a través de BarcodeReader.Read
• Ejecute la aplicación en un entorno limpio para confirmar que no queden referencias residuales a Codificador de códigos QR o ZXing .NET que provoquen fallos de enlace.
• Validar que la clave de licencia de IronBarcode se cargue correctamente en los entornos de producción y de prueba.