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;

// Constructor takes the path to the runtime files (e.g. ".").
var barcodeXpress = new BarcodeXpress(".");

// Step 1: SDK license (for development).
// SetSolutionName and SetSolutionKey are methods, not properties.
// SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName");
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

// Step 2: OEM/runtime license (for production — minimum 5 purchased).
try
{
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString");
}
catch (Exception ex)
{
    // Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}");
}

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

// Constructor takes the path to the runtime files (e.g. ".").
var barcodeXpress = new BarcodeXpress(".");

// Step 1: SDK license (for development).
// SetSolutionName and SetSolutionKey are methods, not properties.
// SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName");
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

// Step 2: OEM/runtime license (for production — minimum 5 purchased).
try
{
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString");
}
catch (Exception ex)
{
    // Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}");
}

Imports Accusoft.BarcodeXpressSdk

' BarcodeXpress: two separate license keys required

' Constructor takes the path to the runtime files (e.g. ".").
Dim barcodeXpress As New BarcodeXpress(".")

' Step 1: SDK license (for development).
' SetSolutionName and SetSolutionKey are methods, not properties.
' SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName")
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)

' Step 2: OEM/runtime license (for production — minimum 5 purchased).
Try
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString")
Catch ex As Exception
    ' Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}")
End Try

Le couple SetSolutionKey active le SDK lui-même. L'appel SetOEMLicenseKey active les capacités de déploiement en production. Les deux doivent être présents et valides pour qu'un déploiement en production renvoie des valeurs de codes-barres sans le tampon " UNLICENSED accusoft.com ".

Lors de l'examen du code, ce modèle produit une question prévisible : " Pourquoi avons-nous deux activations de licence séparées ? " La réponse — qu'Accusoft traite la licence SDK et la licence de déploiement comme des produits séparés avec facturation séparée — n'est pas toujours évidente depuis 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é.

Sans licence OEM valide, SetOEMLicenseKey génère une exception et le SDK revient en mode évaluation. Les équipes enveloppent typiquement l'activation dans try/catch afin que l'échec soit consigné bruyamment au lieu de produire silencieusement des valeurs de code-barres estampillées en production :

try
{
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey);
}
catch (Exception ex)
{
    // In evaluation mode, barcode values are stamped with
    // " UNLICENSED accusoft.com " in the output.
    throw new InvalidOperationException(
        "OEM license activation failed — barcode values will be stamped", ex);
}

try
{
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey);
}
catch (Exception ex)
{
    // In evaluation mode, barcode values are stamped with
    // " UNLICENSED accusoft.com " in the output.
    throw new InvalidOperationException(
        "OEM license activation failed — barcode values will be stamped", ex);
}

Try
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey)
Catch ex As Exception
    ' In evaluation mode, barcode values are stamped with
    ' " UNLICENSED accusoft.com " in the output.
    Throw New InvalidOperationException("OEM license activation failed — barcode values will be stamped", ex)
End Try

