Temel Sorun

Yapısal sorun, geliştiriciyi manuel yaşam döngüsü yönetimi ve sabit bir format listesi ile kamera merkezli bir olay döngüsüne kilitleyen CameraBarcodeReaderView 'dir. Tanınmış barkod formatları ile iOS ve Android üzerinde temel kamera taramasının ötesine geçen her şey için mimari, sınırına ulaşır:

// ZXing.Net.MAUI: event loop, format list, lifecycle boilerplate on every scan page
public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode |
                      BarcodeFormats.Code128 |
                      BarcodeFormats.Ean13 |
                      BarcodeFormats.UpcA,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;  // Required — no Dispose() available
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        CameraView.IsDetecting = true;
    }
}

// ZXing.Net.MAUI: event loop, format list, lifecycle boilerplate on every scan page
public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode |
                      BarcodeFormats.Code128 |
                      BarcodeFormats.Ean13 |
                      BarcodeFormats.UpcA,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;  // Required — no Dispose() available
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        CameraView.IsDetecting = true;
    }
}

Imports ZXing.Net.MAUI

Public Partial Class ScannerPage
    Inherits ContentPage

    Public ReadOnly Property ReaderOptions As BarcodeReaderOptions

    Public Sub New()
        InitializeComponent()
        ReaderOptions = New BarcodeReaderOptions With {
            .Formats = BarcodeFormats.QRCode Or
                       BarcodeFormats.Code128 Or
                       BarcodeFormats.Ean13 Or
                       BarcodeFormats.UpcA,
            .TryHarder = True,
            .AutoRotate = True
        }
        BindingContext = Me
    End Sub

    Private Sub OnBarcodesDetected(sender As Object, e As BarcodeDetectionEventArgs)
        MainThread.BeginInvokeOnMainThread(Sub()
                                               For Each barcode In e.Results
                                                   ResultLabel.Text = $"{barcode.Format}: {barcode.Value}"
                                               Next
                                           End Sub)
        CameraView.IsDetecting = False
    End Sub

    Protected Overrides Sub OnDisappearing()
        MyBase.OnDisappearing()
        CameraView.IsDetecting = False ' Required — no Dispose() available
    End Sub

    Protected Overrides Sub OnAppearing()
        MyBase.OnAppearing()
        CameraView.IsDetecting = True
    End Sub
End Class

IronBarcode, olay döngüsünü bir düğme dokunuşunda tek bir eşzamanlı çağrı ile değiştirir, format yapılandırmasını tamamen kaldırır ve sayfadan yaşam döngüsü yönetimini ortadan kaldırır:

// NuGet: dotnet add package IronBarcode
// IronBarcode: stateless, all platforms, auto-detection, no lifecycle boilerplate
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    private async void ScanButton_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());
        ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
    }
    //HayırOnAppearing / OnDisappearing needed
}

// NuGet: dotnet add package IronBarcode
// IronBarcode: stateless, all platforms, auto-detection, no lifecycle boilerplate
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    private async void ScanButton_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());
        ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
    }
    //HayırOnAppearing / OnDisappearing needed
}

Imports IronBarCode

Public Partial Class ScannerPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Async Sub ScanButton_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 = New MemoryStream()
                Await stream.CopyToAsync(ms)

                Dim results = BarcodeReader.Read(ms.ToArray())
                ResultLabel.Text = If(results.FirstOrDefault()?.Value, "No barcode found")
            End Using
        End Using
    End Sub
    'HayırOnAppearing / OnDisappearing needed
End Class

Adım 1: ZXing.Net.Maui.Controls'u Kaldırın ve MauiProgram.cs'i Temizleyin

ZXing.Net.MAUI NuGet paketini kaldırın:

dotnet remove package ZXing.Net.Maui.Controls

dotnet remove package ZXing.Net.Maui.Controls

ZXing.Net.MAUI, MauiProgram.cs 'de bir defaya mahsus olmak üzere kayıt çağrısı gerektirir. Bu satırı mevcutsa kaldırın.

