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

Le flux de travail standard de génération BarcodeLibnécessite de créer une instance, de configurer des propriétés, et d'appeler Encode() avec des dimensions :

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

Imports BarcodeStandard
Imports SkiaSharp

Dim b As New Barcode()
b.IncludeLabel = True
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Using stream = File.OpenWrite("barcode.png")
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
End Using

Voici le flux de travail de génération complet. Le modèle d'affectation de propriétés est la conception : la configuration se fait sur l'instance avant l'appel Encode(), et la valeur de retour est un SKImage qui doit être encodé et écrit dans un flux.

Comparaison détaillée des fonctionnalités

Approche BarcodeLib

BarcodeLib nécessite de construire une instance et de définir des propriétés avant d'appeler Encode() avec des dimensions. La sortie est un SKImage :

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

Imports BarcodeStandard
Imports SkiaSharp

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100)

    Using ms As New MemoryStream()
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
        Return ms.ToArray()
    End Using
End Function

Le type de retour SKImage signifie que la sortie de tableau d'octets nécessite un appel d'encodage SKEncodedImageFormat et un MemoryStream. La propriété IncludeLabel est un interrupteur boolean — BarcodeLibrend 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)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

Imports IronBarCode

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

.ToPngBinaryData() retourne directement le tableau d'octets — pas d'objet Image ou MemoryStream intermédiaire. .AddBarcodeValueTextBelowBarcode() rend la chaîne de données encodée comme étiquette 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(). 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 :

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

Imports BarcodeStandard
Imports SkiaSharp

Dim b = New Barcode()

' There is no Decode, Scan, or Read method on Barcode.
' b.Decode("barcode.png")      ' does not exist
' b.Scan("barcode.png")        ' does not exist
' b.ReadBarcode("barcode.png") ' does not exist

' The only public operation is generation:
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

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 d'image, 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 d'ajuster les performances de scan pour les scénarios à haut volume. 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 comme backend graphique pour remplacer System.Drawing.Common, devenu exclusif à Fenêtresaprès .NET 6. BarcodeLib3.1.5 déclare SkiaSharp >= 2.88.8. Si un projet utilise déjà SkiaSharp via une autre dépendance — courant dans les projets MAUI utilisant SkiaSharp.Views.Maui et Microsoft.Maui.Graphics, qui tendent vers SkiaSharp 3.x — les versions résolues peuvent ne pas converger. Le résultat est au minimum un avertissement NU1608 et au pire un échec de liaison d'assembly lors de l'exécution :

warning NU1608: Detected package version outside of dependency constraint:
BarcodeLib 3.1.5 requires SkiaSharp (>= 2.88.8) but
version SkiaSharp 3.116.1 was resolved.

Forcer une résolution via des références de package explicites est une option, bien que cela ne garantisse pas la compatibilité à l'exécution :

<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 substituts explicites, la compatibilité dépend du fait que les appels d'API internes de BarcodeLibcorrespondent à ce que la version résolue de SkiaSharp expose. En tant que projet maintenu par la communauté, BarcodeLibn'a pas de contrat de support commercial attaché à son rythme de sortie.

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 investiguent, identifient le désaccord de version entre l'intervalle SkiaSharp attendu par BarcodeLibet la version requise par MAUI, ajoutent des remplacements explicites <PackageReference> pour forcer une résolution, et réussissent à valider la build. 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 nativement : BarcodeReader.Read("file.pdf") parcourt chaque page et renvoie tous les codes-barres détectés sans étape de rendu intermédiaire.

Option de code QR ou autre symbologie 2D apparaît

Les projets qui nécessitaient initialement uniquement des codes-barres linéaires évoluent souvent pour nécessiter une sortie en code QR, Data Matrix, PDF417, ou Aztec. BarcodeLibne génère aucune symbologie 2D dans sa série 3.x — l'énumération BarcodeStandard.Type ne contient aucun code QR ou autre entrée 2D — donc toute exigence 2D signifie ajouter une seconde bibliothèque ou remplacer BarcodeLibcomplètement. Les QRCodeWriter et BarcodeWriter d'IronBarcode couvrent le code QR (avec intégration de logo, contrôle de couleur, et réglage de correction d'erreurs), Data Matrix, PDF417, et Aztec via la même API fluide. Les équipes dont les exigences de symbologie passent en 2D trouvent que l'écart motive la décision de migration.

API d'instance vers API Fluent statique

Le code BarcodeLibutilise un modèle d'objet mutable : créez une instance Barcode, définissez des propriétés, appelez Encode(). Code-barres IronBarcode utilise un modèle fluide statique : appelez BarcodeWriter.CreateBarcode(), chaînez les méthodes de configuration, terminez par une méthode de sortie. Le code existant qui stocke une instance Barcode comme champ ou la transmet entre méthodes nécessitera une restructuration. 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)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

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

' The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .AddBarcodeValueTextBelowBarcode() _
    .SaveAsPng(outputPath)

SKImage à sortie directe

BarcodeLib 3.x retourne SKImage, qui nécessite SKEncodedImageFormat et un flux pour produire des octets. Tout code typé à SKImage ou passant par image.Encode(...).SaveTo(stream) nécessitera une mise à jour. La chaîne fluide d'IronBarcode se termine directement par le format de sortie souhaité — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — éliminant le besoin de l'objet image intermédiaire et de l'étape d'encodage en flux.

Type Enum à Enum BarcodeEncoding

BarcodeLib 3.x utilise l'énumération BarcodeStandard.Type avec des valeurs PascalCase telles que BarcodeStandard.Type.Code128. Code-barres IronBarcode utilise l'énumération BarcodeEncoding avec des valeurs telles que BarcodeEncoding.Code128. Les valeurs 1D se mappent directement : Code128 → Code128, Ean13 → EAN13, UpcA → UPCA, Code39 → Code39. Un grep pour BarcodeStandard.Type. à travers les fichiers .cs identifie toutes les occurrences nécessitant une mise à jour.

Nettoyage de référence SkiaSharp

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