Accusoft BarcodeXpress vs IronBarcode : Comparaison de la bibliothèque de codes-barres C#

Explication du système à deux clés

BarcodeXpress divise le système de licences en deux couches conceptuellement distinctes :

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

Imports Accusoft.BarcodeXpressSdk

Dim barcodeXpress As New BarcodeXpress()
' Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName"
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
' Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"))

La paire SolutionName et SolutionKey active le SDK lui-même. L'appel UnlockRuntime, qui prend sa propre clé et sa propre clé de solution comme arguments distincts, active les capacités de déploiement de la production. Les deux doivent être présents et valides pour qu'un déploiement en production renvoie des valeurs de code-barres complètes et non masquées.

Lors de l'examen du code, ce modèle donne lieu à une question prévisible : "Pourquoi appelons-nous UnlockRuntime avec deux clés différentes ?" La réponse - Accusoft traite les licences SDK et les licences de déploiement comme des produits distincts avec une facturation distincte - n'est pas toujours évidente à partir de l'API elle-même. Les équipes chargées de la maintenance de ce code six mois après sa configuration initiale doivent souvent se référer à la documentation pour comprendre à quoi correspond chaque clé.

La propriété IsRuntimeUnlocked vous permet de vérifier si la couche d'exécution est active :

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

If Not barcodeXpress.Licensing.IsRuntimeUnlocked Then
    ' In this state, barcode values are partially obscured
    ' "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active")
End If

Ce contrôle est la mesure de sécurité ajoutée par les équipes lorsqu'elles constatent que la sortie en mode évaluation renvoie silencieusement des données partielles au lieu de lever une exception ou d'échouer clairement.

Comparaison détaillée des fonctionnalités

Approche BarcodeXpress

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress()

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp"
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")

        ' Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime("RuntimeKey-XXXXXX", Convert.ToInt64("98765432109876"))

        ' Guard against partial-value mode
        If Not _barcodeXpress.Licensing.IsRuntimeUnlocked Then
            Throw New InvalidOperationException("Runtime license not active — barcode values will be obscured")
        End If
    End Sub
End Class

Il s'agit d'un constructeur de 15 lignes qui existe uniquement pour gérer deux systèmes de clés de licence distincts avant toute opération de code-barres. La garde IsRuntimeUnlocked n'est pas optionnelle - sans elle, le service renverra silencieusement des valeurs dégradées dans tout environnement où la clé d'exécution est manquante ou mal configurée.

Approche IronBarcode

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

' In Program.vb or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY"

Il s'agit là de la configuration complète de la licence. Pas de déverrouillage séparé du runtime, pas de nom de solution, pas d'appel à deux arguments UnlockRuntime. Dans Docker, cela devient une variable d'environnement lue au démarrage. Dans un pipeline CI/CD, il s'agit d'un secret. Dans un orchestrateur de conteneurs, il s'agit d'une variable d'environnement injectée dans le pod.

Approche BarcodeXpress

La lecture avec BarcodeXpress implique la configuration du lecteur via SetPropertyValue, qui prend une constante et une valeur, puis l'appel à Analyze() pour récupérer les résultats :

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress()
    barcodeXpress.Licensing.SolutionName = "AcmeCorp"
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"))

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath)
    barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.DataMatrixBarcode Or BarcodeType.QRCodeBarcode

    Dim results = barcodeXpress.reader.Analyze()
    Return results.Select(Function(r) r.BarcodeValue)
End Function

La constante cycBxeSetFilename est la façon dont l'API spécifie le fichier à traiter. Ce modèle - passer un identifiant constant plus une valeur à une méthode générique SetPropertyValue - rappelle les anciennes API basées sur COM. Si un document contient un format non répertorié dans BarcodeTypes, il ne sera pas trouvé. Cela engendre des frais de maintenance supplémentaires lorsque les sources de documents changent.

Approche IronBarcode

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

Imports IronBarCode

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim results = BarcodeReader.Read(imagePath)
    Return results.Select(Function(r) r.Value)
End Function

