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

Modèle de génération de base de BarcodeLib

Le flux de travail standard de génération de BarcodeLibnécessite la création d'une instance, la configuration des propriétés et l'appel à Encode() :

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging

Dim b As New Barcode()
b.IncludeLabel = True
b.Width = 300
b.Height = 100
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")
img.Save("barcode.png", ImageFormat.Png)

Voici le flux de travail de génération complet. Le modèle de définition des propriétés est la conception : toute la configuration se fait sur l'instance avant l'appel Encode(), et la valeur de retour est une System.Drawing.Image qui doit être sauvegardée séparément ou convertie en octets.

Comparaison détaillée des fonctionnalités

Approche BarcodeLib

BarcodeLib nécessite la construction d'une instance et la définition de propriétés avant d'appeler Encode(). Le résultat est un objet System.Drawing.Image :

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.IO

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    b.Width = 300
    b.Height = 100
    Dim img As Image = b.Encode(TYPE.CODE128, data)

    Using ms As New MemoryStream()
        img.Save(ms, ImageFormat.Png)
        Return ms.ToArray()
    End Using
End Function

Le type de retour System.Drawing.Image signifie que la sortie d'un tableau d'octets nécessite un intermédiaire MemoryStream. La propriété IncludeLabel est une bascule booléenne - BarcodeLibrend automatiquement la chaîne de données encodée comme l'étiquette visible sous les barres.

Approche IronBarcode