//Kaldırthis line from MauiProgram.cs
builder.UseBarcodeReader();

//Kaldırthis line from MauiProgram.cs
builder.UseBarcodeReader();

Bu çağrıyı destekleyen using ZXing.Net.Maui; 'nin içe aktarımı, MauiProgram.cs 'den de kaldırılabilir.

2. Adım: IronBarcode'u Kurun

dotnet add package IronBarcode

dotnet add package IronBarcode

.NET MAUI barkod tarayıcı öğreticisi, iOS için Info.plist kamera izin girişleri ve Android için AndroidManifest.xml izin bildirimleri de dahil olmak üzere tam proje yapılandırmasını kapsar.

Adım 3: İsim Alanlarını Güncelleme ve Lisansı Başlatma

Tüm dosyalardan ZXing.Net.MAUI ad alanı ithalatlarını kaldırın:

//Kaldırthese from every .cs file that imported them
using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

//Kaldırthese from every .cs file that imported them
using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

Uygulama başlangıcında IronBarcode ad alanını ekleyin ve lisans anahtarını başlatın. Uygun yer MauiProgram.cs veya App.xaml.cs 'dir; barkod işlemleri yapılmadan önce:

using IronBarCode;

// In MauiProgram.cs CreateMauiApp() or App.xaml.cs constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronBarCode;

// In MauiProgram.cs CreateMauiApp() or App.xaml.cs constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

' In MauiProgram.vb CreateMauiApp() or App.xaml.vb constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

XAML Kamera Kontrolünü ve Kod-Kapalısını Değiştirme

CameraBarcodeReaderView XAML kontrolü ve destek kodu geçişin ana hedefidir. Değişiklik, sayfa düzeninden kameranın görünümünü kaldırır ve olaya dayalı tarama desenini, bir düğme tetkiklemeli asenkron yakalama ile değiştirir.

ZXing.Net.MAUI Yaklaşımı:

XAML:

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <StackLayout>
        <zxing:CameraBarcodeReaderView
            x:Name="CameraView"
            Options="{Binding ReaderOptions}"
            BarcodesDetected="OnBarcodesDetected"
            VerticalOptions="FillAndExpand" />
        <Label x:Name="ResultLabel" Text="Scanning..." />
    </StackLayout>
</ContentPage>

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <StackLayout>
        <zxing:CameraBarcodeReaderView
            x:Name="CameraView"
            Options="{Binding ReaderOptions}"
            BarcodesDetected="OnBarcodesDetected"
            VerticalOptions="FillAndExpand" />
        <Label x:Name="ResultLabel" Text="Scanning..." />
    </StackLayout>
</ContentPage>

Kod-kapalısı:

using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode | BarcodeFormats.Code128 | BarcodeFormats.Ean13,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        CameraView.IsDetecting = true;
    }
}

using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode | BarcodeFormats.Code128 | BarcodeFormats.Ean13,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        CameraView.IsDetecting = true;
    }
}

Imports ZXing.Net.Maui
Imports ZXing.Net.Maui.Controls

Public Partial Class ScannerPage
    Inherits ContentPage

    Public ReadOnly Property ReaderOptions As BarcodeReaderOptions

    Public Sub New()
        InitializeComponent()
        ReaderOptions = New BarcodeReaderOptions With {
            .Formats = BarcodeFormats.QRCode Or BarcodeFormats.Code128 Or BarcodeFormats.Ean13,
            .TryHarder = True,
            .AutoRotate = True
        }
        BindingContext = Me
    End Sub

    Private Sub OnBarcodesDetected(sender As Object, e As BarcodeDetectionEventArgs)
        MainThread.BeginInvokeOnMainThread(Sub()
                                               For Each barcode In e.Results
                                                   ResultLabel.Text = $"{barcode.Format}: {barcode.Value}"
                                               Next
                                           End Sub)
        CameraView.IsDetecting = False
    End Sub

    Protected Overrides Sub OnDisappearing()
        MyBase.OnDisappearing()
        CameraView.IsDetecting = False
    End Sub

    Protected Overrides Sub OnAppearing()
        MyBase.OnAppearing()
        CameraView.IsDetecting = True
    End Sub
