Die CameraBarcodeReaderView-Architektur

Das CameraBarcodeReaderView-Steuerelement ist die zentrale Komponente von ZXing.Net.MAUI. Es wird in XAML deklariert und über eine BarcodeReaderOptions-Verbindung konfiguriert. Jede Seite, die es verwendet, muss OnAppearing- und OnDisappearing-Überschreibungen implementieren, um den IsDetecting-Zustand zu verwalten:

<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>

// Toggling IsDetecting in lifecycle overrides is the documented pattern
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  //NeinIDisposable on the control
}

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

// Toggling IsDetecting in lifecycle overrides is the documented pattern
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  //NeinIDisposable on the control
}

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

' Toggling IsDetecting in lifecycle overrides is the documented pattern
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = False 'NeinIDisposable on the control
    End If
End Sub

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

Jede Scanseite in einer ZXing .NET.MAUI-Anwendung enthält diesen Lebenszyklus-Boilerplate-Code. Das Fehlen von IDisposable bedeutet, dass der Kamerazustand manuell über das IsDetecting-Flag anstelle des standardmäßigen Dispose-Musters verwaltet werden muss.

Detaillierter Funktionsvergleich

ZXing .NET.MAUI-Ansatz

ZXing.Net.MAUI ist auf Plattform-Kamera-APIs für iOS und Android aufgebaut. Windows MAUIunterstützt nur Barcode-Generierung — Kamera-Scannen ist nicht implementiert und steht nicht auf einer öffentlichen Roadmap. Dies spiegelt die architektonische Entscheidung wider, die Bibliothek um ein Live-Kamera-Sucher-Steuerelement zu bauen, dessen Plattformimplementierungen nur für mobile Betriebssysteme geschrieben wurden.

Ein MAUI-Projekt, das auf net8.0-windows10.0.19041.0 abzielt, erhält keine Barcode-Scannen-Funktionalität von ZXing.Net.MAUI. Mac Catalyst ist in der Ziellistenrahmen enthalten, jedoch ist das Scannen auf diesem Ziel nicht offiziell dokumentiert. Teams, die ein Projekt mit nur mobilen Zielen starten und später eine Windows- oder macOS-Anforderung hinzufügen, werden feststellen, dass ZXing.Net.MAUI auf diesen Zielen nicht scannen kann. Der iOS-Support selbst trägt eine Einschränkung: GitHub Issue #260 dokumentiert, dass iPhone 15 Pro und Pro Max-Geräte von einem Auto-Fokus-Issue betroffen sind, das eine zuverlässige Erkennung verhindert.

IronBarcode Ansatz

IronBarcode unterstützt alle MAUI-Zielframeworks – iOS, Android, Windows und macOS – mit demselben Paket und demselben Codemuster. Der MediaPicker + BarcodeReader.Read()-Ansatz passt sich natürlich jeder Plattform an: auf Mobilgeräten ruft MediaPicker.CapturePhotoAsync() die Gerätekamera auf; Unter Windows wird es dem Dateiauswahldialog zugeordnet, was für eine Desktop-Umgebung ein angemessenes Verhalten darstellt. Es ist kein plattformspezifischer Code, keine bedingte Kompilierung und keine Registrierung von Plattformdiensten erforderlich.

Das MAUI-Desktop-Barcode-Muster für Windows und macOS wird vom selben Paket abgedeckt, das auch das Scannen auf Mobilgeräten übernimmt. Der gleiche BarcodeReader.Read()-Aufruf, der auf einem Android-Gerät läuft, läuft auch in einem ASP.NET Core-Endpunkt, einer WinForms-Desktopanwendung oder einer Azure-Funktion — das Bereitstellungsziel beeinflusst die API nicht.

ZXing .NET.MAUI-Ansatz

CameraBarcodeReaderView ist ein persistentes Kamerasteuerelement, das in der XAML-Seite eingebettet ist. Es beginnt mit der Verarbeitung von Kameraframes, wenn IsDetecting auf true gesetzt ist, und stoppt, wenn es auf false gesetzt ist. Das Fehlen einer Dispose()-Implementierung bedeutet, dass Kameraresourcen nicht durch das standardmäßige IDisposable-Muster freigegeben werden, wenn der Benutzer wegnavigiert. Die dokumentierte Abschwächung besteht darin, IsDetecting = false in OnDisappearing() zu setzen und es in OnAppearing() wiederherzustellen:

// ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

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

// ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

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

' ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    CameraView.IsDetecting = False
End Sub

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

Dieses Muster muss auf jeder Seite wiederholt werden, die einen Scanner enthält. Anwendungen, die häufig zu und von Scan-Seiten navigieren, können Kameraressourcen ansammeln, die nicht vollständig freigegeben wurden, was in GitHub Issue #164 verfolgt wird, zusammen mit Berichten über Speicherwachstum und sporadische Kamerainitialisierung bei Rückkehr. Das Autofokusproblem beim iPhone 15 Pro (GitHub-Issue #260) ist ein separates Anliegen in der Kamera-Integrationsschicht: Die Kameraansicht rendert den Barcode klar, aber das Autofokussystem arretiert nicht scharf genug für die Erkennung auf iPhone16,1- und iPhone16,2-Hardware. Das dokumentierte Workaround ist, dem Benutzer zu sagen, er solle den Abstand zwischen dem Gerät und dem Barcode manuell anpassen.

IronBarcode Ansatz

IronBarcode bettet keine Kamerasteuerung in das XAML-Layout ein. Stattdessen öffnet der MediaPicker.CapturePhotoAsync()-Aufruf die System-Kamera-UI, wenn der Benutzer einen Button drückt. Die Systemkamera übernimmt Fokus, Belichtung und Autofokus unabhängig. Wenn der Benutzer die Aufnahme bestätigt, wird das resultierende Bild als Byte-Array an BarcodeReader.Read() übergeben:

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

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

//NeinOnAppearing or OnDisappearing needed — no camera state to manage

Imports IronBarCode

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

'NeinOnAppearing or OnDisappearing needed — no camera state to manage

Das .NET MAUI Barcode-Scanner-Tutorial behandelt die vollständige Projekteinrichtung für dieses Muster, einschließlich der Berechtigungskonfiguration für iOS und Android. Da es keine persistente Kameraansicht gibt, gibt es keine Ressource freizugeben, keinen Zustand umzuschalten und keinen Lebenszyklus-Boilerplate-Code, der seitenübergreifend gepflegt werden muss.

ZXing .NET.MAUI-Ansatz

ZXing .NET.MAUI erbt die ZXing .NET -Formatspezifikationsanforderung. Bevor das Scannen beginnt, muss der Entwickler BarcodeReaderOptions.Formats mit einem Bitmasken der BarcodeFormats-Enum-Werte, die erkannt werden sollen, befüllen. Formate, die nicht in dieser Liste enthalten sind, werden nicht erkannt – stillschweigend, ohne Fehlermeldung oder Warnung:

// ZXing.Net.MAUI: formats must be declared explicitly
// Formats not listed here are not detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

// ZXing.Net.MAUI: formats must be declared explicitly
// Formats not listed here are not detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

' ZXing.Net.MAUI: formats must be declared explicitly
' Formats not listed here are not detected
ReaderOptions = New BarcodeReaderOptions With {
    .Formats = BarcodeFormats.QRCode Or
               BarcodeFormats.Code128 Or
               BarcodeFormats.Ean13 Or
               BarcodeFormats.UpcA,
    .TryHarder = True,
    .AutoRotate = True
}

Wenn ein Benutzer die Kamera auf einen GS1 DataBar, einen Aztec-Code, einen MaxiCode oder ein beliebiges Format richtet, das nicht in den Optionen deklariert ist, gibt der Scan kein Ergebnis zurück, ohne einen Fehler zu erzeugen. Die Kamera rendert den Barcode und es wird kein Resultat an die Anwendung zurückgegeben. In einer kontrollierten Umgebung – einem Lager, in dem jeder Artikel mit einem Code128-Etikett versehen ist – ist dies zu bewältigen. In Bereitstellungen, in denen Barcode-Formate von externen Lieferanten, Kunden oder Drittsystemen bestimmt werden, wird das Fehlen eines Fallback-Pfads zu einem wiederkehrenden Support-Problem.

