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

Flux de travail de génération multi-packages

Le récit de l'installation illustre immédiatement la différence d'envergure. Avec Barcoder, la sortie PNG de base nécessite deux packages distincts :

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

Le flux de travail complet pour générer un code-barres Code128 et l'enregistrer au format PNG nécessite trois importations d'espace de noms, un appel d'encodeur spécifique au format, une construction de rendu avec un objet d'options, un flux de fichiers et un appel de rendu :

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

Changer le format des codes-barres ne se résume pas à modifier un paramètre ; cela nécessite d'importer un espace de noms différent et d'appeler une classe différente. Code128Encoder.Encode prend un bool pour includeChecksum, QrEncoder.Encode prend un niveau de correction d'erreur et deux bools supplémentaires, et DataMatrixEncoder.Encode ne prend que la chaîne de caractères. Il n'existe pas d'interface unifiée pour créer un code-barres dans un format spécifique.

Comparaison détaillée des fonctionnalités

Approche par code-barres

Le système de codage à barres achemine la sélection du format via des classes d'encodeurs distinctes dans des espaces de noms séparés. Le changement de format implique l'ajout d'une nouvelle directive using et l'utilisation d'une classe différente avec une signature de méthode différente :

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

Chaque encodeur possède son propre contrat de paramètres. Ajouter un nouveau format à un projet existant ne se résume pas à un simple changement d'un mot : il s'agit d'importer un nouvel espace de noms, d'apprendre une nouvelle classe et de comprendre de nouveaux paramètres.

Approche IronBarcode

IronBarcode fait passer toute la sélection de format par l'enum BarcodeEncoding sur la classe unifiée BarcodeWriter. L'ajout d'un nouveau format consiste à modifier un seul mot la valeur de l'énumération :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

Pour une utilisation en production, ajoutez la clé de licence au démarrage de l'application :

IronBarCode.License.LicenseKey = "YOUR-KEY";

IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

La documentation relative à la génération de codes-barres IronBarcode couvre l'ensemble des options de génération, y compris le style, les marges et la personnalisation des couleurs.

Approche par code-barres

La séparation entre l'encodage et le rendu chez codeur à barres est un principe architectural, mais elle engendre une surcharge à chaque changement de format de sortie. L'enregistrement dans un fichier nécessite l'ouverture d'un FileStream. Pour obtenir des données binaires, il faut ouvrir un MemoryStream et appeler le ToArray(). Chaque scénario de sortie nécessite la construction d'un moteur de rendu avec un objet d'options :

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

Le contrôle de la taille est indirect : PixelSize est un multiplicateur d'échelle sur la taille du module de code-barres, et non une spécification directe de la largeur et de la hauteur.

Approche IronBarcode

IronBarcode renvoie un objet GeneratedBarcode à partir duquel n'importe quelle forme de sortie peut être atteinte par le biais d'appels de méthodes enchaînés. Aucune construction de moteur de rendu, aucune gestion de flux :

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height) prend des dimensions de pixels explicites et enchaîne avec n'importe quelle méthode de sortie sur le même objet.

Approche par code-barres

Le codeur à barres ne possède aucune capacité de lecture ou de décodage. Il n'existe pas d'API, aucune API prévue et aucune solution de contournement au sein de la bibliothèque. Si une application a besoin de lire des codes-barres, une deuxième bibliothèque — une dépendance NuGet distincte avec sa propre interface API et sa propre version à suivre — doit être ajoutée en plus de Barcoder. Cela signifie au minimum deux dépendances liées à la lecture : codeur à barres pour la génération et un autre élément pour la lecture.

Approche IronBarcode

IronBarcode prend en charge à la fois la génération et la lecture avec le même package et des modèles d'API cohérents. La méthode BarcodeReader.Read() accepte les fichiers images, les tableaux d'octets, les flux et les PDF en mode natif :

using IronBarCode;

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

// Lire le PDF — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

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

// Lire le PDF — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine(result.Value)
    Console.WriteLine(result.Format)
Next

' Lire le PDF — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

La lecture des fichiers PDF est native — aucune extraction d'image intermédiaire, aucune bibliothèque de conversion, aucun package supplémentaire. La documentation relative à la lecture des codes-barres IronBarcode couvre les PDF multipages, la lecture de zones d'intérêt et l'optimisation des performances.

La lecture est ajoutée aux exigences

De nombreux projets débutent par de simples chaînes de génération : impression d'étiquettes, génération de codes pour les documents, intégration de codes-barres dans les rapports. codeur à barres prend en charge ces projets dès le départ. Lorsque la même application doit ultérieurement vérifier les codes-barres entrants, traiter des documents numérisés ou décoder les codes-barres des PDF téléchargés, codeur à barres n'offre aucune solution. L'équipe doit évaluer une deuxième bibliothèque, apprendre son API, gérer sa version NuGet séparément et gérer l'interface d'intégration entre les deux bibliothèques. Les équipes qui atteignent ce stade optent souvent pour une bibliothèque qui gère les deux aspects plutôt que de maintenir deux dépendances de codes-barres distinctes.

