Gerador e leitor de código QR for .NET Core | IronQR

Como você instala uma biblioteca de código QR no .NET Core?

Para começar, abra o Visual Studio e clique no botão de criar para iniciar um novo projeto. Uma vez que você atribuiu um nome ao projeto, instalar a biblioteca através do Gerenciador de Pacotes NuGet leva apenas alguns segundos. Enquanto alguns desenvolvedores podem procurar pelo pacote NuGet QRCoder, você pode instalar o framework IronQR executando o seguinte comando no Console do Gerenciador de Pacotes:

Install-Package IronQR

Alternativamente, use a interface do Gerenciador de Pacotes NuGet buscando por "IronQR" e clicando no botão de instalar. A biblioteca fornece uma implementação .NET compatível com .NET Core 3.x, .NET 5, 6, 7, 8, 9, e 10, tornando-a ideal para o desenvolvimento web moderno e projetos multiplataforma.

Após a instalação, adicione as diretivas necessárias using no topo do seu arquivo. IronQR se integra com IronSoftware.Drawing para o manuseio de imagens multiplataforma, eliminando a necessidade de dependências específicas de plataforma, como System.Drawing.Common, que foi deprecated para uso multiplataforma no .NET 6 e posterior.

Você pode verificar se a instalação foi bem-sucedida conferindo as referências de pacotes do seu projeto no arquivo .csproj ou confirmando que o pacote NuGet aparece na saída do console do Gerenciador de Pacotes. Uma vez instalado, a referência da API IronQR fica imediatamente disponível.

Como você gera um código QR?

A classe QrWriter, frequentemente usada junto com métodos de extensão convenientes, torna a geração de códigos QR simples. Aqui está o código-fonte de um exemplo completo usando declarações de nível superior para gerar um código QR em apenas algumas linhas 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");

Quais são os níveis de correção de erro e por que eles importam?

A correção de erro determina quanto dano um símbolo QR pode suportar enquanto permanece legível. Este é um dos recursos avançados opcionais que permitem branding e durabilidade. O padrão de código QR (ISO/IEC 18004) define quatro níveis de correção de erro, cada um trocando capacidade de dados por resiliência.

Configure a correção de erro usando QrOptions:

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrectionNível.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(QrErrorCorrectionNível.High, 20);

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

Como personalizar a aparência do código QR com logotipo e cores?

O QrStyleOptions do IronQR permite a geração de código QR alinhada à marca com cores personalizadas, dimensões e logotipos incorporados. Isso é particularmente útil para materiais de marketing, embalagens de produtos e ingressos de eventos onde a consistência visual importa.

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");

Como você gera códigos QR no ASP.NET Core?

Integrar a geração de códigos QR no ASP.NET Core segue o padrão Model View Controller. Aqui está uma implementação da classe HomeController que retorna uma imagem de código QR diretamente de um método de ação:

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 aceita dados de código QR como parâmetro e retorna a imagem PNG gerada diretamente. A abordagem funciona tanto com projetos ASP.NET Core Web API quanto com views Razor.

Para aplicações de produção ASP.NET Core, considere armazenar em cache os códigos QR gerados com frequência usando IMemoryCache ou IDistributedCache para reduzir a sobrecarga da CPU. Códigos QR para URLs estáticas, identificadores de produtos ou links de eventos não mudam entre solicitações e são candidatos ideais para cache.

Você também pode integrar IronQR em um endpoint de API Minimal. O tutorial de integração do ASP.NET Core fornece um exemplo completo, incluindo padrões de injeção de dependência e como servir imagens de código QR a partir de um componente Blazor.

Registrar a chave de licença do IronQR em Program.cs usando o padrão de declaração de nível superior mantém a configuração de inicialização limpa:

using IronQr;

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

using IronQr;

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

Defina a chave de licença antes de chamar qualquer método do IronQR. Durante o desenvolvimento, você pode aplicar uma chave de teste gratuita obtida na página de licenciamento do IronQR.

Como codificar texto Unicode em japonês?

