BarcodeScanning.MAUI vs IronBarcode : Comparaison de la bibliothèque BarCode C#

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, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

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

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    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 des codes-barres est continue tant que le flux vidéo de la caméra est actif. L'expérience utilisateur est vraiment réussie pour les applications grand public où le " pointer et scanner " est l'interaction principale. La limitation est que c'est la seule interaction prise en charge par la bibliothèque ; dès que les exigences dépassent la détection en direct par caméra sur iOS ou Android, BarcodeScanning.Native.Maui n'a plus rien à offrir.

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, ML Kit traite les trames. Sur iOS, le framework Vision d'Apple traite les images. La bibliothèque se présente sous la forme d'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, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

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

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    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, un ordinateur Windows — aucun de ces éléments ne possède de caméra au sens où cette bibliothèque l'entend.

Approche IronBarcode

IronBarcode reçoit des données d'image par le biais de 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 fonctionne de manière identique sur iOS, Android et Windows MAUI. Pour une utilisation côté serveur, la même méthode BarcodeReader.Read()@ accepte le tableau d'octets d'un fichier téléchargé ou un chemin d'accès à un PDF. La documentation IronBarcode couvre tous les types d'entrée pris en charge.

Approche de lecture de codes-barres MAUI

BarcodeScanning.Native.Maui ne prend pas en charge la cible Windows dans MAUI. Il ne s'agit pas d'un problème temporaire, mais d'une conséquence structurelle de l'architecture de la bibliothèque. Cette bibliothèque encapsule les API natives spécifiques à iOS (framework Vision) et à Android (ML Kit). Windows ne dispose d'aucune des deux. Les équipes développant une application MAUI ciblant iOS, Android et Windows — un scénario multi-cible standard — ne peuvent pas utiliser BarcodeScanning.Native.Maui comme solution de code-barres pour les trois cibles. Ils doivent soit implémenter séparément un code spécifique à la plateforme Windows, soit remplacer entièrement la bibliothèque.

Approche IronBarcode

L'appel BarcodeReader.Read() d'IronBarcode fonctionne sur les cibles Windows, iOS, Android et macOS MAUIsans aucun code spécifique à la plateforme. Il n'y a pas de blocs #if WINDOWS, pas de chargement conditionnel de dépendances et pas d'implémentation de stub nécessaire. 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 (Apple Vision) renvoie 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 sans correction. Les applications qui stockent des valeurs UPC-A dans une base de données peuvent accumuler des enregistrements comportant un zéro initial qui n'a pas sa place.

La solution de contournement documentée consiste à vérifier le format et à supprimer les valeurs superflues :

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

' Workaround required for iOS UPC-A — strip the leading zero manually
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormat.UPC_A AndAlso value.Length = 13 Then
        value = value.Substring(1) ' strip Apple's prepended leading zero
    End If

    ProcessBarcode(value)
End Sub

Cette solution de contournement rend les codes-barres EAN-13 commençant par 0 inopérants si la vérification du format est omise. Le PDF417 est documenté séparément dans les problèmes GitHub comme étant " très problématique — la plupart des scans n'ont jamais lieu ", affectant les étiquettes d'expédition, les permis de conduire et les cartes d'embarquement.

Approche IronBarcode

IronBarcode renvoie la valeur UPC-A à 12 chiffres correcte sans normalisation manuelle. Le format PDF417 est pris en charge et sa lecture est fiable. 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 aux points de vente ou les intégrations de la chaîne d'approvisionnement, la gestion correcte du format d'IronBarcode élimine une catégorie de bugs de production que BarcodeScanning.Native.Maui laisse dans le code de l'application. La documentation de lecture des codes-barres IronBarcode décrit en détail le comportement spécifique à chaque format.

Ajout de la cible Windows MAUIà la version