Cette garde est le modèle que les équipes ajoutent lorsqu'elles réalisent que la sortie en mode évaluation tamponne silencieusement les résultats plutôt que de lever une exception lors du décodage.

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.SetSolutionName("AcmeCorp");
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

        // Layer 2: OEM/runtime license — separate purchase, minimum 5
        try
        {
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");
        }
        catch (Exception ex)
        {
            throw new InvalidOperationException(
                "OEM license activation failed — barcode values will be stamped", ex);
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

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

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

        // Layer 2: OEM/runtime license — separate purchase, minimum 5
        try
        {
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");
        }
        catch (Exception ex)
        {
            throw new InvalidOperationException(
                "OEM license activation failed — barcode values will be stamped", ex);
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress(".")

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SetSolutionName("AcmeCorp")
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)

        ' Layer 2: OEM/runtime license — separate purchase, minimum 5
        Try
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString")
        Catch ex As Exception
            Throw New InvalidOperationException("OEM license activation failed — barcode values will be stamped", ex)
        End Try
    End Sub
End Class

Ce constructeur existe entièrement pour gérer deux activations de licence séparées avant toute opération de code-barres. Le try/catch autour de SetOEMLicenseKey n'est pas optionnel — sans cela, le service renverra silencieusement des valeurs estampillées dans tout environnement où la clé OEM est absente ou mal configurée.

Approche IronBarcode

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

C'est l'ensemble complet des licences. Pas de déverrouillage runtime séparé, pas de nom de solution, pas d'appel UnlockRuntime avec deux arguments. 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 nécessite de charger l'image dans un System.Drawing.Bitmap, d'assigner l'ensemble de symbologie à reader.BarcodeTypes en tant que System.Array de valeurs BarcodeType, et d'appeler Analyze(bitmap) pour récupérer les résultats. Le SDK ne lit pas les PDF directement — les formats d'entrée documentés sont TIFF, JPEG, PNG, et BMP :

using Accusoft.BarcodeXpressSdk;
using System.Drawing;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress(".");
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");

    using var bitmap = new Bitmap(imagePath);

    // BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
    // enum). Pass Enum.GetValues to scan for everything, or assign a
    // narrower array to restrict the search space.
    barcodeXpress.reader.BarcodeTypes = new[]
    {
        BarcodeType.Code128Barcode,
        BarcodeType.DataMatrixBarcode,
        BarcodeType.QRCodeBarcode
    };

    Result[] results = barcodeXpress.reader.Analyze(bitmap);
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;
using System.Drawing;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress(".");
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");

    using var bitmap = new Bitmap(imagePath);

    // BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
    // enum). Pass Enum.GetValues to scan for everything, or assign a
    // narrower array to restrict the search space.
    barcodeXpress.reader.BarcodeTypes = new[]
    {
        BarcodeType.Code128Barcode,
        BarcodeType.DataMatrixBarcode,
        BarcodeType.QRCodeBarcode
    };

    Result[] results = barcodeXpress.reader.Analyze(bitmap);
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Drawing

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress(".")
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp")
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString")

    Using bitmap As New Bitmap(imagePath)
        ' BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
        ' enum). Pass Enum.GetValues to scan for everything, or assign a
        ' narrower array to restrict the search space.
        barcodeXpress.Reader.BarcodeTypes = New BarcodeType() {
            BarcodeType.Code128Barcode,
            BarcodeType.DataMatrixBarcode,
            BarcodeType.QRCodeBarcode
        }

        Dim results As Result() = barcodeXpress.Reader.Analyze(bitmap)
        Return results.Select(Function(r) r.BarcodeValue)
    End Using
End Function

Analyze prend un Bitmap et renvoie un Result[]. Si un document contient un format non présent dans le tableau BarcodeTypes, il ne sera pas trouvé. Cela engendre des frais de maintenance supplémentaires lorsque les sources de documents changent. Les PDF nécessitent un pré-rendu en images avec une bibliothèque séparée avant qu'ils ne puissent être introduits dans Analyze.

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 une instance et son objet reader est avec état. 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;
using System.Drawing;

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

    foreach (var path in imagePaths)
    {
        using var bitmap = new Bitmap(path);

        _barcodeXpress.reader.BarcodeTypes = new[]
        {
            BarcodeType.Code128Barcode,
            BarcodeType.QRCodeBarcode
        };

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

    return results;
}

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

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

    foreach (var path in imagePaths)
    {
        using var bitmap = new Bitmap(path);

        _barcodeXpress.reader.BarcodeTypes = new[]
        {
            BarcodeType.Code128Barcode,
            BarcodeType.QRCodeBarcode
        };

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

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic
Imports System.Drawing

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
        Using bitmap As New Bitmap(path)
            _barcodeXpress.reader.BarcodeTypes = New BarcodeType() {
                BarcodeType.Code128Barcode,
                BarcodeType.QRCodeBarcode
            }

            Dim barcodes = _barcodeXpress.reader.Analyze(bitmap)
            If barcodes.Length > 0 Then
                results(path) = barcodes(0).BarcodeValue
            End If
        End Using
    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)

Parce que les méthodes statiques de Code-barres IronBarcode sont sans état, Parallel.ForEach sur eux est sûr sans nécessiter d'isolation d'instance. Code-barres IronBarcode n'impose aucun plafond de débit, quel que soit le niveau de prix. Pour ajuster les performances de lecture, la classe BarcodeReaderOptions fournit des réglages 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 des pipelines à haut débit où les codes-barres sont propres, ou ReadingSpeed.Detailed pour des 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 boilerplate de licence — après la migration, ce constructeur peut être entièrement supprimé ou réduit à une simple assignation de clé de licence.

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

Chaque opération de lecture BarcodeXpress nécessite une assignation de tableau BarcodeTypes pour énumérer quelles symbologies rechercher. Code-barres IronBarcode détecte automatiquement tous les formats pris en charge par défaut. Pendant la migration, toutes les assignations reader.BarcodeTypes = ... peuvent être supprimées sans remplacement. S'il y a une raison de performance pour restreindre l'espace de recherche, BarcodeReaderOptions supporte le filtrage de format comme un opt-in explicite plutôt qu'un défaut requis.

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.BarcodeValue devient result.Value, et result.BarcodeType devient result.Format. Une fonction de recherche et de remplacement à l'échelle de la solution gère les deux. Les résultats Code-barres IronBarcode exposent également result.Confidence et result.PageNumber, qui n'ont pas d'équivalent BarcodeXpress et peuvent être utilisés pour un filtrage supplémentaire sans modifications du code de gestion 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 assignation d'une seule 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é.