Comment utiliser .NET MAUI pour le scanner de codes QR ?

Introduction

Avec la montée des applications mobiles exploitant les codes QR pour une récupération rapide d'informations, le besoin d'un scanner de codes QR efficace et facile à intégrer ainsi que d'un scanner de codes-barres .NET MAUI pour scanner les codes-barres grandit. .NET MAUI (Multi-platform App UI), le cadre multiplateforme de Microsoft, offre un environnement unifié pour créer des applications sur iOS, Android, macOS et Windows. Lors de la numérisation des codes QR dans une application .NET MAUI, les développeurs ont besoin d'une bibliothèque intuitive et puissante pour gérer le processus.

IronQR est une bibliothèque populaire qui permet aux développeurs de générer et de décoder des codes QR rapidement, précisément et de manière fiable. Cet article vous guidera dans l'intégration d'IronQR avec .NET MAUI pour construire un scanner QR/Code-barres qui fonctionne parfaitement sur plusieurs plateformes.

Comment implémenter la numérisation de code-barres QR avec IronQR

1. Créer un projet .NET MAUI.

2. Installez le package NuGet IronQR.

3. Configurer les autorisations pour la caméra et le stockage des fichiers.

4. Mise en œuvre du scanner de code QR.

Introduction à IronQR pour les applications mobiles .NET MAUI

IronQR est une bibliothèque puissante et facile à utiliser qui simplifie la génération et le décodage des codes QR dans les applications .NET, y compris les applications mobiles .NET MAUI pour la fonctionnalité de numérisation de codes QR et de codes-barres. Il offre des solutions rapides et fiables pour intégrer la fonctionnalité de lecture de codes QR et de codes-barres sur des plateformes telles que iOS, Android, macOS et Windows, ce qui est essentiel pour développer des applications mobiles multiplateformes.

Fonctionnalités d'IronQR pour les applications mobiles .NET MAUI

a) Prise en charge multiplateforme : Fonctionne parfaitement sur les plateformes iOS, Android, macOS et Windows au sein des applications MAUI.

b) Scan de QR Code : Décode efficacement divers types de QR Codes (URLs, texte, informations de contact, etc.). Il prend également en charge la lecture de plusieurs codes-barres avec des algorithmes de détection de codes-barres efficaces.

c) Génération de QR Code : Cela permet la génération facile de QR Codes à partir de données telles que des URL, des textes et plus encore.

d) Gestion des autorisations de caméra : Gère automatiquement les demandes d'autorisation de caméra, simplifiant ainsi le processus de numérisation.

e) Haute performance : Scanne et génère des codes QR rapidement et de manière fiable avec une utilisation minimale des ressources.

f) Paramètres personnalisables : Offre des options de personnalisation pour les paramètres de numérisation et l'apparence des codes QR.

g) Intégration facile : API simple et configuration minimale requises pour ajouter la numérisation et la génération de QR Code à votre application .NET MAUI.

h) Gestion des erreurs : Fournit des messages d'erreur détaillés et des solutions de dépannage, garantissant un bon fonctionnement dans divers scénarios.

i) Pas de dépendances externes : IronQR fonctionne de manière indépendante, réduisant le besoin de bibliothèques tierces ou de configurations complexes, contrairement au scanner de codes-barres ZXing.

j) Prise en charge multi-format : Prend en charge plusieurs formats de codes QR, assurant ainsi la compatibilité avec un large éventail de codes QR utilisés dans le monde réel.

Pré-requis

Avant de procéder à la mise en œuvre, assurez-vous d'avoir les prérequis suivants :

1. Visual Studio 2022 ou une version ultérieure installé.

2. SDK .NET 6.0 ou version ultérieure (car .NET MAUI est construit sur .NET 6 et versions ultérieures).

3. IronQR NuGet Package pour le scan de codes QR et la détection de codes-barres.

4. Application .NET MAUI (Vous pouvez créer une nouvelle application MAUI dans Visual Studio si vous n'en avez pas déjà une).

Étape 1 : Créer un projet .NET MAUI

Pour commencer, créons un projet .NET MAUI simple :

1. Ouvrez Visual Studio et cliquez sur Créer un nouveau projet.

2. Sélectionnez le modèle .NET MAUI App.

   

3. Donnez un nom au projet (par exemple, MauiQRCodeScanner), sélectionnez un emplacement, puis cliquez sur Suivant.

   

   \

   Sélectionnez la version .NET requise et cliquez sur Create.

   

Étape 2 : Installez le package NuGet IronQR

IronQR est une bibliothèque tierce qui offre des fonctionnalités de génération et de balayage de codes QR. Pour installer IronQR, vous devez l'ajouter via NuGet :

1. Dans Visual Studio, faites un clic droit sur les Dépendances dans votre Explorateur de solutions.

2. Cliquez sur Gérer les packages NuGet.

3. Dans l'onglet Parcourir, recherchez IronQR et cliquez sur Installer sur le package pertinent (généralement IronQR ou IronQR.Maui si spécifiquement disponible pour MAUI).

4. Acceptez les licences et assurez-vous que la bibliothèque est installée.

   

Étape 3 : Configurer les autorisations pour la caméra et le stockage de fichiers

Pour que votre application puisse scanner les codes QR, vous devrez demander des autorisations de caméra sur les plateformes mobiles (iOS et Android). Voici comment vous pouvez ajouter les autorisations suivantes à l'intérieur. ``

Appareil Android : Dans le fichier AndroidManifest.xml, ajoutez l'autorisation de la caméra :

``

iOS : Dans le fichier Info.plist, ajoutez la description de l'utilisation de la caméra :
<key>NSCameraUsageDescription</key>
<string>Nous avons besoin d'accéder à votre caméra pour scanner des codes QR.</string>

         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

         x:Class="MauiQRCodeScanner.MainPage">

Maintenant, dans le fichier MainPage.xaml.cs, vous allez gérer les autorisations de la caméra et la logique de numérisation du code QR. Voici comment l'implémenter :

```cs
using IronQrCode;
using Microsoft.Maui.Controls;
using Microsoft.Maui.Essentials;

namespace MauiQRCodeScanner;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
    License.LicenseKey = "Your key";
        InitializeComponent();
    }

// OnScanButtonClicked method with object sender as input
    private async void OnScanButtonClicked(object sender, EventArgs e)
    {
        // Check for camera permission for var barcode with clear and valid reason
        var status = await Permissions.RequestAsync<Permissions.Camera>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Permission Denied", "Cannot scan QR codes without camera permission", "OK");
            return;
        }

        // Start scanning QR codes
        try
{
        var images = await FilePicker.Default.PickAsync(new PickOptions
        {
           PickerTitle = "Pick image",
          FileTypes = FilePickerFileType.Images
        });
        var imageSource = images.FullPath.ToString();
        // barcodeImage.Source = imageSource;

        var inputBmp = AnyBitmap.FromFile(imageSource);
        // Load the asset into QrImageInput
        QrImageInput imageInput = new QrImageInput(inputBmp);

        // Create a QR Reader object
        QrReader reader = new QrReader();

        // Read the input and get all embedded QR Codes
        IEnumerable<QrResult> results = reader.Read(imageInput);

        if (results.Any())
        {
            resultLabel.Text = "Scanned Text: " + results.First().Value; 
            // Display the result
        }
        else
        {
            resultLabel.Text = "No QR code detected";
        }
    }
    catch (Exception ex)
    {
           resultLabel.Text = "Error: " + ex.Message;
    }
    }
}

License.LicenseKey = "Your License";