Barkoder SDK vs IronBarcode : Comparaison de la bibliothèque de codes-barres C#

Comprendre le lecteur de codes-barres Dynamsoft

L'architecture de Dynamsoft reflète son origine dans le domaine des appareils photo. La séquence de démarrage nécessite une activation de licence en ligne, le modèle de paramètres inclut des valeurs de délai d'attente appropriées pour le traitement de trame en temps réel, et l'API expose des paramètres ajustés pour les conditions de mise au point variable et de flou de mouvement d'une caméra portative :

// Dynamsoft: license activation required at startup
using Dynamsoft.CVR;
using Dynamsoft.DBR;
using Dynamsoft.License;
using Dynamsoft.Core;

// LicenseManager.InitLicense performs an online activation on first run
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"License activation failed: {errorMsg}");

using var router = new CaptureVisionRouter();

// Settings tuned for camera frame processing
SimplifiedCaptureVisionSettings settings = router.GetSimplifiedSettings(
    PresetTemplate.PT_READ_BARCODES);
settings.BarcodeSettings.ExpectedBarcodesCount = 1; // single barcode per frame
settings.Timeout = 100;                              // 100ms suits a 30fps pipeline
router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings);

// Dynamsoft: license activation required at startup
using Dynamsoft.CVR;
using Dynamsoft.DBR;
using Dynamsoft.License;
using Dynamsoft.Core;

// LicenseManager.InitLicense performs an online activation on first run
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"License activation failed: {errorMsg}");

using var router = new CaptureVisionRouter();

// Settings tuned for camera frame processing
SimplifiedCaptureVisionSettings settings = router.GetSimplifiedSettings(
    PresetTemplate.PT_READ_BARCODES);
settings.BarcodeSettings.ExpectedBarcodesCount = 1; // single barcode per frame
settings.Timeout = 100;                              // 100ms suits a 30fps pipeline
router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings);

Imports Dynamsoft.CVR
Imports Dynamsoft.DBR
Imports Dynamsoft.License
Imports Dynamsoft.Core

' Dynamsoft: license activation required at startup

' LicenseManager.InitLicense performs an online activation on first run
Dim errorCode As Integer = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", errorMsg:=Nothing)
If errorCode <> CType(EnumErrorCode.EC_OK, Integer) Then
    Throw New InvalidOperationException($"License activation failed: {errorMsg}")
End If

Using router As New CaptureVisionRouter()

    ' Settings tuned for camera frame processing
    Dim settings As SimplifiedCaptureVisionSettings = router.GetSimplifiedSettings(PresetTemplate.PT_READ_BARCODES)
    settings.BarcodeSettings.ExpectedBarcodesCount = 1 ' single barcode per frame
    settings.Timeout = 100                              ' 100ms suits a 30fps pipeline
    router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings)
End Using

Il s'agit d'une API bien conçue pour son usage. Le paramètre Timeout = 100 est logique lorsque vous traitez 30 images par seconde d'une caméra et que vous ne pouvez pas vous permettre de passer 500 ms sur une seule image. Pour un serveur traitant un PDF téléchargé, un délai d'attente de 100 ms ne sert à rien et peut provoquer un échec de lecture sur des codes-barres plus denses.

Le design routeur-et-session — new CaptureVisionRouter(), router.Dispose() — suit les sémantiques de session de caméra : vous ouvrez un routeur, traitez des images, jetez. Pour le traitement des fichiers, ce cycle de vie ajoute du code répétitif sans avantage.

Le problème du PDF

Dynamsoft Barcode Reader peut accepter directement certains entrées PDF sur les versions Windows, mais pour les déploiements multiplateformes, de nombreuses équipes pré-rendent encore chaque page PDF en une image avant de la passer à CaptureVisionRouter.Capture. Cela implique généralement l'inclusion d'une bibliothèque de rendu PDF distincte — PdfiumViewer est couramment utilisé — ce qui ajoute une dépendance NuGet, une dépendance binaire native (pdfium.dll sous Windows ou libpdfium sous Linux), et une boucle de rendu autour de chaque opération PDF :