End Class

IronBarcode Yaklaşımı:

XAML:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
    <StackLayout>
        <Button Text="Scan Barcode" Clicked="ScanButton_Clicked" />
        <Label x:Name="ResultLabel" Text="Tap to scan..." />
    </StackLayout>
</ContentPage>

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
    <StackLayout>
        <Button Text="Scan Barcode" Clicked="ScanButton_Clicked" />
        <Label x:Name="ResultLabel" Text="Tap to scan..." />
    </StackLayout>
</ContentPage>

Kod-kapalısı:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    private async void ScanButton_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());
        var first = results.FirstOrDefault();
        ResultLabel.Text = first != null
            ? $"{first.Format}: {first.Value}"
            : "No barcode found";
    }

    //HayırOnAppearing or OnDisappearing required — no camera state exists between scans
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    private async void ScanButton_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());
        var first = results.FirstOrDefault();
        ResultLabel.Text = first != null
            ? $"{first.Format}: {first.Value}"
            : "No barcode found";
    }

    //HayırOnAppearing or OnDisappearing required — no camera state exists between scans
}

Imports IronBarCode
Imports System.IO
Imports System.Linq
Imports Xamarin.Essentials

Public Partial Class ScannerPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Async Sub ScanButton_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())
                Dim first = results.FirstOrDefault()
                ResultLabel.Text = If(first IsNot Nothing, $"{first.Format}: {first.Value}", "No barcode found")
            End Using
        End Using
    End Sub

    'HayırOnAppearing or OnDisappearing required — no camera state exists between scans
End Class

zxing: XAML ad alanı, BarcodeReaderOptions format listesi, MainThread.BeginInvokeOnMainThread() sarmalayıcı ve her iki yaşam döngüsü geçersiz kılmaları tamamen kaldırılır. async metodunun devamı, çağıran bağlamda — bir UI olay işleyicisi için ana iş parçacığı — çalışır, bu nedenle açık iş parçacığı geçişi gerekli değildir.

Format Belirlemesini Kaldırma

Kod tabanındaki birden fazla sayfada veya tarama senaryosunda dağılmış durumdaki herhangi bir BarcodeReaderOptions yapılandırma bloğu silinir. IronBarcode, tüm 50+ desteklenen formata karşı otomatik format tespiti gerçekleştirir, ön yapılandırma gerekmeden.

ZXing.Net.MAUI Yaklaşımı:

// ZXing.Net.MAUI: every anticipated format must be listed explicitly
// Formats not listed here will silently fail to detect
var readerOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.DataMatrix |
              BarcodeFormats.Aztec |
              BarcodeFormats.Pdf417 |
              BarcodeFormats.Code128 |
              BarcodeFormats.Code39 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA |
              BarcodeFormats.Codabar,
    TryHarder = true
};

// ZXing.Net.MAUI: every anticipated format must be listed explicitly
// Formats not listed here will silently fail to detect
var readerOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.DataMatrix |
              BarcodeFormats.Aztec |
              BarcodeFormats.Pdf417 |
              BarcodeFormats.Code128 |
              BarcodeFormats.Code39 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA |
              BarcodeFormats.Codabar,
    TryHarder = true
};

' ZXing.Net.MAUI: every anticipated format must be listed explicitly
' Formats not listed here will silently fail to detect
Dim readerOptions As New BarcodeReaderOptions With {
    .Formats = BarcodeFormats.QRCode Or
               BarcodeFormats.DataMatrix Or
               BarcodeFormats.Aztec Or
               BarcodeFormats.Pdf417 Or
               BarcodeFormats.Code128 Or
               BarcodeFormats.Code39 Or
               BarcodeFormats.Ean13 Or
               BarcodeFormats.UpcA Or
               BarcodeFormats.Codabar,
    .TryHarder = True
}

