.NET MAUI Scanner les BarCodes dans les Apps Windows avec une puissante bibliothèque de scanners de codes-barres

Comment créer une application .NET MAUI pour la lecture de codes-barres?

La configuration d'un projet .NET MAUI dans Visual Studio Code ou Visual Studio est simple ; pour ce tutoriel, nous utiliserons Visual Studio. Lancez Visual Studio 2022 ou une version ultérieure, sélectionnez Créer un nouveau projet et choisissez le modèle .NET MAUI App. Saisissez le nom de votre projet et sélectionnez vos plateformes cibles. Pour ce tutoriel, nous nous concentrons sur le déploiement de Windows.

Contrairement à des solutions telles que Scanbot SDK qui nécessitent une initialisation complexe dans MauiProgram.cs avec des configurations de constructeurs de var et une configuration de prévisualisation de la caméra, IronBarcode ne nécessite pas d'enregistrement particulier. La classe statique publique MauiProgram reste inchangée par rapport au modèle par défaut, ce qui rend l'intégration remarquablement simple pour les applications MAUI .NET.

Pour installer le package NuGet IronBarcode, vous pouvez utiliser la palette de commandes (Ctrl+Shift+P dans VS Code) ou exécuter la commande suivante dans la console du gestionnaire de packages de Visual Studio :

Install-Package BarCode

Cette installation d'un seul paquet NuGet fournit tout ce qui est nécessaire à la numérisation de codes-barres, à la numérisation de codes-barres multiples et à la reconnaissance de codes QR. La dernière version prend en charge tous les principaux formats de BarCode sans dépendances supplémentaires, contrairement aux scanners à caméra qui nécessitent souvent des gestionnaires de permission et des configurations de contrôle CameraView.

Pour utiliser IronBarcode dans un environnement de production, vous devrez appliquer une clé de licence. Vous pouvez définir ce paramètre dans votre MauiProgram.cs ou dans le constructeur App.xaml.cs :

IronBarCode.License.LicenseKey = "YOUR_IRONBARCODE_LICENSE_KEY";

IronBarCode.License.LicenseKey = "YOUR_IRONBARCODE_LICENSE_KEY";

Quelle conception d'interface fonctionne le mieux pour un lecteur de codes-barres MAUI?

Une interface propre et fonctionnelle permet aux utilisateurs de sélectionner un fichier image contenant des BarCodes et de visualiser les résultats de la numérisation. Le XAML suivant crée une interface utilisateur de lecteur de codes-barres simple mais efficace pour votre application .NET MAUI :

<?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 display 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 display here" />
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

Cette mise en page fournit un bouton pour la sélection du fichier image, une zone pour afficher l'image sélectionnée et une étiquette pour les résultats de la détection du code-barres. La conception fonctionne sur toutes les plateformes cibles .NET MAUI tout en maintenant les performances natives sur Windows.

Comment implémenter la détection de BarCode à partir de fichiers images?

Dans votre MainPage.xaml.cs, vous pouvez utiliser des méthodes de cycle de vie telles que async void OnAppearing pour initialiser les paramètres ou vérifier si l'utilisateur a fourni l'accès au fichier nécessaire.

La classe partielle publique MainPage contient la logique d'analyse. La méthode BarcodeReader.Read d'IronBarcode gère toute la complexité de la détection des codes-barres, prenant en charge la numérisation des codes-barres à partir des formats JPEG, PNG, GIF, TIFF et BMP. Voici la mise en œuvre complète :

using IronBarCode;
namespace BarcodeScanner;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImage(object sender, EventArgs e)
    {
        try
        {
            // Open file picker for image selection
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Images,
                PickerTitle = "Select a barcode image"
            });
            if (result != null)
            {
                // Display the selected image
                var stream = await result.OpenReadAsync();
                SelectedImageDisplay.Source = ImageSource.FromStream(() => stream);
                // Read barcodes from the image file
                var barcodes = BarcodeReader.Read(result.FullPath);
                // Display all detected barcode values
                if (barcodes.Count > 0)
                {
                    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 occurred: {ex.Message}";
        }
    }
}

