BarcodeScanning.MAUI gegenüber IronBarcode: C# Barcode Bibliothek Vergleich

Live-Kamera-Scanmuster

Das gesamte API-Muster BarcodeScanning.Native.Maui ist ein XAML-Steuerelement in Kombination mit einem C#-Ereignishandler:

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

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

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

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

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

Dieses Steuerelement bietet Benutzern einen in die MAUI-Seite integrierten Echtzeit-Sucher. Die Barcode-Erkennung wird kontinuierlich ausgelöst, solange das Kamerabild aktiv ist. Die Benutzerfreundlichkeit ist für Verbraucher-Apps, bei denen das Scannen per Mauszeiger die primäre Interaktionsform ist, wirklich gut. Die Einschränkung besteht darin, dass die Bibliothek nur diese eine Interaktion unterstützt – sobald die Anforderungen über die Live-Kameraerkennung auf iOS oder Android hinausgehen, hat BarcodeScanning.Native.Maui nichts zu bieten.

Detaillierter Funktionsvergleich

Barcode-Scanning.MAUI-Ansatz

BarcodeScanning.Native.Maui kapselt die native Kameraerkennungspipeline auf jeder Plattform. Auf Android verarbeitet ML Kit Frames. Auf iOS verarbeitet Apples Vision-Framework die Frames. Die Bibliothek stellt dies als MAUI CameraView Steuerelement mit einem OnDetectionFinished Ereignis dar. Der Anwendungscode verarbeitet niemals direkt Bildbytes – er verarbeitet ausschließlich die erkannten Barcodewerte, die sich aus dem Ereignis ergeben.

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

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

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

Die Konsequenz dieser Konstruktion ist, dass es keinen anderen Zugangspunkt gibt. Die Kamera ist nicht optional – sie ist die einzige Eingabe, die die Bibliothek kennt. Ein Server, eine Datei, ein PDF, ein Windows-Rechner – keines dieser Elemente verfügt über eine Kamera in dem Sinne, wie sie diese Bibliothek erwartet.

IronBarcode Ansatz

IronBarcode empfängt Bilddaten über seine statische Methode BarcodeReader.Read(). Der Aufrufer liefert die Daten – aus beliebiger Quelle – und die Bibliothek dekodiert sie. Auf MAUI stammen die Daten von MediaPicker; Auf einem Server stammt es aus einem Formular-Upload; Bei einer Desktop-Anwendung stammt es aus einem Dateidialog.

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

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

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

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

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

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

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

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

Imports IronBarCode
Imports System.IO

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

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

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

Dieser Code läuft identisch auf iOS, Android und Windows MAUI. Für die serverseitige Verwendung akzeptiert die gleiche BarcodeReader.Read()-Methode ein Byte-Array einer hochgeladenen Datei oder einen PDF-Pfad. Die IronBarcode Dokumentation umfasst alle unterstützten Eingabetypen.

Barcode-Scanning.MAUI-Ansatz

BarcodeScanning.Native.Maui unterstützt das Windows-Ziel in MAUI nicht. Dies ist keine vorübergehende Lücke – es ist eine strukturelle Folge der Architektur der Bibliothek. Die Bibliothek kapselt native APIs für iOS (Vision-Framework) und Android (ML Kit). Windows bietet keine dieser APIs. Teams, die eine MAUI-Anwendung entwickeln, die auf iOS, Android und Windows abzielt – ein Standard-Multi-Target-Szenario – können BarcodeScanning.Native.Maui nicht als Barcode-Lösung für alle drei Zielplattformen verwenden. Sie müssen entweder plattformspezifischen Code für Windows separat implementieren oder die Bibliothek vollständig ersetzen.

IronBarcode Ansatz

Der BarcodeReader.Read()-Aufruf von IronBarcode funktioniert auf Windows-, iOS-, Android- und macOS-MAUI-Zielen ohne plattformspezifischen Code. Es gibt keine #if WINDOWS Blöcke, kein bedingtes Laden von Abhängigkeiten und es werden keine Stub-Implementierungen benötigt. Auch bei Datei- und PDF-Eingaben ist das Muster einheitlich:

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

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

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

Der IronBarcode MAUI-Integrationsleitfaden enthält vollständige Einrichtungsanweisungen für alle MAUI-Ziele. IronBarcode unterstützt auch die serverseitige Bereitstellung in ASP.NET, Docker-, Azure Functions- und AWS Lambda-Umgebungen, in denen BarcodeScanning.Native.Maui überhaupt keinen Pfad hat.

Barcode-Scanning.MAUI-Ansatz

