IronBarcode kullanarak bir .NET MAUI Barkod Tarayıcı SDK Uygulaması Nasıl Oluşturulur

.NET MAUI'de Barkod Tarayıcı SDK'sı Nasıl Kurulur?

.NET MAUI barkod tarayıcı SDK'sı oluşturmak, yeni bir proje oluşturmayı, NuGet paketini yüklemeyi ve platform izinlerini yapılandırmayı gerektirir. Tüm yapılandırma süreci Visual Studio'da birkaç dakika sürer.

Install-Package BarCode

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

using IronBarCode;

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

// Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

return builder.Build();

using IronBarCode;

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

// Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

return builder.Build();

Imports IronBarCode

Dim builder = MauiApp.CreateBuilder()
builder _
    .UseMauiApp(Of App)() _
    .ConfigureFonts(Sub(fonts)
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular")
    End Sub)

' Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"

Return builder.Build()

Görüntü Dosyalarından Barkodları Nasıl Okursunuz?

Her MAUI barkod tarayıcısının temel işlevi, seçilen görüntülerden barkod okumaktır. BarcodeReader.Read() yöntemi, bir dosya yolu alır ve algılanan her barkod için bir BarcodeResult nesneleri koleksiyonu döndürür.

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

using IronBarCode;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });

        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);

            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);

            ResultLabel.Text = barcodes.Any()
                ? $"Found: {barcodes.First().Value}"
                : "No barcodes detected in selected image.";
        }
    }
}

using IronBarCode;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });

        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);

            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);

            ResultLabel.Text = barcodes.Any()
                ? $"Found: {barcodes.First().Value}"
                : "No barcodes detected in selected image.";
        }
    }
}

Imports IronBarCode

Public Partial Class MainPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Async Sub OnSelectImageClicked(sender As Object, e As EventArgs)
        Dim result = Await FilePicker.PickAsync(New PickOptions With {
            .FileTypes = FilePickerFileType.Images,
            .PickerTitle = "Select a barcode image"
        })

        If result IsNot Nothing Then
            ' Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath)

            ' Read barcodes from the image file
            Dim barcodes = BarcodeReader.Read(result.FullPath)

            ResultLabel.Text = If(barcodes.Any(), $"Found: {barcodes.First().Value}", "No barcodes detected in selected image.")
        End If
    End Sub
End Class

PDF Belgelerinden Barkodları Nasıl Taramalısınız?

IronBarcode'u birçok alternatife göre farklı kılan bir özellik, barkodları doğrudan PDF dosyalarından okuyabilmesidir. Bu, .NET MAUI uygulamaları için belge iş akışlarını işlemek açısından gereklidir -- sevkiyat belgeleri, satın alma siparişleri, tıbbi kayıtlar ve benzeri kullanım alanları, PDF içerikli barkodlara dayanır.

BarcodeReader.ReadPdf() yöntemi bir dosya yolu alır ve görüntü okuyucu ile aynı BarcodeResult koleksiyonunu döndürür, her barkodun hangi PDF sayfasından geldiğini belirleyen ek bir PageNumber özelliği ile birlikte:

using IronBarCode;

