.NET MAUI BarCode Scanner SDK: Erstellen Sie einen plattformübergreifenden Scanner in wenigen Minuten

Erstellen Sie das .NET MAUI-Projekt

Öffnen Sie Visual Studio und erstellen Sie ein neues .NET MAUI App-Projekt. Benennen Sie Ihr MAUI-Projekt mit einem aussagekräftigen Namen wie "BarcodeScanner" und wählen Sie .NET 8 oder höher als Ziel-Framework. Visual Studio generiert die Standard-Projektstruktur mit plattformspezifischen Ordnern für Android und iOS.

IronBarcode installieren

Installieren Sie das IronBarcode NuGet-Paket über die Paketverwaltungskonsole:

Install-Package BarCode

Mit diesem Befehl wird das Barcodescanner-SDK zusammen mit allen erforderlichen Abhängigkeiten für Ihre .NET MAUI-Anwendung heruntergeladen und installiert.

Plattform-Berechtigungen konfigurieren

Auch wenn Sie von Bilddateien und nicht von einer Live-Kamera scannen, empfiehlt es sich, die folgenden Berechtigungen für Ihre .NET MAUI Barcode-Scanner-App zu konfigurieren.

Für Android fügen Sie Folgendes zu Platforms/Android/AndroidManifest.xml hinzu:

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

Für iOS fügen Sie diese Einträge zu Platforms/iOS/Info.plist hinzu:

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

Initialisierung des SDK

Konfigurieren Sie IronBarcode in Ihrer MauiProgram.cs-Datei:

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });
        return builder.Build();
    }
}

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });
        return builder.Build();
    }
}

Setzen Sie Ihren Lizenzschlüssel in den Initialisierungscode Ihrer Anwendung, um die volle Funktionalität zu aktivieren. IronBarcode bietet eine kostenlose Testlizenz für die Entwicklung und den Test an.

Gestaltung der Benutzeroberfläche

Erstellen Sie eine saubere Schnittstelle in MainPage.xaml, die es Benutzern ermöglicht, eine Bilddatei auszuwählen und die gescannten Barcodedaten anzuzeigen:

<?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">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</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">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

Einführung von BarCode-Scanning

Fügen Sie die Scan-Logik zu MainPage.xaml.cs hinzu. Dieser Code behandelt die Bildauswahl und die Barcode-Erkennung:

using IronBarCode;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });
        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);
            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);
            if (barcodes.Any())
            {
                ResultLabel.Text = $"Found: {barcodes.First().Value}";
            }
            else
            {
                ResultLabel.Text = "No barcodes detected in selected image.";
            }
        }
    }
}

using IronBarCode;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });
        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);
            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);
            if (barcodes.Any())
            {
                ResultLabel.Text = $"Found: {barcodes.First().Value}";
            }
            else
            {
                ResultLabel.Text = "No barcodes detected in selected image.";
            }
        }
    }
}

Ausgabe

Die Methode BarcodeReader.Read() analysiert das ausgewählte Bild und gibt alle erkannten Barcodes zurück. IronBarcode erkennt automatisch mehrere Barcode-Symbologien, darunter QR-Codes, Code 128, Code 39, EAN-13 und viele andere Formate.

Ausgabe

Die Methode ReadPdf() scannt alle Seiten einer PDF-Datei und gibt die Barcodedaten zusammen mit den Seitenzahlen zurück, was die Verarbeitung von Dokumenten mit mehreren Barcodes erleichtert.