ZXing.Net.MAUI vs IronBarcode: C# Barcode Library Comparison

The CameraBarcodeReaderView Architecture

The CameraBarcodeReaderView control is the central component of ZXing.Net.MAUI. It is declared in XAML and configured through a BarcodeReaderOptions binding. Every page that uses it must implement OnAppearing and OnDisappearing overrides to manage the IsDetecting state:

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

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

// Required on every page to avoid camera resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  // No Dispose() — this is the best available option
}

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

// Required on every page to avoid camera resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  // No Dispose() — this is the best available option
}

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

Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = False ' No Dispose() — this is the best available option
    End If
End Sub

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

Every scan page in a ZXing.Net.MAUI application carries this lifecycle boilerplate. The absence of IDisposable means there is no idiomatic C# pattern to rely on — camera state is managed manually in a framework that otherwise handles resource cleanup automatically.

Detailed Feature Comparison

ZXing.Net.MAUI Approach

ZXing.Net.MAUI is designed exclusively for iOS and Android because it is built around platform camera APIs that do not have a Windows MAUI counterpart in the library's current implementation. The repository explicitly documents Windows MAUI as unsupported, and no roadmap exists for adding it. This is not a temporary gap — it reflects the architectural choice to build the library around a live camera viewfinder control whose platform implementations were written only for mobile operating systems.

A MAUI project that targets net8.0-windows10.0.19041.0 will not get barcode scanning functionality from ZXing.Net.MAUI. macOS MAUI is similarly absent. Teams that start a project with mobile-only targets and later add a Windows or macOS requirement will find that ZXing.Net.MAUI cannot be part of the solution for those targets. The iOS support itself carries a caveat: iPhone 15 Pro and Pro Max devices are documented as affected by an auto-focus failure that prevents reliable detection.

IronBarcode Approach

IronBarcode supports all MAUI target frameworks — iOS, Android, Windows, and macOS — from the same package and the same code pattern. The MediaPicker + BarcodeReader.Read() approach maps naturally to each platform: on mobile, MediaPicker.CapturePhotoAsync() invokes the device camera; on Windows, it maps to the file picker, which is appropriate behavior for a desktop environment. No platform-specific code, no conditional compilation, and no platform service registration is required.

The MAUI desktop barcode pattern for Windows and macOS is covered by the same package that handles mobile scanning. The same BarcodeReader.Read() call that runs on an Android device also runs in an ASP.NET Core endpoint, a WinForms desktop application, or an Azure Function — the deployment target does not affect the API.

ZXing.Net.MAUI Approach

CameraBarcodeReaderView is a persistent camera control embedded in the XAML page. It begins processing camera frames when IsDetecting is set to true and stops when it is set to false. The absence of a Dispose() implementation means camera resources are not released through the standard IDisposable pattern when the user navigates away. The documented mitigation is to set IsDetecting = false in OnDisappearing() and restore it in OnAppearing():

// ZXing.Net.MAUI: required on every page to prevent resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

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

// ZXing.Net.MAUI: required on every page to prevent resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

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

' ZXing.Net.MAUI: required on every page to prevent resource leaks
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    CameraView.IsDetecting = False
End Sub

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

This pattern must be repeated on every page that hosts a scanner. Applications that navigate frequently to and from scan pages accumulate camera resource leaks that can manifest as memory growth, battery drain, and intermittent camera initialization failures on return. The iPhone 15 Pro auto-focus issue is a separate concern within the camera integration layer: the camera view renders the barcode clearly, but the auto-focus system does not lock sharply enough for detection on iPhone16,1 and iPhone16,2 hardware. The only documented workaround is to instruct the user to manually adjust the distance between the device and the barcode.

IronBarcode Approach

IronBarcode does not embed a camera control in the XAML layout. Instead, the MediaPicker.CapturePhotoAsync() call opens the system camera UI when the user taps a button. The system camera handles focus, exposure, and auto-focus independently. When the user confirms the capture, the resulting image is passed to BarcodeReader.Read() as a byte array:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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());
    foreach (var barcode in results)
        Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

