LEADTOOLS BarCode vs IronBarcode: C# Barcode-Bibliothek im Vergleich

Die dateibasierte Lizenzarchitektur

Für die Initialisierung von LEADTOOLS sind ungefähr 20 Codezeilen erforderlich, bevor die erste Barcode-Operation ausgeführt werden kann. Die Sequenz umfasst die Auflösung von Dateipfaden, die Überprüfung des Ablaufdatums und die Sperrprüfung pro Funktion:

// LEADTOOLS: 20+Zeilen before the first barcode operation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

// LEADTOOLS: 20+Zeilen before the first barcode operation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

Imports Leadtools
Imports Leadtools.Barcode

' LEADTOOLS: 20+Zeilen before the first barcode operation
RasterSupport.SetLicense("C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC", "your-developer-key-here")

If RasterSupport.KernelExpired Then
    Throw New InvalidOperationException("LEADTOOLS license has expired")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) Then
    Throw New InvalidOperationException("2D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) Then
    Throw New InvalidOperationException("Barcode writing is locked")
End If

Dim engine As New BarcodeEngine()

Dieser Initialisierungsblock muss erfolgreich ausgeführt werden, bevor jegliche Barcode-Lese- oder Schreibvorgänge funktionieren. Wenn die Datei .LIC fehlt, der Pfad falsch ist oder die Dateiberechtigungen nicht stimmen, wird LEADTOOLS nicht initialisiert – nicht stillschweigend, sondern mit einem Fehler, der den Vorgang abbricht.

Detaillierter Funktionsvergleich

LEADTOOLS-Ansatz

Für die LEADTOOLS-Lizenzierung ist eine .LIC-Datei erforderlich, die physisch auf dem Dateisystem unter einem bekannten Pfad vorhanden ist, Plus ein Entwicklerschlüssel, der an RasterSupport.SetLicense übergeben wird. Nach dem Aufruf von SetLicense muss die Anwendung überprüfen, ob die Lizenz noch gültig ist und ob jede Barcode-Funktion einzeln freigeschaltet ist. Erst wenn alle Prüfungen erfolgreich waren, kann ein BarcodeEngine erstellt werden:

// LEADTOOLS: 20+Zeilen before the first barcode operation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

// LEADTOOLS: 20+Zeilen before the first barcode operation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

Imports Leadtools
Imports Leadtools.Barcode

' LEADTOOLS: 20+Zeilen before the first barcode operation
RasterSupport.SetLicense("C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC", "your-developer-key-here")

If RasterSupport.KernelExpired Then
    Throw New InvalidOperationException("LEADTOOLS license has expired")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) Then
    Throw New InvalidOperationException("2D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) Then
    Throw New InvalidOperationException("Barcode writing is locked")
End If

Dim engine As New BarcodeEngine()

Dieses dateibasierte Modell stammt aus der Zeit vor modernen Systemen zur Geheimnisverwaltung. Die Datei .LIC muss auf jeder Umgebung bereitgestellt werden, in der die Anwendung ausgeführt wird: Entwicklerrechner, CI-Build-Agenten, Staging-Server und Produktionshosts.

IronBarcode Ansatz

Die Lizenzinitialisierung von IronBarcode besteht aus einer einzigen Zeile:

// IronBarcode: done
IronBarCode.License.LicenseKey = "YOUR-KEY";

// IronBarcode: done
IronBarCode.License.LicenseKey = "YOUR-KEY";

Dieser Schlüssel kann aus einer Umgebungsvariablen, einer Konfigurationsdatei oder einem Geheimnismanager stammen – überall dort, wo eine Zeichenkette herkommen kann. Es gibt keine Datei zu suchen, keine Ablaufprüfung durchzuführen und keine Funktionssperre zu überprüfen. Für die Lizenzeinrichtung und die Bereitstellungsoptionen deckt die Dokumentation alle Muster ab: Umgebungsvariablen, appsettings.json, Azure Key Vault und mehr.

LEADTOOLS-Ansatz

Für die Docker-Bereitstellung von LEADTOOLS muss die Datei .LIC in das Container-Image kopiert oder zur Laufzeit als Volume eingebunden werden:

FROM mcr.microsoft.com/dotnet/aspnet:8.0

WORKDIR /app
COPY publish/ .

# The license file must be physically present in the container
COPY LEADTOOLS.LIC /app/license/LEADTOOLS.LIC

ENV LEADTOOLS_LICENSE_PATH=/app/license/LEADTOOLS.LIC
ENV LEADTOOLS_DEVELOPER_KEY=your-developer-key

ENTRYPOINT ["dotnet", "YourApp.dll"]

Dieser Ansatz hat Folgekomplikationen. Das Rotieren oder Widerrufen eines Lizenzschlüssels erfordert das Neuerstellen des Images oder das erneute Einbinden des Volumes. Die CI/CD-Pipeline muss entweder die Datei .LIC einchecken oder sie zur Build-Zeit aus einem Base64-kodierten Secret dekodieren. Kubernetes-Secrets, die für Schlüssel-Wert-Paare konzipiert sind, müssen nun den Dateiinhalt speichern. Teams, die mit kurzlebigen Containern arbeiten, müssen das Problem der Dateibereitstellung auf jedem neuen Knoten lösen.

IronBarcode Ansatz

IronBarcode benötigt keine Datei im Container:

FROM mcr.microsoft.com/dotnet/aspnet:8.0

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

ENTRYPOINT ["dotnet", "YourApp.dll"]

Das Modell der Umgebungsvariablen funktioniert nativ mit Docker Secrets, Kubernetes Secrets, AWS Secrets Manager, Azure Key Vault und HashiCorp Vault – also mit jedem System, das eine Zeichenkette in die Umgebung eines Containers einfügen kann. Es gibt einen vollständigen Docker- und Linux-Bereitstellungsleitfaden, der sowohl Alpine- als auch Debian-Basisimages abdeckt.

LEADTOOLS-Ansatz

Zum Lesen von LEADTOOLS ist es erforderlich, eine RasterCodecs-Instanz zum Laden des Bildes, eine BarcodeEngine-Instanz zum Scannen und ein explizites Array von BarcodeSymbology-Werten zu erstellen, die angeben, nach welchen Formaten gesucht werden soll. Wird eine Symbologie aus dem Array weggelassen, erkennt LEADTOOLS Barcodes dieses Typs nicht:

// LEADTOOLS: codec, engine, explicit symbology list
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load(imagePath);
var engine = new BarcodeEngine();

var symbologies = new[]
{
    BarcodeSymbology.Code128,
    BarcodeSymbology.QR,
    BarcodeSymbology.DataMatrix,
    BarcodeSymbology.EAN13,
    BarcodeSymbology.UPCA
};

var barcodes = engine.Reader.ReadBarcodes(
    image,
    LogicalRectangle.Empty,
    0,
    symbologies);

return barcodes.Select(b => b.Value).ToArray();

// LEADTOOLS: codec, engine, explicit symbology list
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load(imagePath);
var engine = new BarcodeEngine();

var symbologies = new[]
{
    BarcodeSymbology.Code128,
    BarcodeSymbology.QR,
    BarcodeSymbology.DataMatrix,
    BarcodeSymbology.EAN13,
    BarcodeSymbology.UPCA
};

var barcodes = engine.Reader.ReadBarcodes(
    image,
    LogicalRectangle.Empty,
    0,
    symbologies);

return barcodes.Select(b => b.Value).ToArray();

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim barcodes As IEnumerable(Of BarcodeData)
Using codecs As New RasterCodecs()
    Using image As RasterImage = codecs.Load(imagePath)
        Dim engine As New BarcodeEngine()

        Dim symbologies As BarcodeSymbology() = {
            BarcodeSymbology.Code128,
            BarcodeSymbology.QR,
            BarcodeSymbology.DataMatrix,
            BarcodeSymbology.EAN13,
            BarcodeSymbology.UPCA
        }

        barcodes = engine.Reader.ReadBarcodes(
            image,
            LogicalRectangle.Empty,
            0,
            symbologies)
    End Using
End Using

Return barcodes.Select(Function(b) b.Value).ToArray()

IronBarcode Ansatz

IronBarcode erkennt automatisch Formate in allen über 50 unterstützten Symbologien. Der Dateipfad wird direkt übergeben; Es wird keine Bildladeschicht oder Symbolisierungsmatrix benötigt:

// IronBarcode: auto-detect, no object setup
using IronBarCode;

var results = BarcodeReader.Read(imagePath);
return results.Select(r => r.Value).ToArray();

// IronBarcode: auto-detect, no object setup
using IronBarCode;

var results = BarcodeReader.Read(imagePath);
return results.Select(r => r.Value).ToArray();

Imports IronBarCode

Dim results = BarcodeReader.Read(imagePath)
Return results.Select(Function(r) r.Value).ToArray()

Weitere Details zu Leseoptionen, der Abstimmung von Geschwindigkeit und Genauigkeit sowie dem Umgang mit schwierigen Bildern finden Sie im Leitfaden zum Lesen von Barcodes aus Bildern, der die gesamte API abdeckt.

LEADTOOLS-Ansatz

Die Barcode-Generierung von LEADTOOLS erfordert das Erstellen eines BarcodeData-Objekts mit Symbolik, Wert und Grenzen — anschließend das Erstellen eines leeren RasterImage-Objekts mit expliziten Pixelabmessungen, Bittiefe, Byte-Reihenfolge und Ansichtsperspektive — anschließend das Füllen mit einem weißen Hintergrund mithilfe von FillCommand — dann den Aufruf von engine.Writer.WriteBarcode() — und schließlich das Speichern mit RasterCodecs. Das sind fünf verschiedene Operationen über mehrere Objekttypen hinweg:

// LEADTOOLS: 5 operations, 25+lines
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData(BarcodeSymbology.Code128)
{
    Value = data,
    Bounds = new LeadRect(0, 0, 400, 100)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, barcodeData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, outputPath, RasterImageFormat.Png, 0);

// LEADTOOLS: 5 operations, 25+lines
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData(BarcodeSymbology.Code128)
{
    Value = data,
    Bounds = new LeadRect(0, 0, 400, 100)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, barcodeData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, outputPath, RasterImageFormat.Png, 0);

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim engine As New BarcodeEngine()

Dim barcodeData As New BarcodeData(BarcodeSymbology.Code128) With {
    .Value = data,
    .Bounds = New LeadRect(0, 0, 400, 100)
}

Using image As New RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    Nothing, IntPtr.Zero, 0)

    Dim fillCommand As New FillCommand(RasterColor.White)
    fillCommand.Run(image)
    engine.Writer.WriteBarcode(image, barcodeData, Nothing)

    Using codecs As New RasterCodecs()
        codecs.Save(image, outputPath, RasterImageFormat.Png, 0)
    End Using