Les applications MAUI ciblent généralement iOS et Android dès leur lancement, puis ajoutent Windows ultérieurement à mesure que l'application mûrit ou que les besoins de distribution en Enterprise s'étendent. Lorsque la cible Windows est ajoutée, BarcodeScanning.Native.Maui devient immédiatement un obstacle : il n'existe aucune implémentation Windows ni aucune solution de contournement au sein de la bibliothèque. Dans ce cas, les équipes doivent soit maintenir une implémentation de code-barres distincte pour Windows utilisant une bibliothèque différente, soit migrer l'ensemble de la couche de code-barres vers une bibliothèque fonctionnant de manière cohérente sur toutes les cibles MAUI. La seconde solution est plus simple sur le plan opérationnel et élimine les coûts de maintenance liés à la gestion de branches spécifiques à chaque plateforme.

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. Lorsqu'un utilisateur a besoin de scanner un code-barres à partir d'une photo de sa galerie, d'une image reçue par e-mail ou d'un PDF contenant des manifestes d'expédition ou des cartes d'embarquement, BarcodeScanning.Native.Maui ne propose aucun chemin de code. Les équipes qui atteignent ce seuil d'exigences doivent faire un choix : ajouter une seconde bibliothèque de codes-barres en plus de BarcodeScanning.Native.Maui pour les entrées de fichiers et de PDF, ou migrer vers une bibliothèque unique prenant en charge tous les types d'entrée. La gestion de deux bibliothèques de codes-barres avec des API, des types de résultats et des tables de compatibilité de formats différents engendre une complexité à long terme qu'une solution unique permet d'éviter.

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 qui dépend d'un contexte matériel de caméra ; Il ne peut pas s'exécuter dans un processus 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.

L'exactitude des données UPC-A devient un problème de production

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 phase de développement peuvent sembler fonctionner correctement, mais le zéro initial introduit par le framework Vision d'Apple apparaît dans la base de données. Les équipes qui découvrent des valeurs UPC-A à 13 chiffres dans les registres d'inventaire, les systèmes de point de vente ou les intégrations de la chaîne d'approvisionnement sont confrontées à un problème de correction des données en plus d'un problème de code. La solution de contournement documentée dans les problèmes GitHub de BarcodeScanning.Native.Maui corrige les nouvelles analyses, mais pas les données historiques. Lorsque l'ampleur du problème de qualité des données est clairement définie, la migration vers une bibliothèque qui renvoie des valeurs UPC-A correctes sans normalisation au niveau de l'application constitue souvent la solution à long terme la plus propre.

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 gestionnaire de problèmes GitHub de BarcodeScanning.Native.Maui signale que le format PDF417 est " très problématique — la plupart des scans n'ont jamais lieu ". Pour toute application où la fiabilité du format PDF417 est une exigence fonctionnelle et non une simple option, ce problème connu constitue un blocage direct qui oblige à évaluer des bibliothèques alternatives.

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

La principale modification structurelle de la migration consiste à remplacer le modèle d'événement continu de la caméra par une capture MediaPicker suivie d'une BarcodeReader.Read(). Le OnDetectionFinished gestionnaire d'événements, le CameraView contrôle XAML et la scanner: déclaration d'espace de noms XML 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 d'arrière-plan, donc tous les gestionnaires existants qui mettent à jour les éléments de l'interface utilisateur enveloppent leurs mises à jour dans MainThread.BeginInvokeOnMainThread(). Avec le motif MediaPicker + async utilisé par IronBarcode, la suite après await retourne sur le contexte appelant, qui est généralement le thread principal. Dans la plupart des cas, les enveloppes MainThread.BeginInvokeOnMainThread() peuvent être supprimées, ce qui simplifie le code du gestionnaire d'événements.

Suppression de la solution de contournement UPC-A

Toute base de code qui a géré le comportement iOS UPC-A à 13 chiffres de BarcodeScanning.Native.Maui aura un code qui vérifie BarcodeFormat.UPC_A et appelle Substring(1) pour supprimer le zéro initial. Ce code doit être supprimé après la migration — Code-barres IronBarcode renvoie la valeur correcte à 12 chiffres, et le maintien de cette solution de contournement supprimerait incorrectement le 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 l'installation de son paquet. 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 n'importe quelle application MAUI a besoin 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.