private async void OnSelectPdfClicked(object sender, EventArgs e)
{
    var result = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select a PDF with barcodes"
    });

    if (result != null)
    {
        // Read barcodes from every page of the PDF
        var barcodes = BarcodeReader.ReadPdf(result.FullPath);

        var output = string.Join("\n", barcodes.Select(b =>
            $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"));

        await DisplayAlert("Scan Results", output.Length > 0 ? output : "No barcodes found.", "OK");
    }
}

using IronBarCode;

private async void OnSelectPdfClicked(object sender, EventArgs e)
{
    var result = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select a PDF with barcodes"
    });

    if (result != null)
    {
        // Read barcodes from every page of the PDF
        var barcodes = BarcodeReader.ReadPdf(result.FullPath);

        var output = string.Join("\n", barcodes.Select(b =>
            $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"));

        await DisplayAlert("Scan Results", output.Length > 0 ? output : "No barcodes found.", "OK");
    }
}

Imports IronBarCode

Private Async Sub OnSelectPdfClicked(sender As Object, e As EventArgs)
    Dim result = Await FilePicker.PickAsync(New PickOptions With {
        .PickerTitle = "Select a PDF with barcodes"
    })

    If result IsNot Nothing Then
        ' Read barcodes from every page of the PDF
        Dim barcodes = BarcodeReader.ReadPdf(result.FullPath)

        Dim output = String.Join(vbLf, barcodes.Select(Function(b) $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"))

        Await DisplayAlert("Scan Results", If(output.Length > 0, output, "No barcodes found."), "OK")
    End If
End Sub

Birden Fazla Barkod ve QR Kodunu Nasıl İşlersiniz?

Üretim uygulamaları genellikle tek bir görüntüden birden fazla barkod tespit etmeli veya sonuçları barkod türüne göre filtrelemelidir. BarcodeReaderOptions sınıfı, algılama davranışını kontrol eden yapılandırma özelliklerini sunar. ExpectMultipleBarcodes, true olarak ayarlandığında okuyucuya, ilk eşleşmeden sonra taramaya devam etmesini söyler ve erken durmayı bırakır.

using IronBarCode;

// Configure the reader for multi-barcode detection with type filtering
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};

var barcodes = BarcodeReader.Read(imagePath, options);

foreach (var barcode in barcodes)
{
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}");
}

using IronBarCode;

// Configure the reader for multi-barcode detection with type filtering
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};

var barcodes = BarcodeReader.Read(imagePath, options);

foreach (var barcode in barcodes)
{
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}");
}

Imports IronBarCode

' Configure the reader for multi-barcode detection with type filtering
Dim options As New BarcodeReaderOptions With {
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128,
    .Speed = ReadingSpeed.Balanced
}

Dim barcodes = BarcodeReader.Read(imagePath, options)

For Each barcode In barcodes
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}")
Next

Speed özelliği, tarama süresi ile doğruluk arasındaki dengeyi kontrol eder. ReadingSpeed.Faster, toplu olarak yüksek kaliteli görüntüleri tarayan uygulamalara uygun olan verimliliği önceliklendirir. ReadingSpeed.ExtraSlow ise zorlu girdiler için daha agresif görüntü düzeltme geçişleri uygular -- düşük kontrast, eğik açılar veya kısmen engellenmiş kodlar. ReadingSpeed.Balanced, çoğu uygulama için doğru başlangıç noktasıdır.

BarcodeEncoding numaralandırması, bit bazlı kombinasyonları destekler, böylece gereksiz kontrollerle performansı düşürmeden kullanıma uygun sembolojilere taramayı sınırlayabilirsiniz.

Bellek Akışlarından Barkodları Nasıl Okursunuz?

Çok sayıda senaryodan biri olan dosya yolları iyi çalışır, ancak bazı .NET MAUI iş akışları görüntü verilerini bellek üzerinden geçirir - bir kamera ön izleme çerçevesinden yakalanan kareler, bir REST API üzerinden indirilen baytlar veya işlenmekte olan görüntü verileri. IronBarcode, doğrudan BarcodeReader.Read() aşırı yüklemesinde System.IO.Stream girdilerini destekler.

using IronBarCode;
using System.IO;

// Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
private BarcodeResult[] ReadFromStream(Stream imageStream)
{
    return BarcodeReader.Read(imageStream);
}

// Example: download an image and scan without writing to disk
private async Task<string> ScanDownloadedBarcode(string imageUrl)
{
    using var httpClient = new HttpClient();
    using var stream = await httpClient.GetStreamAsync(imageUrl);
    using var memoryStream = new MemoryStream();

    await stream.CopyToAsync(memoryStream);
    memoryStream.Position = 0;

    var barcodes = BarcodeReader.Read(memoryStream);
    return barcodes.Any() ? barcodes.First().Value : string.Empty;
}

using IronBarCode;
using System.IO;

// Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
private BarcodeResult[] ReadFromStream(Stream imageStream)
{
    return BarcodeReader.Read(imageStream);
}

// Example: download an image and scan without writing to disk
private async Task<string> ScanDownloadedBarcode(string imageUrl)
{
    using var httpClient = new HttpClient();
    using var stream = await httpClient.GetStreamAsync(imageUrl);
    using var memoryStream = new MemoryStream();

    await stream.CopyToAsync(memoryStream);
    memoryStream.Position = 0;

    var barcodes = BarcodeReader.Read(memoryStream);
    return barcodes.Any() ? barcodes.First().Value : string.Empty;
}