using IronBarCode;
namespace BarcodeScanner;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImage(object sender, EventArgs e)
    {
        try
        {
            // Open file picker for image selection
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Images,
                PickerTitle = "Select a barcode image"
            });
            if (result != null)
            {
                // Display the selected image
                var stream = await result.OpenReadAsync();
                SelectedImageDisplay.Source = ImageSource.FromStream(() => stream);
                // Read barcodes from the image file
                var barcodes = BarcodeReader.Read(result.FullPath);
                // Display all detected barcode values
                if (barcodes.Count > 0)
                {
                    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 occurred: {ex.Message}";
        }
    }
}

private async void ProcessResults(BarcodeResults barcodes)
{
    if (barcodes.Count > 0)
    {
        string msg = $"Found {barcodes.Count} barcodes.";
        // Use await DisplayAlert to show results to the user
        await DisplayAlert("Scan Success", msg, "OK");
    }
    else
    {
        await DisplayAlert("No Results", "No barcodes were found in the image.", "OK");
    }
}

private async void ProcessResults(BarcodeResults barcodes)
{
    if (barcodes.Count > 0)
    {
        string msg = $"Found {barcodes.Count} barcodes.";
        // Use await DisplayAlert to show results to the user
        await DisplayAlert("Scan Success", msg, "OK");
    }
    else
    {
        await DisplayAlert("No Results", "No barcodes were found in the image.", "OK");
    }
}

Comment scanner plusieurs BarCodes et configurer les options de détection?

Lorsque votre fichier image contient plusieurs codes-barres, IronBarcode les détecte tous automatiquement. Pour des performances optimisées lorsque vous connaissez les types de codes-barres attendus, utilisez BarcodeReaderOptions :

using IronBarCode;
// Configure options for scanning multiple barcodes
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};
var barcodes = BarcodeReader.Read(imagePath, options);
// Process each detected barcode
foreach (var barcode in barcodes)
{
    Console.WriteLine($"Found: {barcode.Value}");
}

using IronBarCode;
// Configure options for scanning multiple barcodes
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};
var barcodes = BarcodeReader.Read(imagePath, options);
// Process each detected barcode
foreach (var barcode in barcodes)
{
    Console.WriteLine($"Found: {barcode.Value}");
}

Pourquoi choisir le balayage de codes-barres basé sur l'image?

La lecture de codes-barres basée sur l'image offre des avantages distincts pour le développement de codes-barres .NET MAUI scan. Alors que Scanbot SDK et d'autres outils similaires se concentrent sur la fonctionnalité de prévisualisation en direct de la caméra, l'approche d'IronBarcode offre une intégration plus directe, un comportement cohérent sur toutes les plateformes et la possibilité de traiter des fichiers d'images existants à partir de n'importe quelle source, y compris des documents numérisés, des pièces jointes à des courriels ou des téléchargements d'utilisateurs.

Pour les déploiements Android et iOS, le même code fonctionne sans modification, aucune autorisation de caméra ou configuration spécifique à la plateforme n'est requise.

Conclusion

La construction d'un lecteur de codes-barres .NET MAUI avec IronBarcode nécessite un minimum de code tout en offrant des capacités de détection de codes-barres robustes. L'approche basée sur les fichiers d'images simplifie le développement en éliminant les autorisations des caméras, les configurations spécifiques aux appareils et l'initialisation complexe. Vous vous concentrez sur la logique de votre application tandis qu'IronBarcode se charge de la numérisation.

La documentation API complète couvre des fonctionnalités supplémentaires, notamment la lecture de codes-barres PDF, le traitement par lots et les filtres d'image avancés. Prêt à mettre en œuvre la lecture de codes-barres dans votre projet .NET MAUI multiplateforme ? Achetez une licence pour une utilisation en production, ou explorez l'ensemble des fonctionnalités avec un essai gratuit.

Commencez avec IronBarcode maintenant.

Commencer gratuitement