Der Workflow zur Generierung mehrerer Pakete

Die Installationsgeschichte verdeutlicht unmittelbar den Unterschied im Umfang. Mit BarCodewerden für die grundlegende PNG-Ausgabe zwei separate Pakete benötigt:

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

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

Der vollständige Workflow zum Generieren eines Code128-Barcodes und zum Speichern als PNG erfordert drei Namespace-Importe, einen formatspezifischen Encoder-Aufruf, eine Renderer-Konstruktion mit einem Optionsobjekt, einen Dateistream und einen Render-Aufruf:

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

Das Umschalten des Barcode-Formats ist keine Parameteränderung – es erfordert den Import eines anderen Namensraums und den Aufruf einer anderen Klasse. Code128Encoder.Encode nimmt einen booleschen Wert für includeChecksum, QrEncoder.Encode nimmt ein Fehlerkorrektur-Level und zwei zusätzliche boolesche Werte, und DataMatrixEncoder.Encode nimmt nur den String. Es gibt keine einheitliche Schnittstelle zum Erstellen eines Barcodes in einem bestimmten Format.

Detaillierter Funktionsvergleich

Barcoder-Ansatz

Barcoder leitet die Formatauswahl über separate Encoder-Klassen in separaten Namensräumen. Formats wechseln bedeutet, eine neue using Direktive hinzuzufügen und eine andere Klasse mit einer anderen Methodensignatur zu verwenden:

// 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")

Jeder Encoder hat seinen eigenen Parametervertrag. Das Hinzufügen eines neuen Formats zu einem bestehenden Projekt ist keine Ein-Wort-Änderung – es erfordert den Import eines neuen Namespace, das Erlernen einer neuen Klasse und das Verstehen neuer Parameter.

IronBarcode Ansatz

IronBarcode leitet alle Formatauswahlen durch das BarcodeEncoding Enum in der vereinheitlichten BarcodeWriter Klasse. Das Hinzufügen eines neuen Formats besteht aus einer Änderung des Enum-Werts um ein einziges Wort:

// 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")

Für den Produktiveinsatz muss der Lizenzschlüssel beim Start der Anwendung hinzugefügt werden:

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

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

Imports IronBarCode

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

Die IronBarcode Dokumentation zur Barcode-Generierung deckt das gesamte Spektrum der Generierungsoptionen ab, einschließlich Stil, Ränder und Farbanpassung.

Barcoder-Ansatz

Die Trennung von Kodierung und Darstellung bei BarCodeist zwar als Architekturprinzip begründet, führt aber bei jeder Änderung des Ausgabeformats zu Mehraufwand. Ein Dateispeichern erfordert das Öffnen eines FileStream. Um Binärdaten zu erhalten, muss ein MemoryStream geöffnet und ToArray() aufgerufen werden. Für jedes Ausgabeszenario ist die Erstellung eines Renderers mit einem Optionsobjekt erforderlich:

// 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

Größenkontrolle ist indirekt: PixelSize ist ein Skaliermultiplikator auf die Barcode-Modulgröße, keine direkte Breiten- und Höhenangabe.

IronBarcode Ansatz

IronBarcode gibt ein GeneratedBarcode Objekt zurück, von dem aus jede Ausgabeform durch verkettete Methodenaufrufe erreicht werden kann. Keine Renderer-Konstruktion, kein Stream-Management:

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) nimmt explizite Pixelabmessungen an und linkt mit jeder Ausgabemethode auf demselben Objekt.

Barcoder-Ansatz

Barcoder besitzt keine Lese- oder Dekodierungsfunktion. Es gibt keine API, keine geplante API und keine Umgehungslösung innerhalb der Bibliothek. Wenn eine Anwendung Barcodes lesen muss, muss neben BarCodeeine zweite Bibliothek hinzugefügt werden – eine separate NuGet Abhängigkeit mit eigener API-Oberfläche und eigener Versionsverwaltung. Das bedeutet mindestens zwei lesenahe Abhängigkeiten: BarCodefür die Generierung und etwas anderes zum Lesen.

IronBarcode Ansatz

IronBarcode deckt sowohl die Generierung als auch das Lesen mit demselben Paket und einheitlichen API-Mustern ab. Die BarcodeReader.Read() Methode akzeptiert Bilddateien, Byte-Arrays, Streams und PDFs nativ:

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

// Aus PDF lesen 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);
}

// Aus PDF lesen 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

' Aus PDF lesen 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)

Das Einlesen von PDFs erfolgt nativ – es ist keine Zwischenabfrage der Bildextraktion, keine Konvertierungsbibliothek und kein zusätzliches Paket erforderlich. Die IronBarcode Dokumentation zum Barcode-Lesen behandelt mehrseitige PDFs, das Lesen von Bereichen von Interesse und die Leistungsoptimierung.

Lesen wird als zusätzliche Anforderung gefordert

Viele Projekte beginnen als reine Generierungspipelines – Etiketten drucken, Codes für Dokumente generieren, Barcodes in Berichte einbetten. BarCodeunterstützt diese Projekte von Anfang an. Wenn dieselbe Anwendung später eingehende Barcodes überprüfen, gescannte Dokumente verarbeiten oder Barcodes aus hochgeladenen PDFs dekodieren muss, bietet BarCodekeine Lösung. Das Team muss eine zweite Bibliothek evaluieren, deren API erlernen, deren NuGet Version separat verwalten und die Integrationsschnittstelle zwischen den beiden Bibliotheken handhaben. Teams, die diesen Punkt erreichen, greifen häufig auf eine Bibliothek zurück, die beide Seiten abdeckt, anstatt zwei separate Barcode-Abhängigkeiten zu pflegen.

