Generador y Lector de Códigos QR .NET Core | IronQR

¿Cómo instalar una biblioteca de códigos QR en .NET Core?

Para empezar, abra Visual Studio y haga clic en el botón Crear para iniciar un nuevo proyecto. Una vez asignado el nombre del proyecto, la instalación de la biblioteca a través del gestor de paquetes NuGet se realiza en cuestión de segundos. Mientras que algunos desarrolladores podrían buscar el paquete NuGet de QRCoder, usted puede instalar el framework IronQR ejecutando el siguiente comando en la consola del gestor de paquetes:

Install-Package IronQR

También puede utilizar la interfaz de usuario del gestor de paquetes NuGet buscando "IronQR" y haciendo clic en el botón de instalación. La biblioteca ofrece una implementación .NET compatible con .NET Core 3.x, .NET 5, 6, 7, 8, 9 y 10, lo que la hace ideal para el desarrollo web moderno y los proyectos multiplataforma.

Tras la instalación, agregue las directivas using requeridas al principio del archivo. IronQR se integra con IronSoftware.Drawing para la gestión de imágenes multiplataforma, eliminando así la necesidad de dependencias específicas de la plataforma, como System.Drawing.Common, que quedó obsoleta para su uso multiplataforma en .NET 6 y versiones posteriores.

Puede verificar que la instalación se realizó correctamente revisando las referencias del paquete de su proyecto en el archivo .csproj o confirmando que el paquete NuGet aparece en la salida de la consola del Administrador de paquetes. Una vez instalada, la referencia de la API de IronQR estará disponible de inmediato.

¿Cómo se genera un código QR?

La clase QrWriter , a menudo utilizada junto con métodos de extensión convenientes, hace que la generación de códigos QR sea sencilla. Aquí está el código fuente de un ejemplo completo que utiliza declaraciones de nivel superior para generar un código QR en solo unas pocas líneas de código:

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from input text
QrCode qrcode = QrWriter.Write("https://ironsoftware.com");

// Save as PNG image
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("website-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from input text
QrCode qrcode = QrWriter.Write("https://ironsoftware.com");

// Save as PNG image
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("website-qr.png");

¿Qué son los niveles de corrección de errores y por qué son importantes?

La corrección de errores determina cuánto daño puede sufrir un símbolo QR sin dejar de ser escaneable. Se trata de una de las características avanzadas opcionales que permite la creación de marca y la durabilidad. El estándar de código QR (ISO/IEC 18004) define cuatro niveles de corrección de errores, cada uno de los cuales negocia la capacidad de resiliencia de los datos.

Configurar la corrección de errores usando QrOptions :

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrectionNivel.High, 20);

