Wie entwickelt man einen .NET MAUI Barcode-Scanner in C#?

Wie erstellt man ein .NET MAUI Projekt zum Scannen von Barcodes?

Das Einrichten eines .NET MAUI Projekts in Visual Studio ist unkompliziert. Starten Sie Visual Studio 2022 oder höher, wählen Sie "Neues Projekt erstellen" , wählen Sie die Vorlage ".NET MAUI App" , geben Sie Ihren Projektnamen ein und wählen Sie Ihre Zielplattformen aus. Dieses Tutorial konzentriert sich auf die Bereitstellung unter Windows, das gleiche Projekt läuft aber auch unter Android und iOS. .NET MAUI ist Microsofts plattformübergreifendes Framework zum Erstellen nativer mobiler und Desktop-Apps mit C# und XAML aus einer einzigen gemeinsamen Codebasis.

Im Gegensatz zu kamerabasierten Lösungen wie ZXing .NET.MAUI , die eine CameraView Steuerungseinrichtung und MauiProgram.cs Registrierung erfordern, benötigt IronBarcode keine spezielle Konfiguration. Ihr MauiProgram.cs bleibt im Standardvorlagenzustand. Dadurch bleibt Ihr Startcode frei von Drittanbieter-Handler-Registrierungen und die Angriffsfläche für Initialisierungsfehler beim Start wird verringert.

Um IronBarcode zu installieren, führen Sie folgenden Befehl in der Paket-Manager-Konsole aus:

Install-Package BarCode

Install-Package BarCode

Dieses Komplettpaket bietet Ihnen Barcode-Scanning, QR-Code-Erkennung, Multi-Barcode-Erkennung und Barcode-Generierung. Es sind keine zusätzlichen Abhängigkeiten erforderlich.

Um IronBarcode in der Produktion zu aktivieren, geben Sie Ihren Lizenzschlüssel in App.xaml.cs oder MauiProgram.cs ein:

IronBarCode.License.LicenseKey = "YOUR_IRONBARCODE_LICENSE_KEY";

IronBarCode.License.LicenseKey = "YOUR_IRONBARCODE_LICENSE_KEY";

Sie können einen Lizenzschlüssel auf derIronBarcode -Lizenzseite erhalten oder mit einer kostenlosen Testlizenz beginnen.

Welche XAML-Schnittstelle eignet sich am besten für einen MAUI-Barcodescanner?

Eine minimalistische Benutzeroberfläche – bestehend aus einer Schaltfläche zur Bildauswahl, einem Bildanzeigebereich und einer Ergebnisbezeichnung – deckt die meisten Barcode-Scan-Szenarien ab. Das folgende XAML erstellt dieses Layout für eine .NET MAUI 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">
    <ScrollView>
        <VerticalStackLayout Spacing="20" Padding="30">
            <Label Text="MAUI Barcode Scanner"
                   FontSize="24"
                   HorizontalOptions="Center" />
            <Button x:Name="SelectImageBtn"
                    Text="Select Image File"
                    Clicked="OnSelectImage" />
            <Image x:Name="SelectedImageDisplay"
                   HeightRequest="250" />
            <Label x:Name="ResultsLabel"
                   Text="Barcode results will appear here" />
        </VerticalStackLayout>
    </ScrollView>
</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">
    <ScrollView>
        <VerticalStackLayout Spacing="20" Padding="30">
            <Label Text="MAUI Barcode Scanner"
                   FontSize="24"
                   HorizontalOptions="Center" />
            <Button x:Name="SelectImageBtn"
                    Text="Select Image File"
                    Clicked="OnSelectImage" />
            <Image x:Name="SelectedImageDisplay"
                   HeightRequest="250" />
            <Label x:Name="ResultsLabel"
                   Text="Barcode results will appear here" />
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