IronBarcode Ansatz

IronBarcode führt eine automatische Formaterkennung für alle unterstützten Formate ohne jegliche Vorkonfiguration durch. BarcodeReader.Read() analysiert das Bild und gibt Ergebnisse für jeden Barcode zurück, den es identifiziert, unabhängig vom Format. Keine BarcodeReaderOptions-Liste ist erforderlich:

// 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

Wenn eine Leistungsoptimierung für ein kontrolliertes Szenario erforderlich ist, in dem nur ein Format erwartet wird, können Formathinweise optional übergeben werden – sie sind jedoch niemals für die korrekte Erkennung erforderlich. Ein Barcode in einem vom Entwickler nicht vorhergesehenen Format wird dennoch erkannt und zurückgegeben.

ZXing .NET.MAUI-Ansatz

ZXing .NET.MAUI ist eine Kamerasteuerungsbibliothek. Es verfügt über keine API zum Lesen von Barcodes aus Dateipfaden, direkt aus dem Speicher übergebenen Byte-Arrays oder PDF-Dokumenten. Das CameraBarcodeReaderView-Steuerelement erfordert eine Live-Kamerafeed; Es gibt keine statische Methode, die einen Dateipfad akzeptiert und Barcode-Ergebnisse zurückgibt. Teams, die Barcodes aus hochgeladenen PDFs, Dokumentenmanagementsystemen oder Stapelbildverarbeitungswarteschlangen lesen müssen, können ZXing .NET.MAUI für diese Szenarien nicht verwenden und müssen eine separate Bibliothek einführen.

IronBarcode Ansatz

IronBarcode liest Barcodes aus jeder Quelle durch die gleiche BarcodeReader.Read()-Methode. Es akzeptiert Dateipfade, Byte-Arrays, Datenströme und PDF-Dokumente. PDF-Parsing ist nativ – IronBarcode verarbeitet PDF-Seiten direkt ohne einen Zwischenschritt der Rasterisierung:

// 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

Der vollständige Workflow zum Lesen von PDF-Barcodes, einschließlich mehrseitiger Dokumente und gemischter Barcode-Formate über mehrere Seiten hinweg, ist im Leitfaden "Barcodes aus PDF lesen" dokumentiert. Dies umfasst Versandrechnungen, digitale Tickets, Dokumentenmanagement-Workflows und Stapelverarbeitungsszenarien, die die reine Kameraarchitektur von ZXing .NET.MAUI nicht abdecken kann.

Windows MAUI-Anforderungen

Der häufigste Auslöser für eine erneute Bewertung ist das Hinzufügen eines Windows MAUI-Ziels zu einem Projekt, das ursprünglich nur für iOS und Android konzipiert war. Die Teams von MAUI beginnen häufig mit mobilen Versionen und erweitern diese dann auf Desktop-Ziele, wenn sich die Anforderungen ändern. Wenn diese Erweiterung erfolgt, bietet ZXing .NET.MAUI keine Lösung – die Windows-Plattform ist nicht implementiert und auch nicht in der öffentlichen Roadmap vorgesehen. Das Team muss entweder akzeptieren, dass Barcode-Scanning unter Windows nicht verfügbar sein wird, oder die Bibliothek ersetzen. Da der Austausch in jedem Fall eine strukturelle Änderung des Scanmusters mit sich bringt, nehmen die Teams die Änderung in der Regel für alle Plattformen gleichzeitig vor.

Hardwarekompatibilität der aktuellen Generation