// Dynamsoft PDF processing — typical cross-platform pattern with PdfiumViewer
// dotnet add package PdfiumViewer
using PdfiumViewer;
using System.Drawing.Imaging;
using Dynamsoft.CVR;
using Dynamsoft.DBR;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = new List<string>();

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    using (var router = new CaptureVisionRouter())
    {
        for (int page = 0; page < pdfDoc.PageCount; page++)
        {
            // Render each page at 300 DPI
            using var image = pdfDoc.Render(page, 300, 300, true);
            using var ms = new MemoryStream();
            image.Save(ms, ImageFormat.Png);
            byte[] imageBytes = ms.ToArray();

            // Now pass rendered image bytes to the Capture Vision Router
            CapturedResult result = router.Capture(imageBytes,
                PresetTemplate.PT_READ_BARCODES);
            foreach (var item in result.GetDecodedBarcodesResult().GetItems())
                results.Add(item.GetText());
        }
    }

    return results;
}

// Dynamsoft PDF processing — typical cross-platform pattern with PdfiumViewer
// dotnet add package PdfiumViewer
using PdfiumViewer;
using System.Drawing.Imaging;
using Dynamsoft.CVR;
using Dynamsoft.DBR;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = new List<string>();

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    using (var router = new CaptureVisionRouter())
    {
        for (int page = 0; page < pdfDoc.PageCount; page++)
        {
            // Render each page at 300 DPI
            using var image = pdfDoc.Render(page, 300, 300, true);
            using var ms = new MemoryStream();
            image.Save(ms, ImageFormat.Png);
            byte[] imageBytes = ms.ToArray();

            // Now pass rendered image bytes to the Capture Vision Router
            CapturedResult result = router.Capture(imageBytes,
                PresetTemplate.PT_READ_BARCODES);
            foreach (var item in result.GetDecodedBarcodesResult().GetItems())
                results.Add(item.GetText());
        }
    }

    return results;
}

Imports PdfiumViewer
Imports System.Drawing.Imaging
Imports Dynamsoft.CVR
Imports Dynamsoft.DBR
Imports System.IO

Public Function ReadBarcodesFromPdf(pdfPath As String) As List(Of String)
    Dim results As New List(Of String)()

    Using pdfDoc = PdfDocument.Load(pdfPath)
        Using router = New CaptureVisionRouter()
            For page As Integer = 0 To pdfDoc.PageCount - 1
                ' Render each page at 300 DPI
                Using image = pdfDoc.Render(page, 300, 300, True)
                    Using ms As New MemoryStream()
                        image.Save(ms, ImageFormat.Png)
                        Dim imageBytes As Byte() = ms.ToArray()

                        ' Now pass rendered image bytes to the Capture Vision Router
                        Dim result As CapturedResult = router.Capture(imageBytes, PresetTemplate.PT_READ_BARCODES)
                        For Each item In result.GetDecodedBarcodesResult().GetItems()
                            results.Add(item.GetText())
                        Next
                    End Using
                End Using
            Next
        End Using
    End Using

    Return results
End Function

Cela représente trois dépendances (Dynamsoft, PdfiumViewer, et un binaire natif spécifique à la plateforme), une boucle de rendu par page, et une surcharge de mémoire qui évolue avec le nombre de pages.

IronBarcode lit directement à partir d'un fichier PDF :

// IronBarcode: PDF is native — no extra library, no render loop
// NuGet: dotnet add package BarCode
var results = BarcodeReader.Read("invoice.pdf");
foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: PDF is native — no extra library, no render loop
// NuGet: dotnet add package BarCode
var results = BarcodeReader.Read("invoice.pdf");
foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarCode

' IronBarcode: PDF is native — no extra library, no render loop
' NuGet: dotnet add package BarCode
Dim results = BarcodeReader.Read("invoice.pdf")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Un seul appel. Aucun lecteur PDF. Pas de boucle par page. Pas de binaire natif spécifique à la plateforme pour la prise en charge des fichiers PDF.

Complexité de la licence

L'activation de licence en ligne est simple lorsque le serveur a accès à Internet. Lorsque ce n'est pas le cas — ou lorsque les politiques réseau exigent l'autorisation explicite des hôtes sortants — la surface d'échec de la validation augmente :