End Using

IronBarcode Ansatz

IronBarcode übernimmt die Bilderstellung, das Ausfüllen des Hintergrunds und die Kodierung intern:

// IronBarcode: one method chain
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

// IronBarcode: one method chain
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

Imports IronBarcode

BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng(outputPath)

Für die Erstellung von Barcode-Bildern bietet die IronBarcode API Styling, Ränder, Drehung und Formatkonvertierung über eine flüssige Kette anstelle einer Reihe imperativer Setup-Objekte.

Container- und Cloud-Bereitstellung

Teams, die Workloads in Docker-, Kubernetes- oder serverlose Umgebungen migrieren, stoßen auf das dateibasierte Lizenzierungsmodell als konkretes operatives Problem. Für jede neue Containerinstanz, jede neue Cloud-Region und jede neue Umgebung muss die Datei .LIC bereitgestellt und zugänglich sein, bevor die Anwendung gestartet werden kann. Geheimnisverwaltungssysteme, die für Geheimnisse mit Zeichenkettenwerten ausgelegt sind, können dateibasierte Artefakte nicht problemlos verarbeiten. Teams, die die Konfiguration standardmäßig über die Einbindung von Umgebungsvariablen durchführen, stellen fest, dass LEADTOOLS einen separaten Bereitstellungsschritt erfordert, der außerhalb ihres normalen Secrets-Workflows liegt. Wenn das Bereitstellungsvolumen wächst – automatische Skalierung, Blue-Green-Bereitstellung, regionsübergreifende Replikation – steigen auch die Betriebskosten für die Dateibereitstellung.