// Generate QR code with options
QrCode qrcode = QrWriter.Write("Product-12345", options);
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("product-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrectionNivel.High, 20);

// Generate QR code with options
QrCode qrcode = QrWriter.Write("Product-12345", options);
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("product-qr.png");

¿Cómo personalizar la apariencia del código QR con logotipo y colores?

QrStyleOptions de IronQR permite la generación de códigos QR alineados con la marca con colores, dimensiones y logotipos integrados personalizados. Esto es particularmente útil para materiales de marketing, empaques de productos y entradas a eventos donde la coherencia visual es importante.

using IronQr;
using IronSoftware.Drawing;

var styleOptions = new QrStyleOptions
{
    Dimensions = 300,
    Margins = 10,
    Color = Color.DarkBlue,
    Logo = new QrLogo { Bitmap = AnyBitmap.FromFile("company-logo.png") }
};

QrCode qrcode = QrWriter.Write("https://yourcompany.com");
AnyBitmap qrImage = qrcode.Save(styleOptions);
qrImage.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

var styleOptions = new QrStyleOptions
{
    Dimensions = 300,
    Margins = 10,
    Color = Color.DarkBlue,
    Logo = new QrLogo { Bitmap = AnyBitmap.FromFile("company-logo.png") }
};

QrCode qrcode = QrWriter.Write("https://yourcompany.com");
AnyBitmap qrImage = qrcode.Save(styleOptions);
qrImage.SaveAs("branded-qr.png");

¿Cómo generar códigos QR en ASP.NET Core?

La integración de la generación de códigos QR en ASP.NET Core sigue el patrón Modelo Vista Controlador. Aquí hay una implementación de clase HomeController que devuelve una imagen de código QR directamente desde un método de acción:

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

namespace Examples
{
    public class HomeController : Controller
    {
        public IActionResult GenerateQR(string content)
        {
            QrCode myQr = QrWriter.Write(content);
            AnyBitmap qrImage = myQr.Save();
            byte[] imageBytes = qrImage.ExportBytes();
            return File(imageBytes, "image/png");
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

namespace Examples
{
    public class HomeController : Controller
    {
        public IActionResult GenerateQR(string content)
        {
            QrCode myQr = QrWriter.Write(content);
            AnyBitmap qrImage = myQr.Save();
            byte[] imageBytes = qrImage.ExportBytes();
            return File(imageBytes, "image/png");
        }
    }
}

Este endpoint acepta datos de código QR como parámetro y devuelve directamente la imagen PNG generada. Este enfoque funciona tanto con proyectos de API web ASP.NET Core como con vistas de Razor .

Para las aplicaciones ASP.NET Core de producción, considere almacenar en caché los códigos QR generados con frecuencia usando IMemoryCache o IDistributedCache para reducir la sobrecarga de la CPU. Los códigos QR para URL estáticas, identificadores de productos o enlaces de eventos no cambian entre solicitudes y son candidatos ideales para el almacenamiento en caché.

También puedes integrar IronQR en un punto final de API mínima. El tutorial de integración de ASP.NET Core proporciona un ejemplo completo que incluye patrones de inyección de dependencia y cómo servir imágenes de código QR desde un componente Blazor .

Registrar la clave de licencia de IronQR en Program.cs usando el patrón de declaración de nivel superior mantiene limpia la configuración de inicio:

using IronQr;

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

using IronQr;

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

Establezca la clave de licencia antes de llamar a cualquier método IronQR . En desarrollo, puede aplicar una clave de prueba gratuita obtenida de la página de licencias de IronQR .

¿Cómo se codifica el texto Unicode japonés?

IronQR admite la codificación de texto Unicode japonés a través del modo Kanji, que codifica de manera eficiente caracteres Unicode japoneses utilizando menos segmentos de datos que la codificación estándar. Esto reduce la versión (tamaño) del código QR para el mismo contenido, produciendo un símbolo menos complejo que se escanea más rápido.

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

¿Cómo leer códigos QR con aprendizaje automático?

IronQR se distingue por su lector QR impulsado por aprendizaje automático . El modelo ML logra una alta precisión incluso al leer códigos QR desde ángulos o imágenes parcialmente oscurecidas: una ventaja significativa sobre los algoritmos de detección tradicionales basados ​​en umbrales utilizados en muchas alternativas de código abierto.

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
AnyBitmap inputBmp = AnyBitmap.FromFile("scanned-document.png");
QrImageInput imageInput = new QrImageInput(inputBmp);

// Read with ML-powered detection
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

foreach (var result in results)
{
    Console.WriteLine($"Found: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
AnyBitmap inputBmp = AnyBitmap.FromFile("scanned-document.png");
QrImageInput imageInput = new QrImageInput(inputBmp);

// Read with ML-powered detection
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

foreach (var result in results)
{
    Console.WriteLine($"Found: {result.Value}");
}

¿Cómo funciona el soporte multiplataforma?

A diferencia de las soluciones que dependen de System.Drawing.Common (obsoleto para uso multiplataforma en .NET 6+), IronQR usa IronSoftware.Drawing para proyectos verdaderamente multiplataforma. Su código se ejecuta de forma coherente en Windows, macOS, Linux, iOS y Android. Para proyectos multiplataforma, las alternativas a SkiaSharp son innecesarias: IronQR maneja la abstracción de la plataforma internamente.

La documentación multiplataforma de .NET explica la historia más amplia de compatibilidad de plataformas for .NET 10. IronQR se alinea con estos principios al evitar por completo las API específicas de la plataforma.

IronQR admite los siguientes objetivos de implementación:

• .NET 10, 9, 8, 7, 6 : todas las versiones modernas de .NET
• .NET Core 3.x : para aplicaciones que aún no han migrado a .NET moderno
• Xamarin y MAUI - para el desarrollo de aplicaciones móviles
• Azure Functions y AWS Lambda : para cargas de trabajo sin servidor

Al ejecutarse en contenedores Docker, no se necesitan paquetes de sistema adicionales más allá de la imagen de ejecución .NET estándar. Esto simplifica su Dockerfile en comparación con las bibliotecas que requieren dependencias GDI+ nativas. La guía de implementación de IronQR cubre la configuración para entornos en contenedores y en la nube.

¿Cómo se compara IronQR con otras bibliotecas QR .NET ?

Existen varias bibliotecas de códigos QR .NET , cada una con diferentes ventajas y desventajas. Comprender las diferencias le ayudará a elegir la herramienta adecuada para su proyecto.

QRCoder es una biblioteca de código abierto con licencia MIT. Funciona bien para la generación directa de códigos QR, pero no incluye capacidades de lectura de códigos QR ni detección impulsada por aprendizaje automático. Sus opciones de salida son más limitadas en comparación con el soporte de salida estilizada de IronQR.

ZXing .NET es un puerto C# de la biblioteca Java ZXing. Admite tanto lectura como escritura, pero se basa en técnicas de visión artificial tradicionales que tienen problemas con códigos dañados o rotados. El manejo de imágenes multiplataforma requiere configuración adicional.

IronQR ofrece generación y lectura en un solo paquete, con licencia empresarial que incluye soporte dedicado. El lector con tecnología ML, la salida estilizada y la integración IronSoftware.Drawing lo convierten en una solución más completa para aplicaciones de producción.

Para obtener una comparación detallada de las características, consulte los artículos Comparación de IronQR vs QRCoder y Comparación de IronQR vs ZXing .

¿Cuales son tus próximos pasos?

IronQR proporciona una solución completa para la generación y lectura de códigos QR en .NET Core. Al manejar automáticamente generadores de carga útiles complejos y el ensamblaje de módulos sin procesar y datos QrCodeData, simplifica el ciclo de desarrollo. Ya sea que necesite una alternativa de biblioteca de código abierto simple o un sistema con funciones avanzadas opcionales, la arquitectura multiplataforma de IronQR garantiza un funcionamiento confiable.

Para continuar desarrollando con IronQR, explora estos recursos:

• Paquete NuGet IronQR : instala la última versión estable
• Referencia de la API de IronQR : documentación completa de clases y métodos
• Ejemplos de códigos QR : código listo para copiar y pegar para situaciones comunes
• Tutoriales de IronQR : guías paso a paso para casos de uso específicos
• Opciones de licencia : elija el plan adecuado para su proyecto

Comience su prueba gratuita para desbloquear todo el potencial de IronQR sin ningún compromiso inicial.