IronBarcode détecte automatiquement le format pour toutes les symbologies prises en charge. Si l'image contient un Code 128, un code QR et un DataMatrix, les trois apparaissent dans la collection de résultats sans aucune modification de configuration. Pour un contrôle plus précis du comportement de lecture, la classe BarcodeReaderOptions expose des paramètres de vitesse, de nombre de threads et de lecture de plusieurs codes-barres.

La lecture native des fichiers PDF est également possible via la même méthode :

using IronBarCode;

// NatifPDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

using IronBarCode;

// NatifPDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

Imports IronBarCode

' NatifPDF support — no separate library needed
Dim results = BarcodeReader.Read("invoice-batch.pdf")

For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}")
Next

BarcodeXpress ne lit pas les fichiers PDF nativement. Vous devez d'abord convertir chaque page en image, à l'aide d'une bibliothèque distincte, puis transmettre ces images au lecteur BarcodeXpress. Cela ajoute une dépendance, une étape de conversion et un coût de licence supplémentaire en fonction de la bibliothèque PDF choisie.

Approche BarcodeXpress

BarcodeXpress est basé sur des instances et son objet reader est à états. Le traitement parallèle nécessite une instance par thread, l'initialisation complète de la licence à deux niveaux étant répétée dans chaque contexte de thread :

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic

Public Function ProcessBatch(imagePaths As IEnumerable(Of String)) As Dictionary(Of String, String)
    Dim results As New Dictionary(Of String, String)()

    For Each path In imagePaths
        _barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, path)
        _barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.QRCodeBarcode

        Dim barcodes = _barcodeXpress.reader.Analyze()
        If barcodes.Length > 0 Then
            results(path) = barcodes(0).BarcodeValue
        End If
    Next

    Return results
End Function

L'édition standard impose également un plafond de 40 pages par minute. Le traitement d'un lot de 100 000 documents à 40 PPM prend environ 41 heures. L'édition Professional supprime cette limite, mais à un coût plus élevé par développeur, en plus des licences d'exécution déjà achetées.

Approche IronBarcode

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

// Code-barres IronBarcode — parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

// Code-barres IronBarcode — parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.Threading.Tasks
Imports System.IO

' Code-barres IronBarcode — parallel batch with thread-safe static API
Dim files = Directory.GetFiles("/incoming/scans", "*.png")
Dim allResults = New ConcurrentBag(Of String)()

Parallel.ForEach(files, Sub(file)
    Dim r = BarcodeReader.Read(file)
    For Each barcode In r
        allResults.Add($"{file}: {barcode.Value}")
    Next
End Sub)

Les méthodes statiques d'IronBarcode étant sans état, Parallel.ForEach leur survol est sûr, aucune isolation d'instance n'étant nécessaire. Code-barres IronBarcode n'impose aucun plafond de débit, quel que soit le niveau de prix. Pour régler les performances de lecture, la classe BarcodeReaderOptions fournit des paramètres ReadingSpeed et MaxParallelThreads :

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim results = BarcodeReader.Read("warehouse-scan.png", options)

ReadingSpeed.Balanced est la valeur par défaut. Utilisez ReadingSpeed.Faster pour les pipelines à haut débit où les codes-barres sont propres, ou ReadingSpeed.Detailed pour les images endommagées ou à faible contraste.

Dépasser le seuil des 40 ppm

La limite de 40 pages par minute de l'édition standard semble généreuse jusqu'à ce qu'une équipe commerciale décide d'effectuer un traitement par lots en fin de journée sur une année entière de factures archivées. Le traitement d'un lot de 100 000 documents à ce rythme prend environ 41 heures. Passer à l'édition Professional supprime la limite, mais au prix d'un coût plus élevé par poste de développeur, en plus des licences d'exécution déjà achetées. Les équipes qui découvrent le plafond de débit après avoir signé un bon de commande constatent souvent que le coût total de sa suppression dépasse largement les estimations initiales.

Complexité des licences des pipelines CI/CD