// No OnAppearing or OnDisappearing needed — no camera state to manage

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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());
    foreach (var barcode in results)
        Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

// No OnAppearing or OnDisappearing needed — no camera state to manage

Imports IronBarCode
Imports System.IO
Imports System.Threading.Tasks

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())
            For Each barcode In results
                Console.WriteLine($"{barcode.Format}: {barcode.Value}")
            Next
        End Using
    End Using
End Sub

' No OnAppearing or OnDisappearing needed — no camera state to manage

The .NET MAUI barcode scanner tutorial covers the full project setup for this pattern, including permissions configuration for both iOS and Android. Because there is no persistent camera view, there is no resource to release, no state to toggle, and no lifecycle boilerplate to maintain across pages.

ZXing.Net.MAUI Approach

ZXing.Net.MAUI inherits the ZXing.Net format specification requirement. Before scanning begins, the developer must populate BarcodeReaderOptions.Formats with a bitmask of the BarcodeFormats enum values that should be detected. Formats not included in this list will not be detected — silently, with no error or warning:

// ZXing.Net.MAUI: format specification required
// Any format not listed here will never be detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

// ZXing.Net.MAUI: format specification required
// Any format not listed here will never be detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

' ZXing.Net.MAUI: format specification required
' Any format not listed here will never be detected
ReaderOptions = New BarcodeReaderOptions With {
    .Formats = BarcodeFormats.QRCode Or
               BarcodeFormats.Code128 Or
               BarcodeFormats.Ean13 Or
               BarcodeFormats.UpcA,
    .TryHarder = True,
    .AutoRotate = True
}

If a user points the camera at a GS1 DataBar, an Aztec code, a MaxiCode, or any format that was not anticipated when the options were configured, the scan silently fails. The user sees a barcode that the camera renders clearly, nothing is detected, and the application appears broken. In a controlled environment — a warehouse where every item carries a Code128 label — this is manageable. In any deployment where barcode formats are determined by external suppliers, customers, or third-party systems, the silent miss becomes a recurring support issue.

IronBarcode Approach

IronBarcode performs automatic format detection across all supported formats without any pre-configuration. BarcodeReader.Read() analyzes the image and returns results for every barcode it identifies, regardless of format. No BarcodeReaderOptions list is required:

// IronBarcode: no format specification needed
// All 50+ formats detected automatically
var results = BarcodeReader.Read(imageBytes);
foreach (var barcode in results)
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");

// IronBarcode: no format specification needed
// All 50+ formats detected automatically
var results = BarcodeReader.Read(imageBytes);
foreach (var barcode in results)
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");

Imports IronBarcode

' IronBarcode: no format specification needed
' All 50+ formats detected automatically
Dim results = BarcodeReader.Read(imageBytes)
For Each barcode In results
    Console.WriteLine($"{barcode.Format}: {barcode.Value}")
Next

If performance tuning is needed for a controlled scenario where only one format is expected, format hints can be passed optionally — but they are never required for correct detection. A barcode in a format that was not anticipated by the developer will still be detected and returned.

ZXing.Net.MAUI Approach

ZXing.Net.MAUI is a camera control library. It has no API for reading barcodes from file paths, byte arrays passed directly from storage, or PDF documents. The CameraBarcodeReaderView control requires a live camera feed; there is no static method that accepts a file path and returns barcode results. Teams that need to read barcodes from uploaded PDFs, document management systems, or batch image processing queues cannot use ZXing.Net.MAUI for those scenarios and must introduce a separate library.

IronBarcode Approach