IronBarcode Yaklaşımı:

// IronBarcode: no format configuration needed
// All formats are detected automatically on every read call
var results = BarcodeReader.Read(imageBytes);

// Optional: restrict to specific formats for performance tuning (not required for correctness)
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};
var tunedResults = BarcodeReader.Read(imageBytes, options);

// IronBarcode: no format configuration needed
// All formats are detected automatically on every read call
var results = BarcodeReader.Read(imageBytes);

// Optional: restrict to specific formats for performance tuning (not required for correctness)
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};
var tunedResults = BarcodeReader.Read(imageBytes, options);

Imports IronBarcode

' IronBarcode: no format configuration needed
' All formats are detected automatically on every read call
Dim results = BarcodeReader.Read(imageBytes)

' Optional: restrict to specific formats for performance tuning (not required for correctness)
Dim options As New BarcodeReaderOptions With {
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128
}
Dim tunedResults = BarcodeReader.Read(imageBytes, options)

Performans-sensitif senaryolar için IronBarcode'da format ipuçları mevcuttur, ancak bunlar isteğe bağlıdır. Bir seçenek nesnesinde listelenmeyen bir formattaki barkod, yine de tespit edilir ve geri döndürülür.

IsDetecting Yaşam Döngüsü Yönetimini Kaldırma

OnAppearing ve OnDisappearing 'yı geçersiz kılan ve CameraView.IsDetecting 'yi değiştirmek için var olan her bir çağrı kaldırılır. Bu metod geçersiz kılmalarında başka sayfa yaşam döngüsü mantığı varsa, sadece IsDetecting satırlarını kaldırın ve diğer mantığı koruyun.

ZXing.Net.MAUI Yaklaşımı:

// Required boilerplate on every page — omitting this causes camera resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

// Required boilerplate on every page — omitting this causes camera resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

' Required boilerplate on every page — omitting this causes camera resource leaks
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = False
    End If
End Sub

Protected Overrides Sub OnAppearing()
    MyBase.OnAppearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = True
    End If
End Sub

IronBarcode Yaklaşımı:

// Delete both methods if they contain only IsDetecting management.
// If they contain other logic, remove only the IsDetecting lines and keep the rest.
//IronBarcode is stateless — there is no camera view running between button taps.

// Delete both methods if they contain only IsDetecting management.
// If they contain other logic, remove only the IsDetecting lines and keep the rest.
//IronBarcode is stateless — there is no camera view running between button taps.

' Delete both methods if they contain only IsDetecting management.
' If they contain other logic, remove only the IsDetecting lines and keep the rest.
' IronBarcode is stateless — there is no camera view running between button taps.

Windows MAUI: Aynı Kod, Koşullu Derleme Yok

ZXing.Net.MAUI ile, projeye bir Windows hedefi eklemek ya derlenirken başarısız oldu ya da platforma özgü parçalara ihtiyaç duydu çünkü Windows uygulaması hiç yazılmamıştı.IronBarcode ile, iOS ve Android'de çalışan aynı kod, Windows'ta herhangi bir değişiklik yapmadan derlenir ve çalışır.

ZXing.Net.MAUI Yaklaşımı:

// Windows MAUI: either fails to compile or requires a platform-specific stub
// There is no documented path to Windows support
#if ANDROID || IOS
    // ZXing.Net.MAUI scanning — Windows has no implementation
#endif

// Windows MAUI: either fails to compile or requires a platform-specific stub
// There is no documented path to Windows support
#if ANDROID || IOS
    // ZXing.Net.MAUI scanning — Windows has no implementation
#endif

IronBarcode Yaklaşımı:

// NuGet: dotnet add package IronBarcode
//Hayırplatform conditionals — same code runs on iOS, Android, Windows, and macOS
private async void ScanButton_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());
    ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
}

// NuGet: dotnet add package IronBarcode
//Hayırplatform conditionals — same code runs on iOS, Android, Windows, and macOS
private async void ScanButton_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());
    ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
}

