BarcodeScanning.MAUI ve IronBarcode: C# Barkod Kütüphanesi Karşılaştırması

Canlı Kamera Tarama Modeli

Tüm BarcodeScanning.Native.Maui API modeli, bir C# olay işleyici ile eşleştirilmiş bir XAML kontrolüdür:

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

Bu kontrol, kullanıcıya MAUI sayfasına gömülü gerçek zamanlı bir vizör verir. Kamera görüntü akışı aktifken barkod algılama sürekli olarak çalışır. UX, "hedefle ve tara"nın ana etkileşim olduğu tüketici uygulamaları için gerçekten iyidir. Sınırlama, bunun kütüphanenin desteklediği tek etkileşim olmasıdır - gereksinimler iOS veya Android'de canlı kamera algılaması dışında genişlediği anda, BarcodeScanning.Native.Maui'nin sunabileceği hiçbir şey yoktur.

Detayli Özellik Karsilastirmasi

BarcodeScanning.MAUI Yaklaşımı

BarcodeScanning.Native.Maui her platformda yerel kamera algılama boru hattını sarmalar. Android'de ML Kit kareleri işler. iOS'ta Apple'ın Vision çerçevesi kareleri işler. Kutuphanesi, bunu OnDetectionFinished olayi ile bir MAUI CameraView kontrole yusturur. Uygulama kodu hiçbir zaman doğrudan resim baytlarını işlemez — yalnızca olaydan çıkan algılanan barkod değerlerini işler.

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

Bu tasarımın sonucu, başka bir giriş noktası olmamasıdır. Kamera isteğe bağlı değildir — kütüphanenin bildiği tek giriş kamera. Bir sunucu, bir dosya, bir PDF, bir Windows makinesi — bunların hiçbiri bu kütüphanenin beklediği anlamda kameraya sahip değildir.

IronBarcode Yaklaşımı

IronBarcode, görüntü verilerini BarcodeReader.Read() statik metodu araciligiyla alir. Çağrı yapan kişi veriyi sağlar — herhangi bir kaynaktan — ve kütüphane bunu çözümler. MAUI'de veriler MediaPicker'den gelir; bir sunucuda, bir form yüklemesinden gelir; bir masaüstü uygulamasında, bir dosya iletişim kutusundan gelir.

//IronBarcodein MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

//IronBarcodein MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

Imports IronBarCode
Imports System.IO

'IronBarcode in MAUI: capture a photo, then read barcodes from it
' NuGet: dotnet add package IronBarcode

Private Async Sub ScanBarcodeButton_Clicked(sender As Object, e As EventArgs)
    Dim photo = Await MediaPicker.CapturePhotoAsync()
    If photo Is Nothing Then Return

    Using stream = Await photo.OpenReadAsync()
        Using ms As New MemoryStream()
            Await stream.CopyToAsync(ms)

            Dim results = BarcodeReader.Read(ms.ToArray())
            For Each result In results
                ResultLabel.Text = result.Value
            Next
        End Using
    End Using
End Sub

Bu kod iOS, Android ve Windows MAUI'da aynı şekilde çalışır. Sunucu tarafinda kullanim icin ayni BarcodeReader.Read() metodu, yuklenen bir dosyanin byte dizisini veya bir PDF yolunu kabul eder. IronBarcode belgeleri tüm desteklenen giriş türlerini içerir.

BarcodeScanning.MAUI Yaklaşımı

BarcodeScanning.Native.Maui, MAUI'da Windows hedefini desteklemez. Bu geçici bir boşluk değildir — kütüphanenin mimarisinin yapısal bir sonucudur. Kütüphane iOS'a özgü (Vision çerçevesi) ve Android'e özgü (ML Kit) yerel API'leri sarmalar. Windows'un hiçbiri yoktur. iOS, Android ve Windows'u hedefleyen bir MAUI uygulaması oluşturan ekipler — standart bir çoklu hedef senaryosu — üç hedef için de barkod çözümü olarak BarcodeScanning.Native.Maui'yi kullanamazlar. Ya Windows için platforma özgü kodu ayrı ayrı uygulamaları ya da kütüphaneyi tamamen değiştirmeleri gerekir.

IronBarcodeYaklaşımı

IronBarcode'nin BarcodeReader.Read() cagrisı, platforma ozgu hiçbir kod olmadan Windows, iOS, Android vemacOS MAUIhedeflerinde calisir. Herhangi bir #if WINDOWS bloklari, kosullu bagimlilik yuklemesi ve stub uygulamalar gerekmez. Dosya ve PDF girişleri için model de tutarlıdır:

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

Imports IronBarCode

' Read barcodes from a file the user selected
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim results = BarcodeReader.Read(file.FullPath)
    For Each result In results
        Console.WriteLine($"{result.Format}: {result.Value}")
    Next
End If

' Read barcodes directly from a PDF — no image extraction step needed
Dim pdfResults = BarcodeReader.Read("shipment-manifest.pdf")