// Dynamsoft: error code pattern required
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
{
    // Possible causes: network timeout, license server unreachable,
    // invalid key, expired key, activation quota exceeded, etc.
    throw new InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}");
}

// Dynamsoft: error code pattern required
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
{
    // Possible causes: network timeout, license server unreachable,
    // invalid key, expired key, activation quota exceeded, etc.
    throw new InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}");
}

Imports System

' Dynamsoft: error code pattern required
Dim errorCode As Integer = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", errorMsg)
Dim errorMsg As String
If errorCode <> CType(EnumErrorCode.EC_OK, Integer) Then
    ' Possible causes: network timeout, license server unreachable,
    ' invalid key, expired key, activation quota exceeded, etc.
    Throw New InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}")
End If

La gestion des licences hors ligne avec Dynamsoft est un flux de travail distinct. Sur une machine connectée, vous effectuez une activation en ligne initiale pour récupérer un bundle de licence, le conserver, puis activez la machine hors ligne en rejouant ce bundle via InitLicenseFromLicenseContent :

// Dynamsoft offline license — replay a pre-fetched license bundle
int errorCode = LicenseManager.InitLicenseFromLicenseContent(
    licenseContent, out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"Offline activation failed: {errorMsg}");

// Dynamsoft offline license — replay a pre-fetched license bundle
int errorCode = LicenseManager.InitLicenseFromLicenseContent(
    licenseContent, out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"Offline activation failed: {errorMsg}");

Imports System

' Dynamsoft offline license — replay a pre-fetched license bundle
Dim errorCode As Integer = LicenseManager.InitLicenseFromLicenseContent(licenseContent, errorMsg)
Dim errorMsg As String = Nothing
If errorCode <> CType(EnumErrorCode.EC_OK, Integer) Then
    Throw New InvalidOperationException($"Offline activation failed: {errorMsg}")
End If

Les lots de licences obtenus de cette manière ont une fenêtre d'expiration (généralement de quelques jours à un an) et doivent être rafraîchis avant qu'ils ne deviennent obsolètes, ce qui signifie qu'une machine connectée doit participer au flux de travail de manière récurrente.

L'activation de la licence Code-barres IronBarcode est une tâche unique évaluée localement :

// IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Aucun code d'erreur à vérifier. Aucune dépendance au réseau. Pas de cycle de rafraîchissement du lot de licences. La même ligne fonctionne sur une machine de développement, dans un pipeline CI/CD, dans un conteneur Docker, et sur un serveur isolé.

Cas d'utilisation de l'appareil photo et des fichiers

Dynamsoft et Code-barres IronBarcode sont optimisés pour différents scénarios principaux. Le tableau ci-dessous décrit cela plutôt que de déclarer une bibliothèque universellement meilleure :

Comprendre IronBarcode

IronBarcode est une bibliothèque .NET permettant à la fois de générer et de lire des codes-barres. L'API est statique — pas d'instances, pas d'appels de suppression, pas de cycle de vie de session. L'activation de la licence est locale. La prise en charge des fichiers PDF est intégrée :

// NuGet: dotnet add package BarCode
using IronBarCode;

// License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Read from an image file
var results = BarcodeReader.Read("label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

// Read from a PDF — native, no extra library
var pdfResults = BarcodeReader.Read("manifest.pdf");

// Read with options for high-accuracy or high-throughput scenarios
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads= 4
};
var multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options);

// NuGet: dotnet add package BarCode
using IronBarCode;

// License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Read from an image file
var results = BarcodeReader.Read("label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

// Read from a PDF — native, no extra library
var pdfResults = BarcodeReader.Read("manifest.pdf");

// Read with options for high-accuracy or high-throughput scenarios
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads= 4
};
var multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options);

Imports IronBarCode

' License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

' Read from an image file
Dim results = BarcodeReader.Read("label.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

' Read from a PDF — native, no extra library
Dim pdfResults = BarcodeReader.Read("manifest.pdf")

' Read with options for high-accuracy or high-throughput scenarios
Dim options = New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}
Dim multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options)

La génération est tout aussi simple :

// Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

// Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("tracking-qr.png");