Auf iOS liefert die zugrundeliegende Erkennung von BarcodeScanning.Native.Maui (Apple Vision) 13 Ziffern für UPC-A-Barcodes. UPC-A ist ein 12-stelliges Format; Die zusätzliche führende Null entspricht der EAN-13-Codierung. Die Bibliothek gibt diesen Rohwert unkorrigiert weiter. Anwendungen, die UPC-A-Werte in einer Datenbank speichern, können Datensätze mit einer führenden Null ansammeln, die dort nicht hingehört.

Die dokumentierte Umgehungslösung erfordert eine Überprüfung des Formats und das Kürzen des Wertes:

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

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

    ProcessBarcode(value);
}

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

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

    ProcessBarcode(value);
}

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

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

    ProcessBarcode(value)
End Sub

Dieser Workaround führt stillschweigend dazu, dass EAN-13-Barcodes, die mit 0 beginnen, nicht mehr funktionieren, wenn die Formatprüfung weggelassen wird. PDF417 wird separat in GitHub -Issues als "sehr problematisch – die meisten Scans finden nie statt" dokumentiert und betrifft Versandetiketten, Führerscheine und Bordkarten.

IronBarcode Ansatz

IronBarcode liefert ohne manuelle Normalisierung den korrekten 12-stelligen UPC-A-Wert. PDF417 ist ein unterstütztes Format, das zuverlässig gelesen werden kann. Die Generierungsseite ist ebenfalls über die API von IronBarcode verfügbar:

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

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

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

Bei Anwendungen, bei denen die Genauigkeit der Barcode-Daten direkten Einfluss auf Bestandsabfragen, Kassentransaktionen oder Lieferkettenintegrationen hat, beseitigt die korrekte Formatverarbeitung von IronBarcode eine Kategorie von Produktionsfehlern, die BarcodeScanning.Native.Maui im ​​Anwendungscode hinterlässt. Die IronBarcode Dokumentation zum Barcode-Lesen beschreibt das formatspezifische Verhalten im Detail.

Windows MAUI-Ziel zum Build hinzugefügt

MAUI-Anwendungen beginnen üblicherweise mit einer iOS- und Android-Zielplattform und fügen später Windows hinzu, wenn die Anwendung ausgereifter ist oder die Anforderungen an die Enterprise steigen. Sobald das Windows-Ziel hinzugefügt wird, wird BarcodeScanning.Native.Maui sofort zum Problem – es gibt keine Windows-Implementierung und auch keine Umgehungslösung innerhalb der Bibliothek. Teams in dieser Situation müssen entweder eine separate Barcode-Implementierung für Windows mit einer anderen Bibliothek pflegen oder die gesamte Barcode-Ebene auf eine Bibliothek migrieren, die auf allen MAUI-Zielen konsistent funktioniert. Der zweite Weg ist betrieblich einfacher und eliminiert den Wartungsaufwand für plattformspezifische Verzweigungen.

Anforderungen für Datei-Upload oder PDF-Verarbeitung hinzugefügt

Mobile Anwendungen beginnen oft mit Live-Kamera-Scannen als einziger Eingabemethode und erweitern sich später um die Möglichkeit, hochgeladene Bilder oder Dokumente zu akzeptieren. Wenn ein Benutzer einen Barcode von einem Foto in seiner Galerie, von einem per E-Mail erhaltenen Bild oder von einer PDF-Datei mit Versandmanifesten oder Bordkarten scannen muss, bietet BarcodeScanning.Native.Maui keinen entsprechenden Codepfad an. Teams, die diese Anforderungsgrenze erreichen, stehen vor der Wahl: Entweder sie fügen neben BarcodeScanning.Native.Maui eine zweite Barcode-Bibliothek für Datei- und PDF-Eingaben hinzu oder sie migrieren zu einer einzigen Bibliothek, die alle Eingabetypen verarbeitet. Die Verwaltung zweier Barcode-Pakete mit unterschiedlichen APIs, Ergebnistypen und Formatunterstützungstabellen führt langfristig zu einer höheren Komplexität, die eine Lösung mit nur einem Paket vermeidet.

Einführung der serverseitigen Barcode-Verarbeitung

Anwendungen, die Barcodes auf Mobilgeräten scannen, entwickeln häufig eine serverseitige Komponente – einen ASP.NET -API-Endpunkt, der Barcodes validiert, einen Hintergrundprozess, der PDFs verarbeitet, oder eine Cloud-Funktion, die Trackingnummern aus hochgeladenen Dokumenten extrahiert. BarcodeScanning.Native.Maui ist eine UI-Steuerelementbibliothek, die von einem Kamerahardwarekontext abhängt; Es kann nicht in einem Serverprozess ausgeführt werden. Ein Team, das dieselbe Barcode-Leselogik sowohl auf Mobilgeräten als auch auf Servern benötigt, muss für die Serverseite eine andere Bibliothek verwenden. Sobald diese Serveranforderung gestellt wird, prüfen Teams häufig, ob die Konsolidierung auf eine einzige Bibliothek, die sowohl Mobilgeräte als auch Server abdeckt, der Pflege zweier separater Implementierungen vorzuziehen ist.