O IronQR suporta a codificação de texto Unicode em japonês através do modo Kanji, que codifica eficientemente caracteres unicode japoneses usando menos segmentos de dados do que a codificação padrão. Isso reduz a versão (tamanho) do código QR para o mesmo conteúdo, produzindo um símbolo menos complexo que é escaneado mais rapidamente.

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");

Como ler códigos QR com aprendizado de máquina?

O IronQR se destaca através de seu leitor de QR com aprendizado de máquina. O modelo de ML atinge alta precisão, mesmo lendo códigos QR de ângulos ou imagens parcialmente obscurecidas -- uma vantagem significativa sobre os algoritmos de detecção baseados em limiar tradicionais usados em muitas alternativas open source.

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}");
}

Como funciona o suporte multiplataforma?

Ao contrário das soluções dependentes de System.Drawing.Common (deprecated para uso multiplataforma no .NET 6+), IronQR usa IronSoftware.Drawing para projetos verdadeiramente multiplataforma. Seu código roda de forma consistente no Windows, macOS, Linux, iOS e Android. Para projetos multiplataforma, alternativas ao SkiaSharp são desnecessárias -- IronQR lida com abstração de plataforma internamente.

A documentação de .NET multiplataforma explica a história mais ampla de compatibilidade de plataforma for .NET 10. IronQR se alinha com esses princípios ao evitar APIs específicas de plataforma completamente.

O IronQR oferece suporte aos seguintes alvos de implantação:

• .NET 10, 9, 8, 7, 6 -- todas as versões modernas do .NET
• .NET Core 3.x -- para aplicações que ainda não migraram para o .NET moderno
• Xamarin e MAUI -- para desenvolvimento de aplicações móveis
• Azure Functions e AWS Lambda -- para cargas de trabalho serverless

Ao rodar em contêineres Docker, não são necessários pacotes de sistema adicionais além da imagem de runtime padrão do .NET. Isso simplifica o seu Dockerfile em comparação com bibliotecas que requerem dependências nativas de GDI+. O guia de implantação do IronQR cobre a configuração para ambientes conteinerizados e na nuvem.

Como comparar o IronQR com outras bibliotecas .NET de QR?

Existem várias bibliotecas .NET de código QR, cada uma com diferentes compromissos. Entender as diferenças ajuda a escolher a ferramenta certa para seu projeto.

QRCoder é uma biblioteca open source com uma licença MIT. Funciona bem para geração básica de códigos QR, mas não inclui capacidades de leitura de códigos QR ou detecção com aprendizado de máquina. Suas opções de saída são mais limitadas em comparação com o suporte a saída estilizada do IronQR.

ZXing.NET é uma versão em C# da biblioteca Java ZXing. Oferece suporte tanto para leitura quanto para escrita, mas depende de técnicas tradicionais de visão computacional que têm dificuldade com códigos danificados ou rotacionados. O manuseio de imagens multiplataforma requer configuração adicional.

IronQR oferece geração e leitura em um único pacote, com licenciamento enterprise que inclui suporte dedicado. O leitor potenciado por ML, saída estilizada e integração IronSoftware.Drawing tornam-na uma solução mais completa para aplicações de produção.

Para uma comparação detalhada de recursos, consulte os artigos IronQR vs QRCoder e IronQR vs ZXing.

Quais são os seus próximos passos?

IronQR oferece uma solução completa para geração e leitura de códigos QR no .NET Core. Ao lidar automaticamente com geradores de payload complexos e a montagem de módulos brutos e dados QrCodeData, simplifica o ciclo de desenvolvimento. Seja você precisar de uma alternativa simples de biblioteca open source ou de um sistema com recursos avançados opcionais, a arquitetura multiplataforma do IronQR garante operação confiável.

Para continuar construindo com IronQR, explore estes recursos:

• Pacote NuGet IronQR -- instale a última versão estável
• Referência de API do IronQR -- documentação completa de classes e métodos
• Exemplos de código QR -- código pronto para copiar e colar em cenários comuns
• Tutoriais do IronQR -- guias passo a passo para casos de uso específicos
• Opções de licenciamento -- escolha o plano certo para o seu projeto

Comece seu teste gratuito para desbloquear todo o potencial do IronQR sem qualquer compromisso inicial.