' NuGet: dotnet add package IronBarcode
' Platform conditionals — same code runs on iOS, Android, Windows, and macOS
Private Async Sub ScanButton_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())
            ResultLabel.Text = If(results.FirstOrDefault()?.Value, "No barcode found")
        End Using
    End Using
End Sub

Windows'ta, MediaPicker.CapturePhotoAsync(), kullanıcıya bir resim dosyası seçme imkanı sağlayan Windows dosya seçici ile eşleştirilir — masaüstü ortamı için uygun bir davranış. MAUI masaüstü barkod kılavuzu, Windows vemacOS MAUIyapılandırmasını detaylı bir şekilde kapsar.

PDF Barkod Okuma (Yeni Yetenek)

ZXing.Net.MAUI, PDF dökümanlarından barkod okumak için bir API'ye sahip değildir. Bu, geçişin sağladığı yeni bir gereksinimse, aşağıdaki desen uygulanır:

ZXing.Net.MAUI Yaklaşımı:

// ZXing.Net.MAUI: no API for PDF or file-based barcode reading
// Cannot fulfill this requirement — a separate library is required

// ZXing.Net.MAUI: no API for PDF or file-based barcode reading
// Cannot fulfill this requirement — a separate library is required

' ZXing.Net.MAUI: no API for PDF or file-based barcode reading
' Cannot fulfill this requirement — a separate library is required

IronBarcode Yaklaşımı:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read all barcodes from all pages of a PDF
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in pdfResults)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
private async void ReadFileButton_Clicked(object sender, EventArgs e)
{
    var file = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select image or PDF"
    });
    if (file == null) return;

    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read all barcodes from all pages of a PDF
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in pdfResults)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
private async void ReadFileButton_Clicked(object sender, EventArgs e)
{
    var file = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select image or PDF"
    });
    if (file == null) return;

    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

Imports IronBarCode

' Read all barcodes from all pages of a PDF
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each barcode In pdfResults
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

' Read from a user-selected file using MAUI FilePicker
Private Async Sub ReadFileButton_Clicked(sender As Object, e As EventArgs)
    Dim file = Await FilePicker.PickAsync(New PickOptions With {
        .PickerTitle = "Select image or PDF"
    })
    If file Is Nothing Then Return

    Dim fileResults = BarcodeReader.Read(file.FullPath)
    For Each result In fileResults
        ResultLabel.Text &= $"\n{result.Format}: {result.Value}"
    Next
End Sub

Tam PDF barkod okuma iş akışı — çok sayfalı belgeler, sayfa numarası meta verileri ve karma format belgeler içerir — PDF'den barkod okuyun kılavuzunda belgelenmiştir.

Sorun 1: Canlı Vizör Eşdeğeri Yok

ZXing.Net.MAUI: CameraBarcodeReaderView, sayfa düzeninde sürekli bir kamera yayını gösterir ve kullanıcıya tarama geri bildirimleri ile canlı bir önizleme sunar.

Çözüm:IronBarcode bir canlı vizör kontrolü sağlamaz. Yerine kullanılan desen, platform sistem kamera UI'sını açan MediaPicker.CapturePhotoAsync() 'yi kullanır. Sistem kamera kendi canlı önizlemesini ve odak göstergesini sağlar. Kullanıcı resmi çekip onayladıktan sonra sonuç BarcodeReader.Read() 'ye gönderilir. Sürekli bir uygulama içi bakış açısı elemanı, sistem kamera UI'sı ile değiştirilemeyen zorunlu bir UX elemanı ise, kamera entegrasyon katmanı ayrı olarak Microsoft.Maui.Media ya da platform kamera API'ları ile inşa edilmelidir;IronBarcode ise kod çözme adımını yönetir.

Sorun 2: Kamera İzin Bildirimleri

ZXing.Net.MAUI: Kamera izinleri, ZXing.Net.MAUI kurulum talimatlarının bir parçası olarak projede bildirilmiş olabilir.

