Modèle de balayage de la caméra en direct

L'API BarcodeScanning.Native.Maui complète est un contrôle XAML associé à un gestionnaire d'événements C# :

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

Cette commande offre aux utilisateurs un viseur en temps réel intégré à la page MAUI. La détection de codes-barres est continue tant que le flux de la caméra est actif. L'UX est bien conçue pour les applications grand public où " pointer et scanner " est l'interaction principale. La contrainte est que c'est la seule interaction que la bibliothèque prend en charge — les exigences qui vont au-delà de la détection de caméra en direct dans un contexte MAUI tombent hors de son champ.

Comparaison détaillée des fonctionnalités

Approche de lecture de codes-barres MAUI

BarcodeScanning.Native.Maui encapsule le pipeline de détection de caméra natif sur chaque plateforme. Sur Android, le Kit ML traite des cadres ; sur iOS et macOS, le framework Vision d'Apple traite les cadres ; sur Windows, ZXingCpp traite les cadres. La bibliothèque expose cela comme un contrôle MAUI CameraView avec un événement OnDetectionFinished. Le code de l'application ne traite jamais directement les octets de l'image ; il ne traite que les valeurs de code-barres détectées qui émergent de l'événement.

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

Cette conception a pour conséquence qu'il n'existe aucun autre point d'entrée. La caméra n'est pas optionnelle — c'est la seule entrée que la bibliothèque connaît. Un serveur, un fichier, un PDF, ou un hôte non-MAUI n'a aucun chemin vers la bibliothèque.

Approche IronBarcode

IronBarcode reçoit des données d'image via sa méthode statique BarcodeReader.Read(). L'appelant fournit les données — provenant de n'importe quelle source — et la bibliothèque les décode. Sur MAUI, les données proviennent de MediaPicker; Sur un serveur, cela provient du téléchargement d'un formulaire ; Dans une application de bureau, cela provient d'une boîte de dialogue de fichier.

// Code-barres IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

// Code-barres IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

Imports IronBarCode
Imports System.IO

' Code-barres IronBarcode in MAUI: capture a photo, then read barcodes from it
' NuGet: dotnet add package IronBarcode

Private Async Sub ScanBarcodeButton_Clicked(sender As Object, e As EventArgs)
    Dim photo = Await MediaPicker.CapturePhotoAsync()
    If photo Is Nothing Then Return

    Using stream = Await photo.OpenReadAsync()
        Using ms As New MemoryStream()
            Await stream.CopyToAsync(ms)

            Dim results = BarcodeReader.Read(ms.ToArray())
            For Each result In results
                ResultLabel.Text = result.Value
            Next
        End Using
    End Using
End Sub

Ce code s'exécute de manière identique sur les cibles MAUI qui peuvent capturer une image. Pour une utilisation côté serveur, la même méthode BarcodeReader.Read() accepte un tableau d'octets du fichier téléchargé ou un chemin PDF. La documentation IronBarcode couvre tous les types d'entrée pris en charge.

Approche de lecture de codes-barres MAUI

BarcodeScanning.Native.Maui prend en charge les quatre cibles MAUI (iOS, Android, Windows depuis 3.0.1, et macOS Catalyst), mais chaque cible utilise un moteur de reconnaissance différent : Vision d'Apple sur iOS et macOS, Google ML Kit sur Android, et ZXingCpp sur Windows. La couverture de symbologie et le comportement de décodage diffèrent à travers les trois moteurs, donc un code-barres qui se décode de manière fiable sur une plateforme peut se comporter différemment sur une autre. En dehors de MAUI — ASP.NET, console, WPF, WinForms, Blazor Server, Azure Functions — la bibliothèque n'a pas d'implémentation. Les équipes qui ont besoin de logique de code-barres à la fois dans une application MAUI et dans un service backend doivent utiliser une bibliothèque différente pour le code non-MAUI.

Approche IronBarcode

L'appel BarcodeReader.Read() de Code-barres IronBarcode utilise le même moteur géré sur chaque cible prise en charge, donc le comportement est cohérent sur Windows, Linux, macOS, ASP.NET, et toute cible MAUI qui peut capturer une image et la transmettre au lecteur. Il n'y a pas de blocs #if WINDOWS, pas de chargement conditionnel de dépendances, et pas de mises en œuvre de stubs nécessaires. Pour les fichiers et les PDF, le modèle est également cohérent :

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

Imports IronBarCode

' Read barcodes from a file the user selected
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim results = BarcodeReader.Read(file.FullPath)
    For Each result In results
        Console.WriteLine($"{result.Format}: {result.Value}")
    Next