Imports IronBarCode
Imports System.IO
Imports System.Net.Http
Imports System.Threading.Tasks

' Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
Private Function ReadFromStream(imageStream As Stream) As BarcodeResult()
    Return BarcodeReader.Read(imageStream)
End Function

' Example: download an image and scan without writing to disk
Private Async Function ScanDownloadedBarcode(imageUrl As String) As Task(Of String)
    Using httpClient As New HttpClient()
        Using stream As Stream = Await httpClient.GetStreamAsync(imageUrl)
            Using memoryStream As New MemoryStream()
                Await stream.CopyToAsync(memoryStream)
                memoryStream.Position = 0

                Dim barcodes = BarcodeReader.Read(memoryStream)
                Return If(barcodes.Any(), barcodes.First().Value, String.Empty)
            End Using
        End Using
    End Using
End Function

Akış aşırı yüklemesi, Stream alt sınıfı olan herhangi bir şeyi kabul eder, bunlar arasında MemoryStream, FileStream ve ağ akışları bulunur. Kütüphane, biçim algılamayı dahili olarak işler, bu yüzden Read() çağrısından önce görüntü türünü belirtmeniz gerekmez.

Bir MAUI Uygulamasında Barkodları Nasıl Oluşturursunuz?

IronBarcode barkod oluşturmanın yanı sıra okuma işlevi de sunar. BarcodeWriter sınıfı, barkodları görüntü dosyaları, Bitmap nesneleri veya bir MAUI görünümünde satır içi görüntüleyebileceğiniz Stream örnekleri olarak üretir. Bu, tarama işlevselliğiyle birlikte barkodları yazdırması veya paylaşması gereken stok uygulamaları için yararlıdır.

using IronBarCode;

// Generate a QR code and display it in a MAUI Image control
private async void OnGenerateQrClicked(object sender, EventArgs e)
{
    // Create a QR code barcode
    var qrCode = QRCodeWriter.CreateQrCode(
        value: "https://ironsoftware.com/csharp/barcode/",
        qrCodeSize: 500,
        errorCorrection: QRCodeWriter.QrErrorCorrectionLevel.Medium
    );

    // Save to a temporary file and display
    var tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png");
    qrCode.SaveAsPng(tempPath);

    GeneratedImageView.Source = ImageSource.FromFile(tempPath);
}

using IronBarCode;

// Generate a QR code and display it in a MAUI Image control
private async void OnGenerateQrClicked(object sender, EventArgs e)
{
    // Create a QR code barcode
    var qrCode = QRCodeWriter.CreateQrCode(
        value: "https://ironsoftware.com/csharp/barcode/",
        qrCodeSize: 500,
        errorCorrection: QRCodeWriter.QrErrorCorrectionLevel.Medium
    );

    // Save to a temporary file and display
    var tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png");
    qrCode.SaveAsPng(tempPath);

    GeneratedImageView.Source = ImageSource.FromFile(tempPath);
}

Imports IronBarCode

' Generate a QR code and display it in a MAUI Image control
Private Async Sub OnGenerateQrClicked(sender As Object, e As EventArgs)
    ' Create a QR code barcode
    Dim qrCode = QRCodeWriter.CreateQrCode(
        value:="https://ironsoftware.com/csharp/barcode/",
        qrCodeSize:=500,
        errorCorrection:=QRCodeWriter.QrErrorCorrectionLevel.Medium
    )

    ' Save to a temporary file and display
    Dim tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png")
    qrCode.SaveAsPng(tempPath)

    GeneratedImageView.Source = ImageSource.FromFile(tempPath)
End Sub

QRCodeWriter sınıfı, tüm dört QR hata düzeltme seviyesini (Düşük, Orta, Çeyrek, Yüksek), özel boyutlandırmalar ve ön plan/arka plan renk kontrolü dahil stil seçeneklerini destekler. QR dışı sembolojiler için BarcodeWriter.CreateBarcode() 'ü uygun BarcodeEncoding değeri ile kullanın. barkod oluşturma API referansı, tüm desteklenen çıkış formatlarını belgeler.

Bu Barkod Tarayıcı Kütüphanesinin Temel Yetenekleri Nelerdir?

IronBarcode, ZXing.Net.MAUI gibi açık kaynak alternatiflerinden ayıran birkaç avantaj sunar .NET MAUI barkod tarama projeleri için.

