QR Kodu .NET Core Üretici & Okuyucu | IronQR

.NET Core'da QR Code Kütüphanesi Nasıl Kurulur?

Başlamak için, Visual Studio'yu açın ve yeni bir projeye başlamak için oluştur düğmesine tıklayın. Proje adını belirledikten sonra, kütüphaneyi NuGet Paket Yöneticisi aracılığıyla yüklemek sadece birkaç saniye sürer. Bazı geliştiriciler QRCoder NuGet paketini arayabilirken, IronQR framework'ünü Paket Yöneticisi Konsolu'nda aşağıdaki komutu çalıştırarak yükleyebilirsiniz:

Install-Package IronQR

Alternatif olarak, "IronQR" araması yaparak NuGet Paket Yöneticisi arayüzünü kullanabilir ve yükle düğmesine tıklayabilirsiniz. Kütüphane, modern web geliştirme ve çoklu platform projeleri için ideal olan .NET Core 3.x, .NET 5, 6, 7, 8, 9 ve 10 ile uyumlu bir .NET uygulaması sağlar.

Kurulumdan sonra, dosyanızın en üstüne gerekli using yönergelerini ekleyin. IronQR, platforma özgü bağımlılıkları ortadan kaldırarak çapraz platform görüntü işleme için IronSoftware.Drawing ile entegre olur. System.Drawing.Common, .NET 6 ve sonrası için çapraz platform kullanımı için kullanımdan kaldırılmıştır.

Kurulumun başarılı olduğunu doğrulamak için .csproj dosyanızda projenizin paket referanslarını kontrol edebilir veya NuGet paketinin Package Manager konsolunda göründüğünü doğrulayabilirsiniz. Yüklendikten sonra, IronQR API referansı hemen kullanılabilir olur.

QR Kodu Nasıl Oluşturulursunuz?

QrWriter sınıfı, genellikle kullanışlı genişletme yöntemleriyle birlikte kullanılarak QR kodları oluşturmayı kolay hale getirir. İşte, sadece birkaç satır kodla QR kodu oluşturmak için üst düzey ifadeler kullanan tam bir örneğin kaynak kodu:

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

Imports IronQr
Imports IronSoftware.Drawing

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

' Save as PNG image
Dim qrImage As AnyBitmap = qrcode.Save()
qrImage.SaveAs("website-qr.png")

Hata Düzeltme Seviyeleri Nedir ve Neden Önemlidir?

Hata düzeltme, bir QR sembolünün taranabilir kalırken ne kadar zarar görebileceğini belirler. Bu, markalama ve dayanıklılık sağlayan isteğe bağlı gelişmiş özelliklerden biridir. QR kod standardı (ISO/IEC 18004), her biri veri kapasitesini dayanıklılıkla takas eden dört hata düzeltme seviyesi tanımlar.

Hata düzeltmeyi yapılandırmak için QrOptions kullanın:

using IronQr;
using IronSoftware.Drawing;

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

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

Imports IronQr
Imports IronSoftware.Drawing

' Configure with high error correction level
Dim options As New QrOptions(QrErrorCorrectionSeviye.High, 20)

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

Logo ve Renklerle QR Kod Görünümünü Nasıl Özelleştirebilirsiniz?

IronQR'nin QrStyleOptions'ı, özelleştirilmiş renkler, boyutlar ve gömülü logolar ile marka uyumlu QR kodu oluşturmaya olanak tanır. Bu, özellikle görsel tutarlılığın önemli olduğu pazarlama materyalleri, ürün ambalajı ve etkinlik biletleri için oldukça kullanışlıdır.

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

Imports IronQr
Imports IronSoftware.Drawing

Dim styleOptions As New QrStyleOptions With {
    .Dimensions = 300,
    .Margins = 10,
    .Color = Color.DarkBlue,
    .Logo = New QrLogo With {.Bitmap = AnyBitmap.FromFile("company-logo.png")}
}

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