Der Kompatibilitätsbruch des .NET Framework

Barcoder.Renderer.Image ließ .NET FrameworkUnterstützung fallen. Teams, die Dienste oder Desktop-Anwendungen auf Basis des .NET Framework4.x pflegen und das Image-Renderer-Paket im Rahmen der routinemäßigen Abhängigkeitswartung aktualisieren, stoßen auf einen Build-Fehler. Dies ist keine Fehlkonfiguration – es handelt sich um eine Entscheidung der Bibliothek zur Plattformunterstützung. IronBarcode unterstützt .NET Framework4.6.2 bis .NET 9ohne spezielle Paketierung oder bedingte Abhängigkeiten für verschiedene Zielplattformen.

Versionsabweichungen bei Paketen verursachen Koordinationsprobleme

Da Barcoder und Barcoder.Renderer.Image unabhängig versioniert werden, kann das Aktualisieren eines ohne das andere während einer Abhängigkeitsaktualisierung subtile Inkompatibilitäten einführen. In einem Repository mit mehreren Projekten – von denen jedes eine andere Version jedes Renderer-Pakets verwendet – wird die Gewährleistung eines einheitlichen Verhaltens über alle Projekte hinweg zu einem Koordinationsproblem, das mit der Größe des Teams zunimmt. Teams, die auf IronBarcode umsteigen, berichten, dass die Verwaltung eines einzigen Pakets und einer einzigen Version diese Problemkategorie vollständig beseitigt.

Die Formatabdeckung erweitert sich im Laufe der Zeit

Ein Projekt könnte mit Code128-Etiketten beginnen und später QR-Codes für kundenorientierte Links hinzufügen, dann DataMatrix für die Einhaltung von Vorschriften. Bei BarCodebedeutet jede Formaterweiterung einen neuen Namespace-Import, eine andere Encoder-Klasse mit anderen Methodenparametern und möglicherweise ein neues NuGet Paket. Mit IronBarcode ist das Hinzufügen eines Formats eine Änderung des BarcodeEncoding Enum-Wertes in einem bestehenden Aufruf. Teams, deren Roadmap die Erweiterung der Barcode-Formatabdeckung vorsieht, finden das auf Enumerationen basierende Modell deutlich einfacher zu pflegen.

MAUI- und plattformübergreifende Bereitstellungsanforderungen

Barcoder dokumentiert keine Unterstützung für MAUI-, Docker-, AWS Lambda- oder Azure-Bereitstellungen. Teams, die plattformübergreifende MAUI-Anwendungen entwickeln oder die Barcode-Verarbeitung auf serverloser Infrastruktur implementieren, stellen fest, dass die Dokumentation und die Tests von BarCodediese Ziele nicht abdecken. IronBarcode dokumentiert und testet aktiv den Einsatz auf iOS-, Android-, Windows-, macOS MAUI-Zielen, Docker-Containern und wichtigen Cloud-Plattformen.

Die IBarcode zur GeneratedBarcode Type Change

Barcoder-Code, der eine IBarcode Variable speichert und sie später an einen Renderer übergibt, muss umstrukturiert werden. In IronBarcode trägt GeneratedBarcode eigene Ausgabemethoden — es gibt keinen separaten Renderer-Schritt. Jede Methodensignatur, die derzeit IBarcode akzeptiert, sollte geändert werden, um GeneratedBarcode zu akzeptieren, und der Renderaufruf innerhalb dieser Methode sollte ein direkter Aufruf wie .SaveAsPng() oder .ToPngBinaryData() werden. Das Typsystem wird jeden Ort aufzeigen, der während der Kompilierung aktualisiert werden muss — IBarcode wird nicht mehr aufgelöst, nachdem die Barcoder-Pakete entfernt wurden.

PixelSize Hat Kein Direktes Äquivalent

Barcoder's PixelSize ist ein Skaliermultiplikator auf die natürliche Modulgröße des Barcodes, keine explizite Pixelabmessung. Die Ausgabebreite hängt vom Barcode-Inhalt, dem Format und dem Multiplikator in Kombination ab. IronBarcode verwendet .ResizeTo(width, height) mit expliziten Pixelabmessungen. Während der Migration, messen Sie die tatsächlichen Ausgabeabmessungen, die der bestehende Barcoder-Code erzeugt, und verwenden Sie diese Werte im .ResizeTo() Aufruf:

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

Namensraumkonsolidierung

Barcoder-Projekte sammeln using Barcoder.* Anweisungen — eine pro verwendetes Format. Während der Migration kollabieren alle diese zu einem einzigen using IronBarCode;. Eine Suche nach using Barcoder in der gesamten Lösung identifiziert jede Datei, die aktualisiert werden muss. Die Anzahl der betroffenen Dateien ist in der Regel größer als von den Teams erwartet, da jede Datei, die ein Barcode-Format verwendet, ihren eigenen formatspezifischen Namensraum importiert.

Änderungen des SVG-Ausgabepfads

Projekte, die Barcoder.Renderer.Svg und die SvgRenderer Klasse verwenden, ersetzen die Renderer-Pipeline durch einen direkten Methodenaufruf auf 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")

Das Barcoder.Renderer.Svg Paket kann entfernt werden, sobald alle SVG-Rendering-Stellen migriert wurden.