End If

' Read barcodes directly from a PDF — no image extraction step needed
Dim pdfResults = BarcodeReader.Read("shipment-manifest.pdf")

Le guide d'intégration Code-barres IronBarcode MAUI fournit des instructions de configuration complètes pour toutes les cibles MAUI. Code-barres IronBarcode prend également en charge le déploiement côté serveur dans les environnements ASP.NET, Docker, Azure Functions et AWS Lambda où BarcodeScanning.Native.Maui n'a aucun chemin d'accès.

Approche de lecture de codes-barres MAUI

Sur iOS, la détection sous-jacente de BarcodeScanning.Native.Maui (Vision d'Apple) peut retourner 13 chiffres pour les codes-barres UPC-A. Le code UPC-A est un format à 12 chiffres ; Le zéro supplémentaire en tête correspond à l'encodage EAN-13. La bibliothèque transmet cette valeur brute, et les applications la normalisent au besoin. Les applications qui stockent des valeurs UPC-A dans une base de données sans normalisation peuvent accumuler des enregistrements avec un zéro initial.

La solution documentée vérifie le format et coupe la valeur :

// Normalize iOS UPC-A — strip the leading zero when present
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormats.Upca && value.Length == 13)
        value = value.Substring(1);

    ProcessBarcode(value);
}

// Normalize iOS UPC-A — strip the leading zero when present
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormats.Upca && value.Length == 13)
        value = value.Substring(1);

    ProcessBarcode(value);
}

' Normalize iOS UPC-A — strip the leading zero when present
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormats.Upca AndAlso value.Length = 13 Then
        value = value.Substring(1)
    End If

    ProcessBarcode(value)
End Sub

La vérification du format est nécessaire pour que les valeurs EAN-13 commençant par 0 ne soient pas coupées par erreur. PDF417 est documenté séparément dans les discussions GitHub comme "très problématique — la plupart des scans ne se produisent jamais" sur les moteurs iOS/Android, ce qui est pertinent pour les étiquettes d'expédition, les permis de conduire et les cartes d'embarquement.

Approche IronBarcode

IronBarcode renvoie la valeur standard UPC-A à 12 chiffres via son moteur géré. PDF417 est un format pris en charge. La partie génération est également disponible via l'API d'IronBarcode :

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

' Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

Pour les applications où la précision des données de codes-barres affecte directement les recherches d'inventaire, les transactions au point de vente ou les intégrations de chaînes d'approvisionnement, la gestion cohérente des formats d'IronBarcode réduit le besoin de normalisation spécifique à la plateforme. La documentation de lecture des codes-barres IronBarcode décrit en détail le comportement spécifique à chaque format.

La cohérence des moteurs multiplateformes devient une exigence

Les applications MAUI visant iOS, Android, Windows et macOS incorporent trois moteurs de reconnaissance différents lorsqu'elles utilisent BarcodeScanning.Native.Maui : Apple Vision (iOS/macOS), Google ML Kit (Android) et ZXingCpp (Windows). Chaque moteur a sa propre couverture de la symbologie et son comportement de décodage, de sorte que le même code-barres peut être décodé différemment sur les plateformes — et les applications ajoutent souvent des couches de normalisation pour masquer les différences. Quand cette charge de maintenance augmente, ou lorsque les rapports de QA indiquent des régressions multiplateformes liées aux différences de moteurs, les équipes migrent parfois la couche de code-barres vers un seul moteur géré qui se comporte de la même manière sur chaque cible.

Ajout d'exigences relatives au téléchargement de fichiers ou au traitement de PDF

Les applications mobiles commencent souvent par utiliser la numérisation en direct par caméra comme unique méthode de saisie, puis s'étendent pour accepter les images ou documents téléchargés. Quand un utilisateur doit scanner un code-barres à partir d'une photo dans sa galerie, d'une image reçue par email, ou d'un PDF contenant des manifestes d'expédition ou des cartes d'embarquement, BarcodeScanning.Native.Maui n'a pas de chemin de code pour ces entrées. Les équipes qui atteignent cette limite d'exigence font face à un choix : ajouter une deuxième bibliothèque de codes-barres aux côtés de BarcodeScanning.Native.Maui pour les entrées de fichiers et PDF, ou migrer vers une seule bibliothèque qui gère tous les types d'entrée. Gérer deux packages de codes-barres avec des API et types de résultats différents ajoute de la complexité à long terme qu'une solution à package unique évite.

Introduction du traitement des codes-barres côté serveur