La génération de codes-barres par Code-barres IronBarcode est entièrement statique. Les chaînes de configuration après CreateBarcode(), et les méthodes de sortie terminent la chaîne directement :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddAnnotationTextBelowBarcode(data)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddAnnotationTextBelowBarcode(data)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateCode128(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .AddAnnotationTextBelowBarcode(data) _
        .ToPngBinaryData()
End Function

.ToPngBinaryData() renvoie directement le tableau d'octets - pas d'objet Image ou MemoryStream intermédiaire. .AddAnnotationTextBelowBarcode() prend la chaîne de l'étiquette de manière explicite, ce qui permet de contrôler le texte qui apparaît sous les barres. Pour les scénarios de génération avancés, consultez la documentation sur la génération de codes-barres IronBarcode .

Approche BarcodeLib

BarcodeLib ne possède pas d'API de lecture. Il n'y a pas de méthode Decode(), Scan(), ou ReadBarcode(). Cette absence n'est pas due à une différence de version — la lecture n'a jamais fait partie de la conception de la bibliothèque. Toute tentative d'appel à une méthode de décodage entraîne une erreur de compilation :

// BarcodeLib— reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

// BarcodeLib— reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

Imports BarcodeLib

Dim b As New Barcode()

' This will not compile — there is no Decode or Read method
' Dim value = b.Decode("barcode.png")       ' CS1061: no definition
' Dim value = b.Scan("barcode.png")         ' CS1061: no definition
' Dim value = b.ReadBarcode("barcode.png")  ' CS1061: no definition

' The only thing you can do is generate:
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")  ' this works

Les équipes qui ont besoin à la fois de la génération et de la lecture en parallèle de BarcodeLibdoivent ajouter une deuxième bibliothèque — généralement ZXing .NET — ce qui introduit sa propre charge de gestion des dépendances et une deuxième surface d'API à maintenir.

Approche IronBarcode

BarcodeReader.Read() accepte les fichiers images, les fichiers PDF, les flux et les objets System.Drawing.Bitmap. La lecture d'un fichier PDF ne nécessite aucune bibliothèque supplémentaire :

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

' Read from an image
Dim results = BarcodeReader.Read("barcode.png")
Console.WriteLine(results.First().Value)  ' "PRODUCT-12345"

' Read all barcodes from a PDF — no separate PDF library needed
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

L'énumération ReadingSpeed permet de régler les performances de balayage pour les scénarios à volume élevé. Pour obtenir des conseils sur la configuration de lecture, consultez la documentation de lecture IronBarcode .

Approche BarcodeLib

À partir de BarcodeLib3.x, la bibliothèque a introduit SkiaSharp en tant que backend graphique pour remplacer System.Drawing.Common, qui est devenu exclusivement Fenêtresaprès .NET 6. BarcodeLibse connecte à une gamme spécifique de versions de SkiaSharp. Si un projet utilise déjà SkiaSharp par le biais d'une autre dépendance - ce qui est courant dans les projets MAUI utilisant SkiaSharp.Views.Maui et Microsoft.Maui.Graphics - la version résolue peut se situer en dehors de la plage attendue de BarcodeLib. Le résultat est au minimum un avertissement NU1608 et au pire un échec de liaison d'assembly lors de l'exécution :

Avertissement NU1608 : Version du paquet détectée en dehors des contraintes de dépendance :
BarcodeLib 3.1.5 nécessite SkiaSharp (>= 2.88.7 && < 2.89.0) mais
Le problème lié à la version SkiaSharp 3.116.1 a été résolu.

Forcer la résolution par le biais de références explicites aux paquets ajoute de la complexité sans garantie :

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

Même avec des substitutions explicites, la compatibilité dépend de la correspondance entre les appels d'API internes de BarcodeLibet ceux exposés par la version épinglée. Il n'existe aucun contrat d'assistance garantissant une résolution du problème dans les délais impartis au projet.

Approche IronBarcode

IronBarcode ne partage pas le graphe de dépendances SkiaSharp avec le code de l'application. Il n'y a pas de négociation de version à gérer, pas de NU1608 à diagnostiquer et aucun risque de liaison d'assemblage à l'exécution lié à la résolution de version de SkiaSharp. Les projets MAUI, les projets Blazor et toute autre application dépendant de SkiaSharp peuvent installer Code-barres IronBarcode sans aucun conflit de version. Pour les modèles d'intégration spécifiques à MAUI, consultez la documentation Code-barres IronBarcode MAUI .

Exigence de lecture

Un système qui génère des étiquettes d'expédition depuis des mois se voit confier une nouvelle exigence : l'application doit également traiter les étiquettes retournées par les fournisseurs. L'intégration de l'entrepôt doit analyser les codes-barres figurant sur les manifestes d'expédition entrants. Un système de gestion documentaire doit indexer les codes-barres présents sur les fichiers PDF numérisés. BarcodeLibne répond à aucune de ces exigences : l'API de lecture n'existe pas. L'équipe évalue la possibilité d'ajouter ZXing .NET en plus de BarcodeLib, en tenant compte de la charge de maintenance que représenterait une double bibliothèque et des deux graphes de dépendances distincts, et conclut que la solution la plus simple consiste à utiliser une bibliothèque qui gère à la fois la génération et la lecture via une seule installation NuGet .

Conflit SkiaSharp dans un projet MAUI

Une équipe ajoute BarcodeLibà une application MAUI existante et rencontre immédiatement des avertissements NU1608 lors de la restauration. Ils enquêtent, identifient le décalage de version entre la gamme SkiaSharp attendue de BarcodeLibet la version requise par MAUI, ajoutent des dérogations explicites <PackageReference> pour forcer une résolution, et réussissent à faire passer la compilation. Ils rencontrent alors un plantage lors de l'exécution sur l'appareil lorsque les binaires natifs de SkiaSharp chargent la mauvaise version. La correction nécessite une analyse plus approfondie du journal de liaison de l'assemblage. Passer à Code-barres IronBarcode élimine le conflit à la source, non pas en trouvant une version compatible de SkiaSharp, mais en supprimant complètement la dépendance partagée.

Traitement des codes-barres PDF requis

Les applications qui génèrent des documents PDF avec des codes-barres intégrés (factures, bons de commande, manifestes d'expédition) doivent parfois relire ces codes-barres lors du traitement en aval. BarcodeLibgénère des images de codes-barres mais ne prend pas en charge le format PDF à aucune des deux extrémités. La lecture des codes-barres à partir d'un PDF avec BarcodeLibnécessite d'abord de convertir le PDF en images à l'aide d'une bibliothèque PDF distincte, puis de transmettre ces images à une bibliothèque de lecture distincte. Code-barres IronBarcode gère la chaîne complète de manière native : BarcodeReader.Read("file.pdf") traverse chaque page et renvoie tous les codes-barres détectés sans étape de rendu intermédiaire.

Les fonctionnalités des codes QR dépassent celles de la génération de base.

Les projets qui nécessitaient initialement uniquement la génération de codes QR basiques évoluent souvent vers le besoin d'intégrer un logo, de personnaliser les couleurs ou de configurer le niveau de correction d'erreurs. BarcodeLibsupporte les codes QR à travers TYPE.QR_Codemais ne fournit pas d'options au-delà des propriétés standard Width, Height, et IncludeLabel. Le QRCodeWriter d'IronBarcode expose l'intégration de logos, le contrôle des couleurs et le réglage de la correction des erreurs par le biais de méthodes enchaînées. Les équipes dont les besoins en matière de codes QR dépassent les capacités de l'implémentation de base de BarcodeLibconstatent que ce manque de fonctionnalités est le principal facteur déterminant leur décision de migration.

API d'instance vers API Fluent statique

Le code de BarcodeLibutilise un modèle d'objet mutable : créer une instance Barcode, définir les propriétés, appeler Encode(). Code-barres IronBarcode utilise un modèle statique fluide : appeler BarcodeWriter.CreateBarcode(), enchaîner les méthodes de configuration, terminer par une méthode de sortie. Le code existant qui stocke une instance Barcode en tant que champ ou qui la transmet entre les méthodes devra être restructuré. La modification typique consiste à remplacer le bloc de définition de propriété par une chaîne de méthodes :

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddAnnotationTextBelowBarcode(data)
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddAnnotationTextBelowBarcode(data)
    .SaveAsPng(outputPath);

System.Drawing.Image vers la sortie directe

BarcodeLib renvoie System.Drawing.Image, qui nécessite MemoryStream pour produire des octets. Tout code tapé à Image ou System.Drawing.Image devra être mis à jour. La chaîne fluide d'IronBarcode se termine directement par le format de sortie souhaité - .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() - en supprimant le besoin de l'objet image intermédiaire et de l'étape MemoryStream.

TYPE Enum vers BarcodeEncoding Enum

BarcodeLib utilise la classe TYPE avec des constantes en majuscules telles que TYPE.CODE128. Code-barres IronBarcode utilise l'enum BarcodeEncoding avec des valeurs PascalCase telles que BarcodeEncoding.Code128. Les valeurs correspondent directement. Une recherche de TYPE\. dans les fichiers .cs identifie toutes les occurrences nécessitant une mise à jour, et une recherche et un remplacement systématiques couvrent les formats courants : CODE128 → Code128, EAN13 → EAN13, @@--CODE-25657--@ → UPCA, QR_Code → QRCode.

Nettoyage de référence SkiaSharp

Les projets qui ont ajouté des entrées <PackageReference Include="SkiaSharp"> explicites uniquement pour résoudre les avertissements NU1608 de BarcodeLibpeuvent supprimer ces dérogations après avoir basculé vers IronBarcode. La commande dotnet list package --include-transitive confirme si SkiaSharp est toujours requis par d'autres paquets dans le projet avant de le supprimer.