SDK-Footprint und Abhängigkeitsmanagement

Wenn das Lesen oder Generieren von Barcodes die primäre oder einzige Anforderung eines Dienstes ist, stellen die Installation von LEADTOOLS aus fünf Paketen und die Abhängigkeit von der MSVC++ 2017 Runtime einen Overhead dar, der sich auf die Größe des Container-Images, die Kaltstartlatenz in serverlosen Funktionen und die Build-Zeiten in CI/CD-Pipelines auswirkt. Teams, die leichtgewichtige Microservices oder Lambda-ähnliche Funktionen entwickeln, stellen fest, dass die Einbindung eines kompletten Imaging-SDKs zur Erfüllung einer barcodespezifischen Anforderung eine Abhängigkeitsfläche schafft, die sich in Code-Reviews und Architektur-Reviews nur schwer rechtfertigen lässt. Wenn für ein zukünftiges Plattform-Upgrade das Testen einer Änderung der nativen Laufzeitabhängigkeit erforderlich ist, fällt diese Aufgabe dem Team zu, das den Dienst betreut.

Preistransparenz

Entwicklungsteams, die ein Projekt vor Beginn der Entwicklung budgetieren müssen, können sich anhand der veröffentlichten Preisliste von LEADTOOLS kein vollständiges Kostenbild verschaffen. Die Entwicklungslizenzen kosten zwischen 1.295 und 1.469 US-Dollar pro Entwickler und Jahr, die Lizenzen für den Produktionseinsatz von Serveranwendungen werden jedoch separat über den Vertrieb angeboten. Ein Team von fünf Entwicklern, die auf drei Produktionsservern arbeiten, muss ein individuelles Angebot einholen, bevor es bestätigen kann, dass LEADTOOLS in sein Budget passt. Teams, die Beschaffungsentscheidungen lieber auf Basis veröffentlichter Preise treffen – Optionen vergleichen, interne Genehmigungen einholen oder mehrjährige Budgets planen –, stellen fest, dass dieses Modell ein Verkaufsgespräch erfordert, bevor die Bewertung abgeschlossen ist.