Die Genauigkeit der UPC-A-Daten wird zum Produktionsproblem

Das 13-stellige Verhalten des iOS UPC-A wird während der Entwicklung nicht immer erkannt. UPC-A-Barcodes, die während der Entwicklung gescannt werden, scheinen möglicherweise korrekt zu funktionieren, aber die führende Null, die vom Vision-Framework von Apple eingeführt wird, erscheint in der Datenbank. Teams, die 13-stellige UPC-A-Werte in Bestandsdatensätzen, Kassensystemen oder Lieferkettenintegrationen entdecken, stehen neben einem Codeproblem auch vor einem Datenkorrekturproblem. Der in den GitHub -Issues von BarcodeScanning.Native.Maui dokumentierte Workaround korrigiert zwar neue Scans, aber nicht die historischen Daten. Wenn das Ausmaß des Datenqualitätsproblems deutlich wird, ist die Migration zu einer Bibliothek, die korrekte UPC-A-Werte ohne Normalisierung auf Anwendungsebene zurückgibt, oft die sauberere langfristige Lösung.

PDF417 Dokumentenscannen erforderlich

PDF417 ist das Barcode-Format, das in Nordamerika für Versandetiketten, Führerscheine und Bordkarten verwendet wird. Dies sind gängige Scanziele für Logistik-, Identitätsprüfungs- und Reiseanwendungen. Der GitHub -Issue-Tracker von BarcodeScanning.Native.Maui dokumentiert PDF417 als "sehr problematisch – die meisten Scans werden gar nicht erst durchgeführt". Für jede Anwendung, bei der die Zuverlässigkeit von PDF417 eine funktionale Voraussetzung und nicht nur ein nettes Extra ist, stellt dieses bekannte Problem ein direktes Hindernis dar und zwingt zur Evaluierung alternativer Bibliotheken.

Kameraereignis an MediaPicker und statisches Lesen

Die zentrale strukturelle Veränderung bei der Migration besteht darin, das kontinuierliche Kameraereignismuster durch eine MediaPicker-Aufnahme gefolgt von BarcodeReader.Read() zu ersetzen. Der Ereignishandler OnDetectionFinished, das XAML-Steuerelement CameraView und die XML-Namensraumdeklaration scanner: wurden alle entfernt. Stattdessen wird über einen Knopf MediaPicker.CapturePhotoAsync() ausgelöst, und die resultierenden Fotobytes werden an BarcodeReader.Read() weitergeleitet. Dadurch ändert sich das Benutzererlebnis von einem kontinuierlichen Live-Sucher zu einem Systemkamerabildschirm – was für die meisten Geschäftsanwendungen geeignet ist.

Änderungen am Thread-Marshalling

BarcodeScanning.Native.Maui löst OnDetectionFinished in einem Hintergrundthread aus, daher müssen alle vorhandenen Handler, die UI-Elemente aktualisieren, ihre Aktualisierungen in MainThread.BeginInvokeOnMainThread() einbetten. Bei dem von IronBarcode verwendeten MediaPicker + async-Muster kehrt die Fortsetzung nach await im aufrufenden Kontext zurück, in der Regel im Hauptthread. In den meisten Fällen können die MainThread.BeginInvokeOnMainThread() Wrapper entfernt werden, wodurch der Ereignisbehandlungscode vereinfacht wird.

UPC-A-Umgehungslösung

Jede Codebasis, die das 13-stellige Verhalten von BarcodeScanning.Native.Maui für iOS UPC-A verarbeitet, enthält Code, der BarcodeFormat.UPC_A prüft und Substring(1) aufruft, um die führende Null zu entfernen. Dieser Code muss nach der Migration gelöscht werden – IronBarcode gibt den korrekten 12-stelligen Wert zurück, und das Beibehalten des Workarounds würde fälschlicherweise die erste Ziffer von gültigen UPC-A-Lesungen entfernen.

MAUI-Berechtigungen

BarcodeScanning.Native.Maui fügt im Rahmen der Paketkonfiguration automatisch Kameraberechtigungen zu den Manifestdateien für Android und iOS hinzu. Bei Verwendung von MediaPicker durch IronBarcode sind die standardmäßigen MAUI-Kameraberechtigungen in AndroidManifest.xml und Info.plist erforderlich – dieselben Berechtigungen, die jede MAUI-App für MediaPicker.CapturePhotoAsync() benötigt. Diese Berechtigungen sind in MAUI-Projekten, die die Kamera für irgendeinen Zweck verwenden, in der Regel bereits vorhanden.