Das iPhone 15 Pro Autofokus-Problem (GitHub-Issue #260) ist eine echte Überlegung für jedes Team, das einen Barcode-Scanner an iOS-Benutzer liefert. iPhone 15 Pro und Pro Max sind häufig im Verbrauchersegment, das eine polierte Anwendungs-Erfahrung erwartet, und ein Workaround, der von Benutzern verlangt, den Abstand zu einem Barcode anzupassen, ist im Vergleich zu älterer iPhone-Hardware eine auffällige UX-Regression. Teams, die dieses Problem in der QA aufdecken oder Support-Berichte von iPhone 15 Pro-Nutzern erhalten, stehen vor der Entscheidung, auf einer Bibliothek zu bleiben, für die derzeit keine Lösung verfügbar ist, oder zu einem Ansatz zu wechseln, der nicht vom Kamera-Sucher-Fokusmodell betroffen ist.

Datei- und Dokumentenverarbeitung

Die Anforderungen an das Barcode-Scannen beschränken sich selten auf die Live-Kameraaufnahme. Anwendungen, die als Inventarscanner beginnen, werden häufig erweitert und umfassen dann das Lesen von Barcodes aus hochgeladenen PDFs, die Verarbeitung von Versandrechnungen oder die Bearbeitung digitaler Tickets aus E-Mail-Anhängen. ZXing .NET.MAUI verfügt über keine API für diese Szenarien. Wenn eine Produktanforderung im Backlog landet, die das Lesen eines Barcodes aus einer Datei oder einem Dokument beinhaltet, müssen Teams, die ZXing .NET.MAUI verwenden, eine separate Bibliothek einführen, um dies zu handhaben. Wenn das Team IronBarcode bereits für eines dieser dateibasierten Szenarien verwendet, ist die Konsolidierung des MAUI-Kamera-Scannens in dieselbe Bibliothek der logische nächste Schritt.

Anforderungen an die Produktionsstabilität

Die Bezeichnung pre-1.0 bei v0.7.4 — während das Paket selbst eine stabile NuGet-Version ist — hat Auswirkungen auf Teams, die einer Softwarekompositionsanalyse, Abhängigkeitsaudits oder internen Genehmigungsprozessen unterliegen. Einige Unternehmensumgebungen erfordern, dass Produktionsabhängigkeiten eine stabile Version 1.0+ tragen, einen kommerziellen Support-Vertrag oder beides. ZXing.Net.MAUI wird von der Community gepflegt und ist pre-1.0, was sich für interne Tools und Prototypen eignet, jedoch Überprüfungsschritte in kundenorientierten Anwendungen hinzufügt, bei denen der Barcode-Scanner der primäre Workflow ist. Das Fehlen einer bezahlten Support-Stufe bedeutet, dass sich jedes kritische Fehler auf die Verfügbarkeit des Community-Maintainers stützt.

CameraBarcodeReaderView zu MediaPicker-Muster

Das CameraBarcodeReaderView-XAML-Steuerelement und seine xmlns:zxing-Namespace-Deklaration werden vollständig entfernt. In jeder XAML-Datei, die eine Scannansicht beinhaltete, wird diese durch ein Button-Steuerelement ersetzt, das MediaPicker.CapturePhotoAsync() in seinem Clicked-Handler aufruft. Das ereignisgesteuerte Modell — bei dem die Ergebnisse über BarcodesDetected eintreffen — wird ersetzt, indem der Rückgabewert von BarcodeReader.Read() direkt im asynchronen Handler gelesen wird.

Erkennt die Entfernung im Lebenszyklus?

Jede OnAppearing- und OnDisappearing-Überschreibung, die ausschließlich dazu dient, CameraView.IsDetecting umzuschalten, kann gelöscht werden. Wenn diese Überschreibungen andere Seitenlebenszykluslogik enthalten, werden die IsDetecting-Zeilen entfernt und die verbleibende Logik beibehalten. Es gibt kein IronBarcode-Äquivalent zu IsDetecting, da kein anhaltender Kamerazustand zwischen Seitennavigationen verwaltet werden muss.

UseBarcodeReader()-Registrierungsentfernung

ZXing.Net.MAUI erfordert einen einmaligen builder.UseBarcodeReader()-Aufruf in MauiProgram.cs, um seine Plattformkameradienste zu registrieren. IronBarcode erfordert keine MauiProgram.cs-Registrierung. Die UseBarcodeReader()-Zeile wird entfernt, und der using ZXing.Net.Maui;-Namespace-Import, der sie unterstützt, wird zusammen mit der Deinstallation des Pakets entfernt.