Rupture de compatibilité avec le .NET Framework

Barcoder.Renderer.Image a abandonné la prise en charge de .NET Framework. Les équipes qui gèrent des services ou des applications de bureau sur .NET Framework4.x et qui mettent à jour le package de rendu d'images lors de la maintenance de routine des dépendances rencontrent un échec de compilation. Il ne s'agit pas d'une erreur de configuration, mais d'une décision de la bibliothèque concernant la prise en charge de la plateforme. Code-barres IronBarcode prend en charge .NET Framework4.6.2 à .NET 9sans packaging spécial ni dépendances conditionnelles pour différentes cibles.

La dérive des versions de packages crée des problèmes de coordination

Les versions de Barcoder et Barcoder.Renderer.Image étant indépendantes, la mise à jour de l'une sans l'autre lors d'un rafraîchissement des dépendances peut introduire de subtiles incompatibilités. Dans un dépôt comportant plusieurs projets — chacun utilisant une version différente de chaque package de rendu — garantir un comportement cohérent entre les projets devient un problème de coordination qui s'accroît avec la taille de l'équipe. Les équipes qui utilisent désormais Code-barres IronBarcode indiquent que la gestion d'un seul package et d'une seule version élimine complètement ce type de problème.

La couverture des formats s'étend au fil du temps

Un projet pourrait commencer par des étiquettes Code128, puis ajouter ultérieurement des codes QR pour les liens destinés aux clients, puis DataMatrix pour répondre aux exigences de conformité. Avec Barcoder, chaque ajout de format implique une nouvelle importation d'espace de noms, une classe d'encodeur différente avec des paramètres de méthode différents, et potentiellement un nouveau package NuGet . Avec IronBarcode, l'ajout d'un format est une modification de la valeur BarcodeEncoding enum dans un appel existant. Les équipes dont la feuille de route prévoit l'extension de la couverture des formats de codes-barres trouvent le modèle basé sur les énumérations beaucoup plus facile à maintenir.

Exigences de déploiement MAUI et multiplateformes

Barcoder ne documente pas la prise en charge des déploiements MAUI, Docker, AWS Lambda ou Azure. Les équipes qui développent des applications MAUI multiplateformes ou qui déploient le traitement des codes-barres sur une infrastructure sans serveur constatent que la documentation et les tests de codeur à barres ne couvrent pas ces cibles. Code-barres IronBarcode documente et teste activement le déploiement sur les cibles iOS, Android, Windows, macOS MAUI, les conteneurs Docker et les principales plateformes cloud.

Le changement de type IBarcode en GeneratedBarcode

Le code BarCode qui stocke une variable IBarcode et la transmet ultérieurement à un moteur de rendu doit être refactorisé. Dans IronBarcode, GeneratedBarcode porte ses propres méthodes de sortie - il n'y a pas d'étape de rendu séparée. Toute signature de méthode qui accepte actuellement IBarcode devrait changer pour accepter GeneratedBarcode, et l'appel de rendu à l'intérieur de cette méthode devrait devenir un appel direct comme .SaveAsPng() ou .ToPngBinaryData(). Le système de types fera apparaître chaque emplacement nécessitant une mise à jour pendant la compilation - IBarcode ne se résoudra pas après la suppression des paquets BarCode.

PixelSize N'a pas d'équivalent direct

Le PixelSize de BarCode est un multiplicateur d'échelle sur la taille naturelle du module du code-barres, et non une dimension explicite en pixels. La largeur de sortie dépend du contenu du code-barres, de son format et du multiplicateur, combinés. Code-barres IronBarcode utilise .ResizeTo(width, height)avec des dimensions en pixels explicites. Pendant la migration, mesurez les dimensions de sortie réelles que le code BarCode existant produit et utilisez ces valeurs dans l'appel .ResizeTo() :

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

Consolidation des espaces de noms

Les projets BarCode accumulent des énoncés using Barcoder.* - un par format utilisé. Au cours de la migration, toutes ces traductions se réduisent à un seul using IronBarCode;. Une recherche de using Barcoder dans la solution permettra d'identifier tous les fichiers à mettre à jour. Le nombre de fichiers concernés est généralement plus élevé que prévu par les équipes, car chaque fichier utilisant un format de code-barres importe son propre espace de noms spécifique à ce format.

Modifications du chemin de sortie SVG

Les projets utilisant Barcoder.Renderer.Svg et la classe SvgRenderer remplacent le pipeline de rendu par un appel direct à la méthode GeneratedBarcode :

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

Le paquet Barcoder.Renderer.Svg pourra être supprimé une fois que tous les sites de rendu SVG auront été migrés.