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:

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

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

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 .LIC-Datei fehlt, der Pfad falsch ist oder die Dateiberechtigungen fehlerhaft sind, wird die Lizenzinitialisierung fehlschlagen und sich als Ausnahme beim Start zeigen.

Detaillierter Funktionsvergleich

LEADTOOLS-Ansatz

LEADTOOLS-Lizenzierung erfordert eine .LIC-Datei, die physisch auf dem Dateisystem an einem bekannten Pfad vorhanden ist, sowie einen Entwickler-Schlüsselstring, der an RasterSupport.SetLicense übergeben wird. Nach dem Aufruf von SetLicense muss die Anwendung überprüfen, dass die Lizenz nicht abgelaufen ist und dass jede Barcode-Funktion einzeln freigeschaltet ist. Erst nachdem alle Prüfungen bestanden sind, kann ein BarcodeEngine-Objekt erstellt werden:

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

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

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 .LIC-Datei muss in jeder Umgebung, in der die Anwendung läuft, bereitgestellt werden: Entwicklerrechner, CI-Build-Agents, Staging-Server und Produktionshosts.

IronBarcode Ansatz

Die Lizenzinitialisierung von IronBarcode besteht aus einer einzigen Zeile:

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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 Lizenz-Einrichtung und Bereitstellungsoptionen deckt die Dokumentation alle Muster ab: Umgebungsvariablen, appsettings.json, Azure Key Vault und mehr.

LEADTOOLS-Ansatz

LEADTOOLS-Docker-Bereitstellung erfordert das Kopieren der .LIC-Datei in das Container-Image oder das Montieren zur Laufzeit als Volume:

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 .LIC-Datei einchecken oder sie zur Build-Zeit aus einem base64-verschlüsselten Geheimnis dekodieren. Kubernetes Geheimnisse, die für Schlüssel-Wert-Zeichenfolgenpaare entwickelt wurden, müssen jetzt Dateiinhalte 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

LEADTOOLS-Lesen erfordert die Erstellung einer RasterCodecs-Instanz, um das Bild zu laden, einer BarcodeEngine-Instanz, um es zu scannen, und eines expliziten Arrays von BarcodeSymbology-Werten, das angibt, nach welchen Formaten gesucht werden soll. Wird eine Symbologie aus dem Array weggelassen, erkennt LEADTOOLS Barcodes dieses Typs nicht:

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

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

using IronBarCode;

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

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 Barcodeerzeugung von LEADTOOLS erfordert die Erstellung eines BarcodeData-Objekts mit Symbologie, Wert und Begrenzungen - dann die Erstellung einer leeren RasterImage mit expliziten Pixeldimensionen, Farbtiefe, Byte-Reihenfolge und Blickwinkel - dann Füllen mit einem weißen Hintergrund mit FillCommand - dann Aufrufen von engine.Writer.WriteBarcode() - dann Speichern mit RasterCodecs. Das sind fünf verschiedene Operationen über mehrere Objekttypen hinweg:

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

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:

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

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

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. Jede neue Containerinstanz, jede neue Cloud-Region und jede neue Umgebung muss die .LIC-Datei bereitgestellt und zugänglich haben, bevor die Anwendung starten wird. 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. Entwicklungslizenzen beginnen bei etwa 1.469 USD pro Entwickler pro Jahr, aber Lizenzkosten für die Produktion von Serveranwendungen werden gesondert ü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 COPY LEADTOOLS.LIC-Zeile 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 BarCode

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 BarCode