.NET MAUI Barcode Scanner SDK : Créer un scanner multiplateforme en quelques minutes

Créer le projet .NET MAUI

Ouvrez Visual Studio et créez un nouveau projet .NET MAUI App. Donnez à votre projet MAUI un nom descriptif comme "BarcodeScanner" et sélectionnez .NET 8 ou une version ultérieure comme cadre de travail cible. Visual Studio génère la structure de projet par défaut avec des dossiers spécifiques à la plateforme pour Android et iOS.

Installer IronBarcode

Installez le package NuGet IronBarcode à l'aide de la console de gestion des packages :

Install-Package BarCode

Cette commande télécharge et installe le SDK du lecteur de codes-barres ainsi que toutes les dépendances requises pour votre application .NET MAUI.

Configurer les autorisations de la plateforme

Même lorsque vous numérisez à partir de fichiers d'images plutôt que d'une caméra en direct, il est bon de configurer les autorisations suivantes pour votre application de lecteur de codes-barres .NET MAUI.

Pour Android, ajoutez ce qui suit à Platforms/Android/AndroidManifest.xml :

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

Pour iOS, ajoutez ces entrées à Platforms/iOS/Info.plist :

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

Initialiser le SDK

Configurez IronBarcode dans votre fichier MauiProgram.cs :

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();
    }
}

Définissez votre clé de licence dans le code d'initialisation de votre application afin d'en activer toutes les fonctionnalités. IronBarcode propose une licence d'essai gratuite pour le développement et les tests.

Conception de l'interface utilisateur

Créez une interface propre dans MainPage.xaml qui permet aux utilisateurs de sélectionner un fichier image et de visualiser les données du code-barres scanné :

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

Mettre en œuvre la lecture de codes-barres

Ajoutez la logique d'analyse à MainPage.xaml.cs. Ce code gère la sélection des images et la détection des codes-barres :

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.";
            }
        }
    }
}

Sortie

La méthode BarcodeReader.Read() analyse l'image sélectionnée et renvoie tous les codes-barres détectés. IronBarcode reconnaît automatiquement plusieurs symbologies de codes-barres, notamment les codes QR, le Code 128, le Code 39, l'EAN-13 et beaucoup d'autres formats.

Sortie

La méthode ReadPdf() scanne toutes les pages d'un PDF et renvoie les données des codes-barres avec les numéros de page, ce qui facilite le traitement des documents contenant plusieurs codes-barres.