Das Layout bietet eine Schaltfläche zum Aufrufen der Dateiauswahl, einen Anzeigebereich für das ausgewählte Bild und eine Beschriftung für die dekodierten Barcode-Werte. Es wird auf allen .NET MAUI Zielplattformen ohne plattformspezifische Anpassungen korrekt dargestellt.

Für Produktionsanwendungen sollten Sie ResultsLabel durch CollectionView ersetzen, um mehrere Barcode-Ergebnisse in einer scrollbaren Liste anzuzeigen, insbesondere beim Scannen von Dokumenten, die mehr als einen Barcode enthalten.

Wie scannt man Barcodes aus Bilddateien in .NET MAUI?

Der Code-Behind in MainPage.xaml.cs übernimmt die Bildauswahl und das Einlesen des Barcodes. BarcodeReader.Read akzeptiert einen Dateipfad und gibt eine BarcodeResults Sammlung zurück. Jeder Artikel in der Sammlung enthält den Barcode Value, BarcodeType und die Positionskoordinaten.

Hier ist die vollständige Implementierung:

using IronBarCode;
namespace BarcodeScanner;

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

    private async void OnSelectImage(object sender, EventArgs e)
    {
        try
        {
            // Open the system file picker filtered to image types
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Images,
                PickerTitle = "Select a barcode image"
            });

            if (result != null)
            {
                // Display the selected image in the UI
                var stream = await result.OpenReadAsync();
                SelectedImageDisplay.Source = ImageSource.FromStream(() => stream);

                // Decode all barcodes found in the image
                var barcodes = BarcodeReader.Read(result.FullPath);

                if (barcodes.Count > 0)
                {
                    // Build a display string listing each barcode type and value
                    string output = string.Join("\n",
                        barcodes.Select(b => $"{b.BarcodeType}: {b.Value}"));
                    ResultsLabel.Text = output;
                }
                else
                {
                    ResultsLabel.Text = "No barcodes detected in image";
                }
            }
        }
        catch (Exception ex)
        {
            ResultsLabel.Text = $"Error: {ex.Message}";
        }
    }
}

using IronBarCode;
namespace BarcodeScanner;

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

    private async void OnSelectImage(object sender, EventArgs e)
    {
        try
        {
            // Open the system file picker filtered to image types
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Images,
                PickerTitle = "Select a barcode image"
            });

            if (result != null)
            {
                // Display the selected image in the UI
                var stream = await result.OpenReadAsync();
                SelectedImageDisplay.Source = ImageSource.FromStream(() => stream);

                // Decode all barcodes found in the image
                var barcodes = BarcodeReader.Read(result.FullPath);

                if (barcodes.Count > 0)
                {
                    // Build a display string listing each barcode type and value
                    string output = string.Join("\n",
                        barcodes.Select(b => $"{b.BarcodeType}: {b.Value}"));
                    ResultsLabel.Text = output;
                }
                else
                {
                    ResultsLabel.Text = "No barcodes detected in image";
                }
            }
        }
        catch (Exception ex)
        {
            ResultsLabel.Text = $"Error: {ex.Message}";
        }
    }
}

BarcodeReader.Read verarbeitet die Datei unter dem angegebenen Pfad, erkennt automatisch alle vorhandenen Barcode-Symbologien und gibt die Ergebnisse sofort zurück. Das Verfahren unterstützt alle gängigen 1D- und 2D-Barcodeformate, einschließlich Code 128, Code 39, QR-Code, Data Matrix, PDF417 und EAN-13.

Der Aufruf FilePicker.PickAsync beschränkt die Dateiauswahl auf Bildtypen, sodass Benutzer nicht versehentlich Nicht-Bilddateien auswählen können. Wenn result null ist, hat der Benutzer abgebrochen -- die if (result != null)-Schutzfunktion behandelt dies stillschweigend.