Les applications qui scannent les codes-barres sur mobile développent souvent un composant côté serveur : un point de terminaison d'API ASP.NET qui valide les codes-barres, une tâche en arrière-plan qui traite les PDF ou une fonction cloud qui extrait les numéros de suivi des documents téléchargés. BarcodeScanning.Native.Maui est une bibliothèque de contrôle d'interface utilisateur MAUI ; elle n'a pas d'implémentation côté serveur. Une équipe qui a besoin de la même logique de lecture de codes-barres côté mobile et côté serveur doit utiliser une bibliothèque différente pour le serveur. Lorsque les besoins côté serveur se font sentir, les équipes évaluent souvent s'il est préférable de centraliser la gestion des codes-barres dans une bibliothèque unique couvrant à la fois le mobile et le serveur, plutôt que de maintenir deux implémentations distinctes.

UPC-A Normalisation des données devient une préoccupation

Le comportement des codes UPC-A à 13 chiffres d'iOS n'est pas toujours détecté lors du développement. Les codes-barres UPC-A scannés en développement peuvent sembler fonctionner correctement, mais le zéro initial du cadre Vision d'Apple peut apparaître dans la base de données en l'absence de normalisation. Les équipes qui découvrent des valeurs UPC-A à 13 chiffres dans les enregistrements d'inventaire, les systèmes de point de vente ou les intégrations de chaîne d'approvisionnement peuvent nécessiter à la fois une correction de code et une étape de correction de données. L'ajout de la normalisation documentée gère les nouveaux scans ; migrer vers une bibliothèque avec une sortie UPC-A cohérente est parfois préféré comme solution à long terme.

Numérisation de documents PDF417 requise

Le format PDF417 est le format de code-barres utilisé sur les étiquettes d'expédition, les permis de conduire et les cartes d'embarquement en Amérique du Nord. Ce sont des cibles de numérisation courantes pour les applications logistiques, de vérification d'identité et de voyage. Le traqueur de problèmes GitHub de BarcodeScanning.Native.Maui documente PDF417 comme "très problématique — la plupart des scans ne se produisent jamais" sur les moteurs iOS/Android. Pour les applications où la fiabilité de PDF417 est une exigence fonctionnelle, les équipes évaluent souvent des bibliothèques alternatives.

Événement de caméra vers MediaPicker et lecture statique

Le changement structurel principal dans la migration consiste à remplacer le modèle d'événement de caméra continue par une capture MediaPicker suivie de BarcodeReader.Read(). Le gestionnaire d'événements OnDetectionFinished, le contrôle XAML CameraView, et la déclaration d'espace de noms XML scanner: sont tous supprimés. À leur place, un bouton déclenche MediaPicker.CapturePhotoAsync(), et les octets de la photo résultante sont transmis à BarcodeReader.Read(). Cela modifie l'expérience utilisateur, passant d'un viseur continu en direct à un écran de caméra système — ce qui convient à la plupart des applications professionnelles.

Modifications du marshaling des threads

BarcodeScanning.Native.Maui déclenche OnDetectionFinished sur un thread en arrière-plan, donc tous les gestionnaires existants qui mettent à jour des éléments UI emballent leurs mises à jour dans MainThread.BeginInvokeOnMainThread(). Avec le modèle MediaPicker + async utilisé par IronBarcode, la continuation après await revient sur le contexte appelant, qui est généralement le thread principal. Dans la plupart des cas, les encapsulations MainThread.BeginInvokeOnMainThread() peuvent être supprimées, simplifiant ainsi le code du gestionnaire d'événements.

Suppressions de l'Normalisation UPC-A

Tout code source qui a géré le comportement à 13 chiffres UPC-A d'iOS BarcodeScanning.Native.Maui aura un code qui vérifie BarcodeFormats.Upca et appelle Substring(1) pour retirer le zéro initial. Ce code doit être supprimé après la migration — Code-barres IronBarcode renvoie la valeur standard à 12 chiffres, et laisser la normalisation en place entraînerait la suppression incorrecte du premier chiffre des lectures UPC-A valides.

Autorisations MAUI

BarcodeScanning.Native.Maui ajoute automatiquement les permissions de caméra aux manifestes Android et iOS dans le cadre de sa configuration de package. Avec Code-barres IronBarcode utilisant MediaPicker, les permissions standard de caméra MAUI dans AndroidManifest.xml et Info.plist sont requises — les mêmes permissions que toute application MAUI nécessite pour MediaPicker.CapturePhotoAsync(). Ces autorisations sont généralement déjà présentes dans les projets MAUI qui utilisent la caméra à quelque fin que ce soit.