ASP.NET Core'da QR Kodlarını Nasıl Oluşturursunuz?

QR kodu oluşturmayı ASP.NET Core'a entegre etmek, Model View Controller desenini takip eder. İşte bir QR kodu görüntüsünü doğrudan eylem yönteminden döndüren bir HomeController sınıfı uygulaması:

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

Imports IronQr
Imports IronSoftware.Drawing
Imports Microsoft.AspNetCore.Mvc

Namespace Examples
    Public Class HomeController
        Inherits Controller

        Public Function GenerateQR(content As String) As IActionResult
            Dim myQr As QrCode = QrWriter.Write(content)
            Dim qrImage As AnyBitmap = myQr.Save()
            Dim imageBytes As Byte() = qrImage.ExportBytes()
            Return File(imageBytes, "image/png")
        End Function
    End Class
End Namespace

Bu uç nokta, bir parametre olarak QR kodu verisini alır ve oluşturulan PNG görüntüsünü doğrudan döndürür. ASP.NET Core Web API projeleri ve Razor görünümleri ile birlikte bu yaklaşım çalışır.

Üretim ASP.NET Core uygulamaları için, CPU yükünü azaltmak amacıyla, sık sık üretilen QR kodlarını IMemoryCache veya IDistributedCache kullanarak önbelleğe almayı düşünün. Statik URL'ler, ürün tanıtıcıları veya etkinlik bağlantıları için QR kodları istekler arasında değişmez ve önbelleğe almak için ideal adaylardır.

IronQR'i Minimal API uç noktasına entegre edebilirsiniz. ASP.NET Core entegrasyon öğreticisi, bağımlılık enjeksiyon desenlerini ve Blazor bileşeninden QR kodu görsellerinin nasıl sunulacağını içeren tam bir örnek sağlar.

Üst düzey ifade kalıbını kullanarak Program.cs içinde IronQR'ın lisans anahtarını kaydetmek, başlangıç yapılandırmanızı temiz tutar:

using IronQr;

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

using IronQr;

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

Imports IronQr

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

Herhangi bir IronQR yöntemini çağırmadan önce lisans anahtarını ayarlayın. Geliştirme aşamasında, IronQR lisans sayfasından alınan ücretsiz bir deneme anahtarını uygulayabilirsiniz.

Japon Unicode Metni Nasıl Kodlanır?

IronQR, Japon Unicode metinlerini standart kodlamadan daha az veri segmenti kullanarak etkin bir şekilde kodlayan Kanji modu aracılığıyla kodlamayı destekler. Bu, aynı içerik için QR kodunun versiyonunu (boyutunu) azaltır, daha hızlı taranan daha az karmaşık bir sembol üretir.

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

Imports IronQr
Imports IronSoftware.Drawing

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

Makine Öğrenmesi ile QR Kodları Nasıl Okunur?

IronQR, makine öğrenmesine dayalı QR okuyucusu ile kendini ayırır. ML modeli, açıdan veya kısmen gizlenmiş görüntülerden QR kodlarını okuma konusunda yüksek doğruluk sağlar -- birçok açık kaynaklı alternatifin kullandığı geleneksel eşik tabanlı algılama algoritmalarına karşı önemli bir avantajdır.

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

Imports IronQr
Imports IronSoftware.Drawing

' Load image containing QR code
Dim inputBmp As AnyBitmap = AnyBitmap.FromFile("scanned-document.png")
Dim imageInput As New QrImageInput(inputBmp)

' Read with ML-powered detection
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

For Each result In results
    Console.WriteLine($"Found: {result.Value}")
Next

Platformlar Arası Destek Nasıl Çalışır?

System.Drawing.Common'ya bağlı çözümlerden farklı olarak (.NET 6+ için çapraz platform kullanımı için kullanımdan kaldırılmıştır), IronQR gerçek çok platformlu projeler için IronSoftware.Drawing kullanır. Kodunuz Windows, macOS, Linux, iOS ve Android arasında tutarlı bir şekilde çalışır. Çoklu platform projeleri için SkiaSharp alternatifleri gereksizdir -- IronQR platform soyutlamasını dahili olarak ele alır.