private async void ShowScanSummary(BarcodeResults barcodes)
{
    if (barcodes.Count > 0)
    {
        // Inform the user how many barcodes were detected
        string message = $"Found {barcodes.Count} barcode(s) in the image.";
        await DisplayAlert("Scan Complete", message, "OK");
    }
    else
    {
        await DisplayAlert("No Results", "No barcodes were found in the image.", "OK");
    }
}

private async void ShowScanSummary(BarcodeResults barcodes)
{
    if (barcodes.Count > 0)
    {
        // Inform the user how many barcodes were detected
        string message = $"Found {barcodes.Count} barcode(s) in the image.";
        await DisplayAlert("Scan Complete", message, "OK");
    }
    else
    {
        await DisplayAlert("No Results", "No barcodes were found in the image.", "OK");
    }
}

Wie scannt man mehrere Barcodes und optimiert die Erkennungsgeschwindigkeit?

Wenn ein Bild mehrere Barcodes enthält, erkennt IronBarcode diese standardmäßig alle. Für eine bessere Performance, wenn Sie wissen, welche Formate zu erwarten sind, konfigurieren Sie BarcodeReaderOptions, bevor Sie BarcodeReader.Read aufrufen:

using IronBarCode;

// Target only QR codes and Code 128 for faster detection
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;

// Target only QR codes and Code 128 for faster detection
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}");
}

Die Eigenschaft ExpectBarcodeTypes beschränkt die Erkennungs-Engine auf die angegebenen Symbologien. Die Einstellung Speed auf ReadingSpeed.Faster eignet sich für kontrastreiche, unverzerrte Bilder. ReadingSpeed.Detailed wendet zusätzliche Bildkorrekturdurchgänge an und verarbeitet Rotation, Verzerrung und Eingaben mit niedriger Auflösung, was jedoch einen höheren Verarbeitungsaufwand bedeutet.

ExpectMultipleBarcodes = true weist den Leser an, nach dem ersten Treffer mit dem Scannen fortzufahren, anstatt frühzeitig zurückzukehren. Bei Szenarien mit nur einem Barcode spart das Weglassen dieser Option einige Millisekunden bei jedem Scan.

Durch diese Konfiguration eignet sich der Scanner für eine Reihe von Anwendungen: eine Einzelhandels-App zum Einlesen von Produkt-Barcodes, ein Lagertool zur Verarbeitung gedruckter Barcode-Etiketten auf Versandfotos oder ein Dokumenten-Workflow zum Extrahieren von QR-Codes aus hochgeladenen Rechnungen.

Wie gehen Sie mit schwierigen oder qualitativ minderwertigen Bildern um?

Produktionsbilder sind selten makellos. Lagerfotos, die unter grellem Licht aufgenommen wurden, Screenshots aus E-Mail-Clients und gescannte Dokumente weisen alle Rauschen, Kompressionsartefakte und geometrische Verzerrungen auf. IronBarcode stellt ImageFilterCollection zur Verfügung, um Bilder vor der Dekodierung vorzuverarbeiten:

using IronBarCode;
using IronSoftware.Drawing;

// Apply corrections for a low-quality warehouse photo
var options = new BarcodeReaderOptions
{
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f),
        new DenoiseFilter()
    },
    Speed = ReadingSpeed.Detailed
};

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

using IronBarCode;
using IronSoftware.Drawing;

// Apply corrections for a low-quality warehouse photo
var options = new BarcodeReaderOptions
{
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f),
        new DenoiseFilter()
    },
    Speed = ReadingSpeed.Detailed
};

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

SharpenFilter stellt die Kantendefinition aus komprimierten oder unscharfen Aufnahmen wieder her. ContrastFilter hilft bei ungleichmäßiger Beleuchtung. DenoiseFilter reduziert Speckle bei Scans mit niedriger Auflösung. Durch die Kombination dieser Filter mit ReadingSpeed.Detailed werden die Leserate bei schwierigen Inhalten maximiert.