IronBarcode reads barcodes from any source through the same BarcodeReader.Read() method. It accepts file paths, byte arrays, streams, and PDF documents. PDF parsing is native — IronBarcode processes PDF pages directly without an intermediate rasterization step:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Read from a user-selected file using MAUI FilePicker
var file = await FilePicker.PickAsync();
if (file != null)
{
    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 barcodes from a PDF file
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
var file = await FilePicker.PickAsync();
if (file != null)
{
    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

Imports IronBarCode
Imports Microsoft.Maui.Storage

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

' Read from a user-selected file using MAUI FilePicker
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim fileResults = BarcodeReader.Read(file.FullPath)
    For Each result In fileResults
        ResultLabel.Text &= $"\n{result.Format}: {result.Value}"
    Next
End If

The full PDF barcode reading workflow, including multi-page documents and mixed barcode formats across pages, is documented in the read barcodes from PDF guide. This covers shipping invoices, digital tickets, document management workflows, and batch processing scenarios that the camera-only architecture of ZXing.Net.MAUI cannot address.

Windows MAUI Requirements

The most common trigger for re-evaluation is the addition of a Windows MAUI target to a project that started as iOS and Android only. MAUI teams frequently begin with mobile-first builds and expand to desktop targets as requirements evolve. When that expansion happens, ZXing.Net.MAUI provides no path forward — the Windows platform is not implemented and is not on a public roadmap. The team must either accept that barcode scanning will be unavailable on Windows or replace the library. Because the replacement involves a structural change to the scanning pattern regardless, teams typically make the change for all platforms at the same time.

Current-Generation Hardware Compatibility

The documented iPhone 15 Pro auto-focus failure represents an exposure for any team shipping a production barcode scanner to iOS users. iPhone 15 Pro and Pro Max are flagship devices purchased by the consumer segment most likely to demand a polished application experience. A workaround that requires users to manually adjust their distance from a barcode is not a solution that survives a product review. Teams that surface this issue in QA, or receive support reports from iPhone 15 Pro users, face a choice between remaining on a library with no fix available or migrating to an approach that is not affected by the camera view focus model.

File and Document Processing

Barcode scanning requirements rarely stay scoped to live camera capture. Applications that begin as inventory scanners frequently expand to include reading barcodes from uploaded PDFs, processing shipping invoices, or handling digital tickets from email attachments. ZXing.Net.MAUI has no API for any of these scenarios. When a product requirement lands on the backlog that involves reading a barcode from a file or document, teams using ZXing.Net.MAUI must introduce a separate library to handle it. If the team is already using IronBarcode for any of those file-based scenarios, consolidating the MAUI camera scanning into the same library becomes the natural next step.

Production Stability Requirements

The v0.5.0 pre-release designation carries real implications for teams subject to software composition analysis, dependency audits, or internal approval processes. Many enterprise development environments require that production dependencies carry a stable release designation, a commercial support contract, or both. ZXing.Net.MAUI meets neither criterion. Community-maintained pre-release libraries are appropriate for internal tools and prototypes, but become a harder conversation in customer-facing applications where the barcode scanner is a primary workflow. The absence of a paid support tier means that any critical bug depends entirely on volunteer contributor availability.

CameraBarcodeReaderView to MediaPicker Pattern

The CameraBarcodeReaderView XAML control and its xmlns:zxing namespace declaration are removed entirely. In each XAML file that contained a scanner view, the replacement is a Button control that invokes MediaPicker.CapturePhotoAsync() in its Clicked handler. The event-driven model — where results arrive through BarcodesDetected — is replaced by reading the return value of BarcodeReader.Read() directly in the async handler.

IsDetecting Lifecycle Removal

Every OnAppearing and OnDisappearing override that exists solely to toggle CameraView.IsDetecting can be deleted. If those overrides contain other page lifecycle logic, the IsDetecting lines are removed and the remaining logic is preserved. There is no IronBarcode equivalent to IsDetecting because there is no persistent camera state to manage between page navigations.

UseBarcodeReader() Registration Removal

ZXing.Net.MAUI requires a one-time builder.UseBarcodeReader() call in MauiProgram.cs to register its platform camera services. IronBarcode does not require any MauiProgram.cs registration. The UseBarcodeReader() line is removed, and the using ZXing.Net.Maui; namespace import that supports it is removed alongside the package uninstall.