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 :

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);

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éen pour includeChecksum, QrEncoder.Encode prend un niveau de correction d'erreur et deux booléens supplémentaires, et DataMatrixEncoder.Encode ne prend que la chaîne. 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. Changer de formats signifie ajouter une nouvelle directive using et utiliser une classe différente avec une signature de méthode différente :

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

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

// DataMatrix
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

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

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

// DataMatrix
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
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix
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 route toute la sélection de formats à travers l'énum BarcodeEncoding dans 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated 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-LICENSE-KEY";

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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. Sauvegarder dans un fichier nécessite l'ouverture d'un FileStream. Obtenir des données binaires nécessite l'ouverture d'un MemoryStream et l'appel de ToArray(). Chaque scénario de sortie nécessite la construction d'un moteur de rendu avec un objet d'options :

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' File output
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})
Using stream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Binary data via MemoryStream
Using ms = 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, pas une spécification directe de largeur et de hauteur.

Approche IronBarcode

IronBarcode retourne un objet GeneratedBarcode à partir duquel toute forme de sortie peut être atteinte par des appels de méthode 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 s'enchaîne avec toute 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 nativement les fichiers image, les tableaux de bytes, les flux et les PDFs :

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 natively
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 natively
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 natively
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é le support .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

Avec Barcoder et Barcoder.Renderer.Image versionnés indépendamment, mettre à jour l'un sans l'autre lors d'un rafraîchissement de dépendance peut introduire des incompatibilités subtiles. 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 un changement de valeur enum BarcodeEncoding 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 IBarcode au GeneratedBarcode Changement de Type

Le code codeur à barres qui stocke une variable IBarcode et la passe à un renderer plus tard doit être refactorisé. Dans IronBarcode, GeneratedBarcode porte ses propres méthodes de sortie — il n'y a pas de phase 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 émerger chaque emplacement qui nécessite une mise à jour lors de la compilation — IBarcode ne résoudra pas après que les packages codeur à barres ont été supprimés.

PixelSize N'a Pas d'Équivalent Direct

L'PixelSize de codeur à barres est un multiplicateur d'échelle sur la taille naturelle du module du code-barres, pas une dimension de pixel explicite. 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 de pixels explicites. Pendant la migration, mesurez les dimensions de sortie réelles que le code codeur à barres 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 codeur à barres accumulent des instructions using Barcoder.* — une par format utilisé. Pendant la migration, toutes ces instructions se réduisent à une seule using IronBarCode;. Une recherche de using Barcoder à travers la solution identifiera chaque fichier nécessitant une mise à 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 renderer par un appel de méthode direct sur 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 package Barcoder.Renderer.Svg peut être retiré une fois que tous les sites de rendu SVG ont été migrés.