Çözüm: IronBarcode'ın MAUI deseni kullandığı MediaPicker.CapturePhotoAsync() çağrısı için kamera izinleri gereklidir. iOS için NSCameraUsageDescription 'nun Info.plist 'de bulunduğunu ve Android için <uses-permission android:name="android.permission.CAMERA" /> 'nun AndroidManifest.xml 'de bulunduğunu doğrulayın. IronBarcode'ın kendisi kameraya doğrudan erişmez — görüntüleri işler — ancak ona görüntü sağlayan MediaPicker çağrısı kamera izni gerektirir. İzin kurulumu .NET MAUI barkod tarayıcı öğreticisine kapsanmıştır.

Sorun 3: Windows Build Şimdi Başarısız Olmadığı Yerlerde Başarılı Oluyor

ZXing.Net.MAUI: ZXing.Net.MAUI ile bir Windows hedefi eklemeye çalışan projeler genellikle derleme hataları ile karşılaştı veya kütüphanenin Windows derlemesinden koşullu MSBuild mantığıyla hariç tutulmasını gerektirdi.

Çözüm: ZXing.Net.MAUI kaldırıldıktan ve IronBarcode yüklendikten sonra,Windows MAUIderlemesi herhangi bir platform koşullu olmadan başarılı olur. Herhangi bir #if ANDROID|| IOS korumasını, Windows derlemesinden ZXing.Net.MAUI çağrılarını dışlamak için yerleştirilmiş herhangi IronBarcodeBarcodeReader.Read() çağrısı tüm hedef çerçevelerde derlenir ve çalıştırılır. Windows yapılarından MediaPicker.CapturePhotoAsync() hariç tutulduysa, bu dışlama da kaldırılabilir — metotWindows MAUIüzerinde desteklenir ve dosya seçici ile eşleştirilir. Koşulları kaldırdıktan sonra, tüm hedef çerçeveler için tam çözümün temiz derlenmesini doğrulayın.

Sorun 4: BarcodeFormats Enum Referansları

ZXing.Net.MAUI: ZXing.Net.Maui 'den BarcodeFormats enum'u, BarcodeReaderOptions yapılandırmalarında yaygın olarak kullanılır. Paket kaldırıldıktan sonra, kalan referanslar derleme hataları üretir.

Çözüm: Format listelerini yapılandırmak için kullanılan tüm BarcodeReaderOptions başlatma bloklarını silin. IronBarcode, doğru çalışması için format belirtimine ihtiyaç duymaz. Herhangi bir kalan kod, günlük, görüntüleme veya karşılaştırma amaçları için BarcodeFormats değerlerine referans veriyorsa, bunları IronBarCode ad alanından BarcodeEncoding değerleri ile değiştirin. Paket kaldırıldıktan sonra kalan tüm referansları bulmak için grep -rn "BarcodeFormats\." --include="*.cs" . çalıştırın.

Geçiş Öncesi Görevler

Kod tabanındaki tüm ZXing.Net.MAUI kullanımını değişiklik yapmadan önce denetleyin:

grep -rn "ZXing.Net.Maui" --include="*.cs" --include="*.xaml" .
grep -rn "CameraBarcodeReaderView" --include="*.cs" --include="*.xaml" .
grep -rn "BarcodeDetectionEventArgs" --include="*.cs" .
grep -rn "BarcodeReaderOptions" --include="*.cs" .
grep -rn "BarcodeFormats\." --include="*.cs" .
grep -rn "IsDetecting" --include="*.cs" .
grep -rn "UseBarcodeReader" --include="*.cs" .
grep -rn "zxing:" --include="*.xaml" .
grep -rn "e\.Results" --include="*.cs" .