IronBarcode MAUI entegrasyon kılavuzu tüm MAUI hedefleri için eksiksiz kurulum talimatları sağlar.IronBarcodeayrıca BarcodeScanning.Native.Maui'nin hiçbir yolu olmadığı ASP.NET, Docker, Azure Functions ve AWS Lambda ortamlarında sunucu tarafı dağıtımı da destekler.

BarcodeScanning.MAUI Yaklaşımı

iOS'ta, BarcodeScanning.Native.Maui'nin temelindeki algılama (Apple Vision) UPC-A barkodları için 13 basamak döndürür. UPC-A 12 basamaklı bir formattır; fazladan ön sıfır EAN-13 kodlamasına uyar. Kütüphane bu ham değeri düzeltme yapmadan geçer. UPC-A değerlerini bir veritabanında saklayan uygulamalar, orada ait olmayan bir ön sıfır ile kayıtlar biriktirebilir.

Belgelenen çözüm yolu, biçimi kontrol etmeyi ve değeri kırpmayı gerektirir:

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

' Workaround required for iOS UPC-A — strip the leading zero manually
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormat.UPC_A AndAlso value.Length = 13 Then
        value = value.Substring(1) ' strip Apple's prepended leading zero
    End If

    ProcessBarcode(value)
End Sub

Eğer format kontrolü yapılmazsa, bu çözüm yolu sessizce 0 ile başlayan EAN-13 barkodlarını bozar. PDF417 ayrı olarak GitHub sorunlarında "çok problemli — çoğu tarama asla gerçekleşmez" olarak belgelenmiştir, sevkiyat etiketlerini, ehliyetleri ve biniş kartlarını etkiler.

IronBarcode Yaklaşımı

IronBarcode, manuel normalizasyona gerek kalmadan doğru 12 basamaklı UPC-A değerini döndürür. PDF417, güvenilir şekilde okunan desteklenen bir biçimdir. Üretim tarafı IronBarcode'un API'si aracılığıyla da mevcuttur:

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

' Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

Barkod verisi doğruluğunun doğrudan envanter sorgularını, satış noktası işlemlerini veya tedarik zinciri entegrasyonlarını etkilediği uygulamalar için, IronBarcode'un doğru format işlemesi, BarcodeScanning.Native.Maui'nin uygulama kodunda bıraktığı bir üretim hatası kategorisini ortadan kaldırır. IronBarcode barkod okuma belgeleri biçimlere özgü davranışı ayrıntılı olarak kapsar.

Windows MAUI Hedefi Derleme Eklenir

MAUI uygulamaları genellikle iOS ve Android hedefi ile başlar ve uygulama olgunlaştıkça veya kurumsal dağıtım gereksinimleri genişledikçe daha sonra Windows eklenir. Windows hedefi eklendiğinde, BarcodeScanning.Native.Maui hemen bir engelleyici haline gelir — Windows uygulaması yoktur ve kitaplık içinde bir çözüm yoktur. Bu durumda olan ekiplerin ya farklı bir kitaplık kullanarak Windows için ayrı bir barkod uygulamasını sürdürmeleri ya da barkod katmanını tüm MAUI hedeflerinde tutarlı bir şekilde çalışan bir kitaplığa taşımaları gerekir. İkinci yol operasyonel olarak daha basittir ve platforma özgü dallanmanın bakım yükünü ortadan kaldırır.

Dosya Yükleme veya PDF İşleme Gereksinimleri Eklenir

Mobil uygulamalar genellikle canlı kamera taramayı tek giriş yöntemi olarak başlatır ve daha sonra yüklenen resimleri veya belgeleri kabul etme yeteneğini genişletir. Bir kullanıcı galerisindeki bir fotoğraftan, e-posta ile alınan bir resimden ya da gönderi manifestoları veya biniş kartları içeren bir PDF'den bir barkod taramaya ihtiyaç duyduğunda, BarcodeScanning.Native.Maui teklif edilecek bir kod yolu yoktur. Bu gereksinim sınırına ulaşan ekipler bir seçimle karşı karşıya: Dosya ve PDF girişleri için BarcodeScanning.Native.Maui ile birlikte ikinci bir barkod kitaplığı eklemek veya tüm giriş türlerini işleyen tek bir kitaplığa geçmek. Farklı API'lere, farklı sonuç türlerine ve farklı format destek tablolarına sahip iki barkod paketi yönetmek, uzun vadede bir tek paketli çözümün sağladığından kaçınılan bir karmaşıklık katmanı oluşturur.

Sunucu Tarafı Barkod İşleme Tanıtılır