Yerel SDK bağımlılığı yok noktası .NET MAUI projelerinde önemlidir çünkü platforma özgü yerel kütüphaneler, her hedef için ayrı bağlama adımları gerektirir. IronBarcode, bu karmaşıklığı tamamen ortadan kaldırır, bu da ek yapılandırma gerektirmeden çalışabilir ikili dosyalar elde edileceği anlamına gelir.

Desteklenen barkod formatlarının tam listesini görmek için IronBarcode desteklenen formatlar belgeleri bölümüne bakın. Üretim dağıtımı için fiyatlandırma ve lisanslama koşullarını incelemek için, IronBarcode lisanslama sayfasına göz atın.

Üretimde Barkod Tarama İçin En İyi Uygulamalar Nelerdir?

Bir barkod tarayıcıyı üretime dağıtmak, temel okuma çağrısının ötesinde birkaç alana dikkat gerektirir. Aşağıdaki kılavuzlar, .NET MAUI barkod uygulamalarındaki en yaygın başarısızlık noktalarına hitap eder.

Doğru okuma hızını seçin. ReadingSpeed.Balanced, çoğu gerçek dünya görüntülerini doğru bir şekilde işler. Baskılı belgeler veya kullanıcıların tekrar çekemeyeceği görüntüler için ReadingSpeed.ExtraSlow 'i saklayın. Her taramanın önemli ölçüde daha uzun sürdüğü için, yüksek hacimli iş akışları için ReadingSpeed.ExtraSlow kullanmaktan kaçının.

Beklenen türlere göre filtreleyin. Uygulama yalnızca QR kodlarını işlerse, ExpectBarcodeTypes = BarcodeEncoding.QRCode ayarlayın. Arama alanını sınırlamak, işleme süresini kısaltır ve arka planda bulunan diğer sembolojilerden yanlış pozitifleri ortadan kaldırır.

Yalnızca gerektiğinde ExpectMultipleBarcodes kullanın. Bunu true olarak ayarlamak, okuyucuyu her zaman ek geçişler yapmaya zorlar. Tek barkod girdileri için ilk geçerli kod bulunduğunda taramanın hemen dönmesi için varsayılan (false) bırakın.

Boş sonuçları zarifçe işleyin. BarcodeReader.Read() barkod bulunamadığında hata oluşturmadan boş bir dizi döndürür. .Any() 'yı First() 'ya erişmeden önce kontrol edin ve kullanıcıya net bir mesaj iletin. Bir yeniden deneme istemi ve talimatlar ("barkodun iyi aydınlatıldığından ve ortalandığından emin olun") sağlaması, genel bir hata mesajından daha iyi bir kullanıcı deneyimi sunar.

Seçenekler nesnesini ön belleğe alın. Her taramada bir BarcodeReaderOptions örneği oluşturmak, ayırımlara ekleme yapar. Seçenekleri sınıf seviyesinde bir kez oluşturup çağrılar arasında tekrar kullanın.

Tarama hatalarını teşhis etmek ve performansı optimize etmek konusunda ek kılavuzlar için IronBarcode sorun giderme kılavuzu ve barkod okuyucu eğitimi bölümlerine başvurun.

Sonraki Adımlarınız Neler?

IronBarcode ile bir .NET MAUI barkod tarayıcı oluşturmak, tek bir NuGet paketini yüklemeyi, platform izinlerini yapılandırmayı ve bir dosya yolu veya akış ile BarcodeReader.Read() çağırmayı gerektirir. Aynı API, platforma özgü kod dalları olmadan Android, iOS ve Windows'u hedefler.

Uygulamayı daha da genişletmek için, şu kaynakları göz önünde bulundurun:

• IronBarcode tam özellik listesi -- tarama ve oluşturma yeteneklerinin kataloğu
• Barkod okuyucu API referansı -- tüm yöntem ve özellik belgeleri
• MAUI barkod okuyucu adım adım eğitimi -- kamera entegrasyonunu kapsayan genişletilmiş kılavuz
• MAUI belge tarayıcı kılavuzu -- belge tarama kullanım senaryoları

Ücretsiz denemenizi başlatmak için bir geliştirme lisans anahtarı alın veya üretim dağıtımı için lisans seçeneklerini keşfedin.