Une configuration CI/CD typique exécute les builds dans des conteneurs éphémères. Avec BarcodeXpress, chaque environnement de compilation nécessite à la fois la paire de clés du SDK et les clés de déverrouillage d'exécution, gérées comme des secrets distincts. Si la clé d'exécution est manquante ou mal configurée, la compilation peut réussir, mais les tests d'intégration renvoient des valeurs masquées — un mode de défaillance silencieux facile à manquer dans un pipeline de test si les assertions de test ne sont pas soigneusement écrites par rapport au contenu réel du code-barres.

Exigences de déploiement isolé et sécurisé

Certains environnements — systèmes de santé traitant les dossiers des patients, flux de travail documentaires gouvernementaux, traitement administratif des institutions financières — ne peuvent pas effectuer de validation de licence lors d'appels réseau sortants. Le système de licences d'exécution de BarcodeXpress repose sur l'infrastructure de licences d'Accusoft, ce qui peut poser un problème de conformité dans les environnements soumis à des restrictions strictes en matière de trafic réseau sortant. Les équipes travaillant dans ces environnements choisissent souvent des bibliothèques dont la validation des licences est entièrement locale.

Déploiement de Docker et de conteneurs

BarcodeXpress dans Docker nécessite généralement soit de monter un fichier de licence dans le conteneur à un emplacement connu, soit de configurer un serveur de licences et de pointer le conteneur vers celui-ci. Les deux approches ajoutent de la complexité au déploiement : les fichiers de licence doivent être distribués et synchronisés, et un serveur de licences représente un élément d'infrastructure supplémentaire à maintenir. Les équipes qui adoptent des architectures de microservices ou des modèles de déploiement sans serveur constatent que l'approche par fichier de configuration ne se traduit pas facilement en images de conteneurs immuables.

Exigences en matière de précision d'évaluation

Les équipes qui ont besoin de valider la précision de lecture sur leurs propres documents avant de procéder à un achat trouvent le mode d'évaluation de BarcodeXpress fondamentalement limitant. Les tests effectués sur des documents numérisés réels — vérifiant si la bibliothèque gère les codes-barres à faible contraste, les images déformées ou les pages à codes-barres multiples — nécessitent des valeurs décodées complètes. Les résultats partiellement masqués indiquent seulement que la bibliothèque a trouvé un code-barres, et non si elle l'a lu correctement.

Gestion des instances pour les appels statiques

BarcodeXpress nécessite qu'une instance BarcodeXpress soit créée et licenciée avant toute opération. Les méthodes statiques d'IronBarcode ne nécessitent pas d'instance. Les équipes qui migrent ont généralement une classe BarcodeService dont le constructeur est en grande partie un modèle de licence - après la migration, ce constructeur peut être entièrement supprimé ou réduit à une seule attribution de clé de licence.

Suppression de l'énumération des types de codes-barres

Chaque opération de lecture de BarcodeXpress nécessite une affectation de drapeau BarcodeTypes pour énumérer les symbologies à rechercher. Code-barres IronBarcode détecte automatiquement tous les formats pris en charge par défaut. Pendant la migration, toutes les affectations reader.BarcodeTypes = ...peuvent être supprimées sans être remplacées. S'il existe une raison de performance pour restreindre l'espace de recherche, BarcodeReaderOptions prend en charge le filtrage de format en tant qu'option explicite plutôt qu'en tant que valeur par défaut obligatoire.

Résultat : Modifications du nom de la propriété

Deux renommages de propriétés affectent tout le code de traitement des résultats : result.BarcodeValuedevient result.Value, et result.BarcodeTypedevient result.Format. Une fonction de recherche et de remplacement à l'échelle de la solution gère les deux. Les résultats d'IronBarcode exposent également result.Confidence et result.PageNumber, qui n'ont pas d'équivalent dans BarcodeXpress et peuvent être utilisés pour un filtrage supplémentaire sans modification de code dans le traitement des résultats existants.

Configuration de la licence Docker

Les déploiements Docker de BarcodeXpress utilisent généralement un fichier de configuration de licence monté. Code-barres IronBarcode utilise une variable d'environnement. La migration implique la suppression de l'instruction COPY pour le fichier de configuration et l'ajout d'une seule affectation de variable d'environnement. Dans Kubernetes, la clé de licence devient une référence secrète dans la spécification du pod plutôt qu'un volume monté.