Bei .NET MAUI Apps, die vom Benutzer hochgeladene Bilder aus verschiedenen Quellen akzeptieren, verbessert die Anwendung eines standardmäßig festgelegten konservativen Filters und die Eskalation zu einer aggressiveren Korrektur bei einem zweiten Wiederholungsversuch das Benutzererlebnis, ohne im Normalfall eine sichtbare Latenz zu verursachen. Sie können auch einen Uri oder byte[] direkt an BarcodeReader.Read übergeben, was nützlich ist, wenn das Bild aus einer Netzwerkantwort und nicht aus dem Dateisystem stammt. Weitere Beispiele für Eingabequellen finden Sie in den Anleitungen von IronBarcode .

Warum eignet sich bildbasiertes Scannen for .NET MAUI Anwendungen?

Das Scannen der Live-Kamera über ein CameraView Steuerelement erfordert plattformspezifische Berechtigungen, Lebenszyklusmanagement für die Kameravorschau und die Behandlung von Fokusereignissen. Auf iOS bedeutet dies auch die Konfiguration von AVCaptureSession; auf Android, CameraX. Jede Plattform birgt ihre eigenen Fehlerquellen.

Bildbasiertes Scannen beseitigt diese ganze Problematik. Die IronBarcode -API-Referenz zeigt, dass BarcodeReader.Read einen Dateipfad, ein Stream, ein Bitmap oder ein byte[] akzeptiert – also jede beliebige Darstellung, die Ihre MAUI-App erzeugen kann. Dies bedeutet, dass die gleiche Scanlogik funktioniert, unabhängig davon, ob das Bild von FilePicker, einem Netzwerk-Download, einer in Bitmap gerenderten PDF-Seite oder einem E-Mail-Anhang stammt.

Der Batterieverbrauch ist geringer, da die Kamerahardware ausgeschaltet bleibt. Bei der Live-Vorschau gibt es kein Flimmern der Benutzeroberfläche, und es ist nicht erforderlich, Kamera-Lebenszyklusereignisse beim Anhalten und Fortsetzen der App zu verwalten. Auf Tablets und Desktop-Computern – wo ein Live-Kamerasucher selten sinnvoll ist – ist die bildbasierte Dekodierung die natürliche Standardeinstellung und kein Kompromiss. Benutzer können Dateien aus Cloud-Speichern, lokalen Ordnern oder der Kamerarolle mit demselben FilePicker-Aufruf öffnen, unabhängig vom Gerätetyp.

Bei Arbeitsabläufen, bei denen Benutzer Barcode-Etiketten fotografieren und hochladen – was bei ASP.NET Barcode-Scanner-Webanwendungen üblich ist – funktioniert der gleiche BarcodeReader.Read-Aufruf sowohl auf dem mobilen Client als auch auf dem Server, wodurch die Notwendigkeit entfällt, zwei Scan-Implementierungen zu pflegen.

Was sind Ihre nächsten Schritte?

Die Entwicklung eines .NET MAUI Barcode-Scanners mit IronBarcode erfordert weniger als 30 Zeilen C#-Code. Durch die Verwendung von Bilddateien bleibt Ihre MAUI-Codebasis frei von Kamera-Berechtigungslogik und plattformspezifischer Initialisierung, und der gleiche Scan-Aufruf läuft auf Windows, Android und iOS identisch ab.

Die IronBarcode API-Dokumentation behandelt zusätzliche Funktionen: das Lesen von Barcodes aus PDF-Dokumenten, die Stapelverarbeitung mehrerer Bilder, das Schreiben benutzerdefinierter Bildfilter und das Generieren von Barcodes während des Lesens. Die Funktionsübersicht listet alle unterstützten Symboliken und Formate auf.

Starten Sie eine kostenlose Testphase , um IronBarcode in Ihrem Projekt zu testen, oder erwerben Sie eine Lizenz, wenn Sie bereit für den Produktiveinsatz sind.

Starten Sie jetzt mit IronBarcode.

Jetzt kostenlos starten