.NET platformlar arası belgeleri .NET 10 için daha geniş platform uyumluluk hikayesini açıklar. IronQR, platforma özgü API'lerden tamamen kaçınarak bu ilkelerle uyumludur.

IronQR aşağıdaki dağıtım hedeflerini destekler:

• .NET 10, 9, 8, 7, 6 -- tüm modern .NET sürümleri
• .NET Core 3.x -- henüz modern .NET'e taşınmamış uygulamalar için
• Xamarin ve MAUI -- mobil uygulama geliştirme için
• Azure Functions ve AWS Lambda -- sunucusuz iş yükleri için

Docker konteynerlerinde çalışırken, standart .NET çalışma zamanı görüntüsü haricinde ek sistem paketlerine gerek yoktur. Bu, yerel GDI+ bağımlılıklarına ihtiyaç duyan kütüphanelere kıyasla Dockerfile'inizi basitleştirir. IronQR dağıtım kılavuzu, konteynerli ve bulut ortamları için yapılandırmayı kapsar.

IronQR'i Diğer .NET QR Kütüphaneleriyle Nasıl Karşılaştırırsınız?

Birkaç .NET QR kod kütüphanesi mevcut, her biri farklı artılar ve eksiler sunar. Farklılıkları anlamak, projeniz için doğru aracı seçmenize yardımcı olur.

QRCoder bir MIT lisansı ile açık kaynak bir kütüphanedir. Doğrudan QR kodu üretimi için iyi çalışır ancak QR kodu okuma yeteneklerini veya makine öğrenimi destekli tespiti içermez. Çıktı seçenekleri IronQR'in stilli çıktı desteğiyle kıyaslandığında daha sınırlıdır.

ZXing.NET Java ZXing kütüphanesinin bir C# portudur. Hem okuma hem de yazmayı destekler ancak hasarlı veya döndürülmüş kodlarla sık sık baş edemeyen geleneksel bilgisayarlı görü tekniklerine dayanır. Platformlar arası görüntü işleme ek kurulum gerektirir.

IronQR, üretken uygulamalar için eksiksiz bir çözüm haline getiren enterprise lisansı ile özel destek içeren tek bir pakette üretim ve okumayı sağlar. ML destekli okuyucu, biçimlendirilmiş çıktı ve IronSoftware.Drawing entegrasyonu onu üretim uygulamaları için daha eksiksiz bir çözüm yapar.

Ayrıntılı özellik karşılaştırması için, IronQR vs QRCoder karşılaştırması ve IronQR vs ZXing karşılaştırması makalelerine bakabilirsiniz.

Sonraki Adımlarınız Neler?

IronQR, .NET Core'da QR kodu üretimi ve okuması için eksiksiz bir çözüm sunar. Karmaşık yük oluşturucularını ve ham modüllerin montajını ve QrCodeData verilerini otomatik olarak ele alarak, geliştirme döngüsünü basitleştirir. Basit bir açık kaynak kütüphane alternatifi veya isteğe bağlı ileri düzey özelliklerle bir sisteme ihtiyacınız olup olmadığına bakılmaksızın, IronQR'in platformlar arası mimarisi güvenilir bir çalışma sağlar.

IronQR ile geliştirmeye devam etmek için bu kaynakları keşfedin:

• IronQR NuGet paketi -- en son kararlı sürümü kurun
• IronQR API referansı -- tam sınıf ve yöntem belgeleri
• QR kodu örnekleri -- yaygın senaryolar için kopyala-yapıştır hazır kod
• IronQR eğitimleri -- belirli kullanım durumları için adım adım kılavuzlar
• Lisanslama seçenekleri -- projeniz için doğru planı seçin

Ücretsiz denemenizi başlatın ve IronQR'in tam potansiyelini hiçbir ön taahhüt olmadan keşfedin.