grep -rn "ZXing.Net.Maui" --include="*.cs" --include="*.xaml" .
grep -rn "CameraBarcodeReaderView" --include="*.cs" --include="*.xaml" .
grep -rn "BarcodeDetectionEventArgs" --include="*.cs" .
grep -rn "BarcodeReaderOptions" --include="*.cs" .
grep -rn "BarcodeFormats\." --include="*.cs" .
grep -rn "IsDetecting" --include="*.cs" .
grep -rn "UseBarcodeReader" --include="*.cs" .
grep -rn "zxing:" --include="*.xaml" .
grep -rn "e\.Results" --include="*.cs" .

Denetimle belirlenen tüm tarama sayfalarını belgeleyin. Hangi OnAppearing ve OnDisappearing geçersiz kılmalarının sadece silinecek IsDetecting yönetimi içerdiğini ve hangilerinin diğer mantık içerdiğini (kısmen değiştirilecek) not edin. Yalnızca tespit yapılandırması dışında yollarla kullanılan format listelerini içeren BarcodeReaderOptions örneklerini not edin.

Kod Güncelleme Görevleri

1. ZXing.Net.Maui.Controls NuGet paketini proje dosyasından kaldırın
2. MauiProgram.cs 'den builder.UseBarcodeReader() kaldırın
3. Tüm dosyalardan using ZXing.Net.Maui; ve using ZXing.Net.Maui.Controls; ad alanı içe aktarımlarını kaldırın
4. IronBarcode NuGet paketini yükleyin
5. Barkod okuma kullanacak olan tüm dosyalara using IronBarCode; ekleyin
6. Uygulama başlangıcına IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; ekleyin
7. Tüm XAML dosyalarından xmlns:zxing ad alanı bildirimini kaldırın
8. XAML dosyalarındaki tüm <zxing:CameraBarcodeReaderView> öğelerini kaldırın
9. Her bir XAML dosyasında kaldırılan kamera görünümünün yerine bir <Button> kontrolü ekleyin
10. Her tarama düğmesine Clicked="ScanButton_Clicked" ekleyin
11. Tüm arka plan dosyalarından OnBarcodesDetected olay işleyici metodlarını silin
12. Her sayfaya MediaPicker.CapturePhotoAsync() + BarcodeReader.Read() uygulayan async void ScanButton_Clicked metodlarını ekleyin
13. Tüm BarcodeReaderOptions başlatma bloklarını silin
14. Yalnızca IsDetecting yönetimi için var olan tüm OnDisappearing ve OnAppearing geçersiz kılmaları silin
15. Diğer mantığı içeren herhangi bir OnDisappearing ve OnAppearing geçersiz kılmalarından IsDetecting satırlarını kaldırın
16. ZXing.Net.MAUI'yi Windows derlemesinden izole eden hiçbir #if ANDROID|| IOS koşullu derleme kontrolü kalmasın
17. Kalan tüm BarcodeFormats.X enum referanslarını BarcodeEncoding.X eşdeğerleri ile değiştirin

Geçiş Sonrası Testler

Geçiş temiz bir şekilde derlendikten sonra, aşağıdakileri doğrulayın:

• Android MAUI: tarama düğmesi sistem kamerayı açar, bir fotoğraf çeker ve doğru bir barkod sonucu döndürür — Android tarama kılavuzuyla teyit edin
• iOS MAUI: Aynı akış, iPhone 15 Pro donanımındaki otomatik odaklanma sorununu içeren iOS üzerinde çalışır
• Windows MAUI: Windows derleme hatasız derlenir ve tarama düğmesi dosya seçiciyi açar ve seçilen bir resimden doğru bir sonuç döndürür
• Formatlar: otomatik algılamayı doğrulamak için eski BarcodeFormats listesine dahil edilmeyen formatlarda barkod taramayı test edin
• Sayfa gezinmesi: Tarama sayfasına birden çok kez gidip dönün ve bellek artışı veya kamera başlatma hatası oluşmadığını doğrulayın
• PDF okuma: geçişin yeni bir yetenek olarak PDF barkod okuması eklemesi durumunda, çok sayfalı PDF'lerin doğru sayfa numarası meta verileriyle sonuçlar döndürdüğünü doğrulayın