Anforderungen für ausschließliche Barcode-Nutzung

Anwendungen, die Barcodes lesen oder generieren müssen, ohne OCR, DICOM-Bildverarbeitung, Dokumentenannotation oder andere Funktionen der LEADTOOLS- Suite zu benötigen, zahlen für eine breitere Plattform, als ihre Anforderungen erfordern. Der Integrationswert von LEADTOOLS – die Möglichkeit, Daten zwischen den Modulen für OCR, Barcode und Dokumentenverarbeitung auszutauschen – ist real, kommt aber nur dann zum Tragen, wenn mehrere Funktionen aus dieser Suite aktiv genutzt werden. Wenn die Anforderung auf das Scannen von Barcodes in einer Web-API oder die Generierung in einer Dokumentenverarbeitungspipeline beschränkt ist, erfüllt eine spezialisierte Barcode-Bibliothek die Anforderung direkt, ohne die Last einer umfassenden Bildverarbeitungsplattform mit sich zu tragen.

Ersatz für die Lizenzinitialisierung

Der gesamte Initialisierungsblock von LEADTOOLS – Dateipfad, Ablaufprüfung und Überprüfung der Sperre pro Funktion – wird durch eine einzige Zeile ersetzt. Der IronBarcode Lizenzschlüssel kann in jedem Geheimnisverwaltungssystem gespeichert werden, das Zeichenketten speichert.

// Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

// Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

' Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

Docker-Umgebungsvariablenmuster

Die Zeile COPY LEADTOOLS.LIC in jeder Dockerfile wird vollständig entfernt. Die Lizenz wird zur Laufzeit über eine Umgebungsvariable bereitgestellt, die mit allen gängigen Mechanismen zur Geheimnisinjektion kompatibel ist:

# Remove: COPY LEADTOOLS.LIC /app/license/LEADTOOLS.LIC
# Remove: ENV LEADTOOLS_LICENSE_PATH=/app/license/LEADTOOLS.LIC
# Add:
ENV IRONBARCODE_LICENSE=your-license-key

Paketabholung

Die fünf LEADTOOLS-Pakete – und der optionale PDF-Codec – werden entfernt und durch ein einziges Paket ersetzt:

dotnet remove package Leadtools.Barcode
dotnet remove package Leadtools
dotnet remove package Leadtools.Codecs
dotnet remove package Leadtools.Codecs.Png
dotnet remove package Leadtools.Codecs.Jpeg
# If added:
dotnet remove package Leadtools.Codecs.Pdf

dotnet add package IronBarcode

dotnet remove package Leadtools.Barcode
dotnet remove package Leadtools
dotnet remove package Leadtools.Codecs
dotnet remove package Leadtools.Codecs.Png
dotnet remove package Leadtools.Codecs.Jpeg
# If added:
dotnet remove package Leadtools.Codecs.Pdf

dotnet add package IronBarcode