// Get bytes for HTTP response
byte[] bytes = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .ToPngBinaryData();

// Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

// Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("tracking-qr.png");

// Get bytes for HTTP response
byte[] bytes = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .ToPngBinaryData();

Imports System

' Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("shipping-label.png")

' Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .AddBrandLogo("company-logo.png") _
    .SaveAsPng("tracking-qr.png")

' Get bytes for HTTP response
Dim bytes As Byte() = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .ToPngBinaryData()

Comparaison des fonctionnalités

Référence de mappage d'API

Pour les équipes qui utilisent du code Dynamsoft et qui ont besoin de comprendre comment les concepts se traduisent :

Quand les équipes changent

Traitement de documents côté serveur, pas de numérisation par caméra. Le scénario de migration le plus courant est une équipe qui a choisi Dynamsoft basé sur sa réputation, l'a intégré, puis a découvert que l'API centrée sur la caméra et l'étape de rendu PDF rendaient les flux de travail de traitement de documents peu commodes. Lire les codes-barres des PDF téléchargés dans une application web est un cas d'utilisation principal qui nécessite un travail supplémentaire dans Dynamsoft, mais qu'une seule requête dans IronBarcode.

Environnements réseau isolés ou restreints. Les institutions financières, les systèmes de santé et les déploiements gouvernementaux interdisent souvent les connexions Internet sortantes depuis les serveurs d'applications. L'activation en ligne de Dynamsoft ne fonctionne pas dans ces environnements sans le flux de travail de lot de licences hors ligne, ce qui ajoute des étapes opérationnelles. Dans ces environnements, les équipes migrent souvent vers Code-barres IronBarcode précisément parce que la validation des licences ne comporte aucun composant réseau.

Conteneurs éphémères Docker et Kubernetes. Les déploiements par conteneur, où les instances augmentent et diminuent fréquemment, rendent le rafraîchissement récurrent des lots de licences malaisé à gérer. La clé de licence d'IronBarcode fonctionne comme une variable d'environnement standard, sans enregistrement par instance.

Besoin de génération ainsi que de lecture. Le lot Lecteur de codes-barres Dynamsoft est en lecture seule. Les applications qui doivent générer des étiquettes de code-barres, imprimer des codes QR pour les produits ou créer des manifestes d'expédition avec des codes-barres intégrés nécessitent une deuxième bibliothèque. Dans ce genre de situation, les équipes optent souvent pour Code-barres IronBarcode afin d'éviter de gérer deux dépendances de codes-barres distinctes.

Empreinte opérationnelle simplifiée. Retirer le serveur de licences Dynamsoft de la liste des dépendances externes à atteindre, supprimer la bibliothèque de rendu PDF, et remplacer la gestion du cycle de vie du routeur par des appels statiques réduit le nombre de choses qui peuvent mal tourner en production.

Conclusion

Dynamsoft Barcode Reader est une bibliothèque de haute qualité qui convient bien à son cas d'utilisation prévu : la numérisation de codes-barres en temps réel basée sur la caméra, spécialement dans les applications mobiles. Les algorithmes sont parfaitement adaptés aux conditions de la numérisation manuelle : éclairage variable, flou de mouvement, occlusion partielle. Si tel est votre cas d'utilisation, Dynamsoft est un concurrent sérieux.

Pour le traitement de documents côté serveur — lecture de codes-barres dans des PDF, génération d'étiquettes de codes-barres, exécution dans des environnements isolés ou déploiement dans des conteneurs Docker éphémères —, l'architecture de la bibliothèque demande plus d'installation à chaque étape. L'activation de licence en ligne, le modèle de rendu PDF multiplateforme, les paramètres de temporisation optimisés pour la caméra et le flux de travail de lot de licences hors ligne sont les conséquences de la construction pour l'utilisation par caméra mobile. Ce ne sont pas des insectes ; Ce sont des choix de conception délibérés pour un contexte différent.

IronBarcode est conçu pour le contexte côté document et côté serveur. La validation des licences locales, la lecture native des PDF, l'API statique et la prise en charge de la génération sont autant de fonctionnalités de premier ordre et non des solutions de contournement. La décision dépend de quel environnement vos codes-barres vivent réellement.