Mobil üzerinde barkod tarayan uygulamalar sıklıkla bir sunucu tarafı bileşeni — barkodları doğrulayan bir ASP.NET API uç noktası, PDF'leri işleyen bir arka plan işi veya yüklenen belgelerden takip numaraları çıkartan bir bulut işlevi — geliştirirler. BarcodeScanning.Native.Maui, bir kamera donanım bağlamına bağlı bir UI kontrol kitaplığıdır; sunucu işleminde çalışamaz. Hem mobil hem de sunucuda aynı barkod okuma mantığına ihtiyaç duyan bir ekip, sunucu tarafında farklı bir kitaplık kullanmalıdır. Sunucu tarafı gereksinimi ortaya çıktığında, ekipler sıklıkla hem mobil hem de sunucuyu kapsayan tek bir kitaplık konsolide edilmesinin mi yoksa iki ayrı uygulamayı sürdürmesinin mi tercih edileceğini değerlendirir.

UPC-A Veri Doğruluğu Üretim Sorunu Haline Gelir

iOS UPC-A 13-basamak davranışı her zaman geliştirme sırasında yakalanmaz. Geliştirme sırasında taranan UPC-A barkodları doğru çalışıyor gibi görünebilir, ancak Apple'ın Vision çerçevesinin eklediği ön sıfır veritabanında görünür. Envanter kayıtlarında, satış noktası sistemlerinde veya tedarik zinciri entegrasyonlarında 13-basamak UPC-A değerlerini keşfeden ekipler, bir kod sorununa ek olarak bir veri düzeltme sorunuyla karşı karşıya kalırlar. BarcodeScanning.Native.Maui'nin GitHub sorunlarında belgelenen çözüm yolu, yeni taramaları düzeltir ancak tarihi verileri düzeltmez. Veri kalitesi sorununun kapsamı netleşince, uygulama düzeyinde normalleştirme yapmadan doğru UPC-A değerleri döndüren bir kütüphaneye geçmek genellikle daha temiz uzun vadeli bir çözüm olur.

PDF417 Belge Taraması Gereklidir

PDF417, Kuzey Amerika'daki nakliye etiketleri, sürücü belgeleri ve biniş kartlarında kullanılan barkod formatıdır. Bunlar lojistik, kimlik doğrulama ve seyahat uygulamaları için yaygın tarama hedefleridir. BarcodeScanning.Native.Maui'nin GitHub sorun izleyicisi PDF417'yi "çok sorunlu - çoğu tarama asla gerçekleşmez" olarak belgeler. PDF417 güvenilirliğinin fonksiyonel bir gereklilik olduğu herhangi bir uygulamada, bu bilinen sorun alternatif kütüphanelerin değerlendirilmesini zorunlu kılan doğrudan bir engelleyicidir.

Kamera Etkinliğinden MediaPicker'a ve Statik Okumaya

Gocteki temel yapisel değişiklik, surekli kamera olay kalibinin BarcodeReader.Read()'nin ardindan bir MediaPicker yakalamayla değiştirilmesidir. OnDetectionFinished olay isleyicisi, CameraView XAML kontrolü ve scanner: XML isim alani bildirimi kaldirilmistir. Yerlerine bir dugme MediaPicker.CapturePhotoAsync()'yi tetiikler ve olusan fotograf baytları BarcodeReader.Read()'ye iletilir. Bu, kullanıcı deneyimini canlı sürekli bir vizörden sistem kamera ekranına değiştirir - çoğu iş uygulamaları için uygundur.

Thread Yönlendirme Değişiklikleri

BarcodeScanning.Native.Maui, arka plan is parcaciginda OnDetectionFinished'yi tetikler, bu nedenle UI elementlerini güncelleyen mevcut tüm isleyiciler güncellemelerini MainThread.BeginInvokeOnMainThread() icinde sarar.IronBarcodetarafindan kullanilan MediaPicker + async deseni ile, await'dan sonra devam durumu cagrilan baglamda doner, bu genellikle ana is parcacigidir. Cogu durumda, MainThread.BeginInvokeOnMainThread() sarmalayıcılar kaldırilabilir ve olay isleyici kodu basitlestirilir.

UPC-A Geçici Çözümün Kaldırılması

BarcodeScanning.Native.Maui'nin iOS UPC-A 13-hane davranisini yoneten herhangi bir kod tabanında, BarcodeFormat.UPC_A'yi kontrol eden ve ondeki sıfırı silmek icin Substring(1)'yi cagiracak kodu icerecektir. Bu kod, geçişten sonra silinmelidir —IronBarcodedoğru 12 haneli değeri döndürür ve geçici çözüm yerinde bırakılırsa, geçerli UPC-A okumalarından ilk hanenin yanlış çıkarılmasına sebep olur.

MAUI İzinleri

BarcodeScanning.Native.Maui, paketin ayarları kapsamında Android ve iOS bildirilerine kamera izinlerini otomatik olarak ekler. IronBarcode'nin MediaPicker'yi kullanmasiyla, AndroidManifest.xml ve Info.plist içindeki standart MAUI kamera izinleri gereklidir — MediaPicker.CapturePhotoAsync() icin her MAUI uygulamasinin ihtiyaçi olan izinlerdir. Bu izinler, kamera kullanımı için herhangi bir amaçla kullanılan MAUI projelerinde genellikle zaten mevcut olur.