Die Stateful Reader Architektur

ZXing.Net's BarcodeReader erfordert eine neue Instanz für jeden Thread oder parallele Operation. Das folgende Muster zeigt die minimale korrekte Konfiguration für die gleichzeitige Verarbeitung:

// ZXing.Net: a new reader instance is created per iteration
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

// ZXing.Net: a new reader instance is created per iteration
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

Imports System.Collections.Concurrent
Imports System.Drawing
Imports ZXing

Parallel.ForEach(imagePaths, Sub(path)
    Dim reader = New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    }

    Using bitmap As New Bitmap(path)
        Dim result = reader.Decode(bitmap)

        If result IsNot Nothing Then
            results(path) = result.Text
        End If
    End Using
End Sub)

Das ThreadLocal<BarcodeReader>-Muster verringert die Allokation pro Aufruf, indem eine Instanz pro Thread wiederverwendet wird, fügt jedoch Komplexität bei der Freigabe hinzu. So oder so, Thread-Sicherheit ist die Verantwortung des Anrufers in ZXing.Net.

Detaillierter Funktionsvergleich

ZXing .NET -Ansatz

ZXing.Net's BarcodeReader ist ein zustandsbehaftetes Objekt. Wenn Decode aufgerufen wird, wird der interne Zustand geschrieben. Wenn zwei Threads dieselbe Instanz verwenden, kommt es zu einem Wettlauf um die Schreibvorgänge. Die Ergebnisse sind nicht deterministisch: Sie können ein Ergebnis von einem anderen Bild erhalten, ein Nullwert, wo ein Barcode vorhanden ist, oder eine Ausnahme. Der korrekte Ansatz besteht darin, pro Thread einen Reader zu erstellen – das heißt, jeder parallele oder asynchrone Pfad allokiert einen Reader, konfiguriert ihn, verwendet ihn einmal und verwirft ihn anschließend:

// ZXing.Net: one reader instance per parallel operation
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

// ZXing.Net: one reader instance per parallel operation
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

Imports System.Collections.Concurrent
Imports System.Drawing
Imports ZXing

Parallel.ForEach(imagePaths, Sub(path)
    Dim reader As New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    }

    Using bitmap As New Bitmap(path)
        Dim result = reader.Decode(bitmap)

        If result IsNot Nothing Then
            results(path) = result.Text
        End If
    End Using
End Sub)

Das ThreadLocal<BarcodeReader>-Muster verringert die Allokation pro Aufruf, indem ein Leser pro Thread wiederverwendet wird, fügt jedoch Komplexität bei der Freigabe hinzu und erfordert weiterhin die Formatkonfiguration bei jeder Instanz.

IronBarcode Ansatz

IronBarcode's BarcodeReader.Read ist eine zustandslose statische Methode. Es gibt keine Instanz zum Teilen, keine Instanz zum Isolieren und keinen Konfigurationsstatus zum Schützen. Derselbe Aufruf kann von beliebig vielen gleichzeitig laufenden Threads sicher ausgeführt werden:

// IronBarcode: static method — no instance management
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

Parallel.ForEach(imagePaths, path =>
{
    var result = BarcodeReader.Read(path, options).FirstOrDefault();
    if (result != null)
        results[path] = result.Value;
});

// IronBarcode: static method — no instance management
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

Parallel.ForEach(imagePaths, path =>
{
    var result = BarcodeReader.Read(path, options).FirstOrDefault();
    if (result != null)
        results[path] = result.Value;
});

Imports IronBarcode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Parallel.ForEach(imagePaths, Sub(path)
    Dim result = BarcodeReader.Read(path, options).FirstOrDefault()
    If result IsNot Nothing Then
        results(path) = result.Value
    End If
End Sub)

Die Dokumentation von IronBarcode zum asynchronen und multithreadfähigen Barcode-Lesen erläutert das interne Thread-Pooling-Modell. Die MaxParallelThreads-Eigenschaft steuert den Grad der Parallelisierung ohne externe Koordination.

ZXing .NET -Ansatz

ZXing.Net erfordert, dass reader.Options.PossibleFormats vor jedem Dekodieren befüllt wird. Wenn ein Barcode-Format nicht aufgeführt ist, wird es nicht erkannt – ohne Fehlermeldung, Warnung oder Teilergebnis:

// ZXing.Net: PossibleFormats list controls which symbologies are decoded
var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
};
reader.Options.TryHarder = true;

using var bitmap = new Bitmap(imagePath);
var results = reader.DecodeMultiple(bitmap);

// ZXing.Net: PossibleFormats list controls which symbologies are decoded
var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
};
reader.Options.TryHarder = true;

using var bitmap = new Bitmap(imagePath);
var results = reader.DecodeMultiple(bitmap);

Imports ZXing
Imports ZXing.Common

' ZXing.Net: PossibleFormats list controls which symbologies are decoded
Dim reader As New BarcodeReader()
reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
}
reader.Options.TryHarder = True

Using bitmap As New Bitmap(imagePath)
    Dim results = reader.DecodeMultiple(bitmap)
End Using

Wenn jedes Format aufgelistet wird, um Fehler zu vermeiden, verschlechtert sich die Leistung. Werden nur die erwarteten Formate aufgeführt, besteht die Gefahr, dass Bilder aus externen Quellen unbemerkt fehlen. Für ZXing .NET gibt es keinen Mechanismus, um zu melden, dass ein Barcode in einem nicht aufgeführten Format gefunden wurde.

IronBarcode Ansatz

IronBarcode erkennt alle über 50 unterstützten Formate automatisch. Es ist keine Formatliste erforderlich oder akzeptiert:

// IronBarcode: automatic detection across all supported formats
var results = BarcodeReader.Read(imagePath);
foreach (var barcode in results)
{
    Console.WriteLine($"{barcode.Value} ({barcode.Format})");
}

// IronBarcode: automatic detection across all supported formats
var results = BarcodeReader.Read(imagePath);
foreach (var barcode in results)
{
    Console.WriteLine($"{barcode.Value} ({barcode.Format})");
}

Imports IronBarcode

' IronBarcode: automatic detection across all supported formats
Dim results = BarcodeReader.Read(imagePath)
For Each barcode In results
    Console.WriteLine($"{barcode.Value} ({barcode.Format})")
Next

Für Anwendungen, die die Lesegeschwindigkeit gegen die Erkennungsgründlichkeit anpassen, bietet IronBarcode ein ReadingSpeed-Enum — Faster, Balanced, Detailed, ExtremeDetail — ohne Format-Aufzählung. Die Geschwindigkeitsabstimmung beeinflusst, wie aggressiv die Engine jedes Bild verarbeitet, nicht, welche Formate sie berücksichtigt.

ZXing .NET -Ansatz

Wenn ein Barcode in eine PDF-Datei eingebettet ist, benötigt ZXing .NET eine externe PDF-Rendering-Bibliothek. Die gebräuchlichste Umgehungslösung verwendet PdfiumViewer, was etwa 20 MB an nativen Binärdateien und eine Seitenrendering-Schleife hinzufügt, die Aufrufer implementieren und warten müssen:

// ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
using var pdfDocument = PdfDocument.Load(pdfPath);

var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.PDF_417
};

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    string tempPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png");
    try
    {
        using var pageImage = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi);
        pageImage.Save(tempPath, ImageFormat.Png);

        using var bitmap = new Bitmap(tempPath);
        var decoded = reader.DecodeMultiple(bitmap);
        if (decoded != null)
            results.AddRange(decoded.Select(d => d.Text));
    }
    finally
    {
        File.Delete(tempPath);
    }
}

// ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
using var pdfDocument = PdfDocument.Load(pdfPath);

var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.PDF_417
};

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    string tempPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png");
    try
    {
        using var pageImage = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi);
        pageImage.Save(tempPath, ImageFormat.Png);

        using var bitmap = new Bitmap(tempPath);
        var decoded = reader.DecodeMultiple(bitmap);
        if (decoded != null)
            results.AddRange(decoded.Select(d => d.Text));
    }
    finally
    {
        File.Delete(tempPath);
    }
}

Imports System.IO
Imports System.Drawing
Imports PdfiumViewer
Imports ZXing
Imports ZXing.Common

' ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
Using pdfDocument As PdfDocument = PdfDocument.Load(pdfPath)

    Dim reader As New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.PDF_417
    }

    For i As Integer = 0 To pdfDocument.PageCount - 1
        Dim tempPath As String = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png")
        Try
            Using pageImage As Image = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi)
                pageImage.Save(tempPath, Imaging.ImageFormat.Png)

                Using bitmap As New Bitmap(tempPath)
                    Dim decoded = reader.DecodeMultiple(bitmap)
                    If decoded IsNot Nothing Then
                        results.AddRange(decoded.Select(Function(d) d.Text))
                    End If
                End Using
            End Using
        Finally
            File.Delete(tempPath)
        End Try
    Next
End Using

Dieses Muster birgt echte Fehlerquellen: Fehlkonfigurationen der DPI-Ebene führen zu unbemerkten Fehlern, temporäre Dateiberechtigungen versagen in abgesicherten Umgebungen, die nativen Bibliotheken von PdfiumViewer erfordern ein separates Bereitstellungsmanagement, und die Einrichtung funktioniert unter Linux ohne zusätzliche Konfiguration nicht.

IronBarcode Ansatz

IronBarcode liest Barcodes nativ aus PDFs – alle Seiten, alle Formate, keine externen Abhängigkeiten. Der gleiche BarcodeReader.Read-Aufruf akzeptiert direkt PDF-Pfade:

// IronBarcode: one call processes every page of the PDF
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}");

// IronBarcode: one call processes every page of the PDF
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}");

Imports IronBarcode

' IronBarcode: one call processes every page of the PDF
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}")
Next

Keine Seitenaufzählung, keine DPI-Konfiguration, keine temporären Dateien und keine separate Bibliothek, die zusammen mit der Anwendung bereitgestellt werden muss.

ZXing .NET -Ansatz

Das Kernpaket ZXing.Net bietet Dekodierungslogik, aber kein Bildladen. Aufrufer müssen eine Bindung basierend auf ihrem Bereitstellungsziel auswählen:

Die praktische Konsequenz ist, dass Windows-Code, der System.Drawing.Bitmap verwendet, auf Linux nicht kompiliert oder ausgeführt wird. Die Containerisierung erfordert den Wechsel der Bindungspakete und das Umschreiben des Codes zum Laden von Bildern:

// Windows binding path — uses System.Drawing
using ZXing.Windows.Compatibility;
using System.Drawing;

var reader = new BarcodeReader();
using var bitmap = new Bitmap(imagePath);
var result = reader.Decode(bitmap);

// Windows binding path — uses System.Drawing
using ZXing.Windows.Compatibility;
using System.Drawing;

var reader = new BarcodeReader();
using var bitmap = new Bitmap(imagePath);
var result = reader.Decode(bitmap);

Imports ZXing.Windows.Compatibility
Imports System.Drawing

Dim reader As New BarcodeReader()
Using bitmap As New Bitmap(imagePath)
    Dim result = reader.Decode(bitmap)
End Using

// Cross-platform path — different package, different API
using ZXing.ImageSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

var reader = new BarcodeReader<Rgba32>();
using var image = Image.Load<Rgba32>(imagePath);
var result = reader.Decode(image);

// Cross-platform path — different package, different API
using ZXing.ImageSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

var reader = new BarcodeReader<Rgba32>();
using var image = Image.Load<Rgba32>(imagePath);
var result = reader.Decode(image);

Imports ZXing.ImageSharp
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats

Dim reader As New BarcodeReader(Of Rgba32)()
Using image As Image(Of Rgba32) = Image.Load(Of Rgba32)(imagePath)
    Dim result = reader.Decode(image)
End Using

Die Verwendung der Windows-Bindung auf einem Linux-Host erfordert auch libgdiplus im Docker-Image und fügt dem Container etwa 50 MB hinzu.

IronBarcode Ansatz

IronBarcode liefert ein Paket für alle Plattformen. Der gleiche BarcodeReader.Read(path)-Aufruf wird identisch auf Windows, Linux, macOSund in Docker-Containern kompiliert und ausgeführt. Es werden keine Bindungspakete, keine Plattformbedingungen und keine zusätzlichen Systemabhängigkeiten benötigt. Für Teams, die .NET Anwendungen containerisieren, beschreibt der IronBarcode Docker- und Linux-Setup-Leitfaden das Single-Package-Deployment-Muster detailliert.

ZXing .NET -Ansatz

ZXing.Net's BarcodeWriter-Klasse erstellt ein Schreibobjekt, akzeptiert Kodierungsoptionen, ruft Write auf und gibt ein Bitmap zurück, das vom Aufrufer manuell mithilfe von System.Drawing.Imaging gespeichert werden muss:

// ZXing.Net: create writer, set options, call Write, save Bitmap
using ZXing;
using ZXing.Common;
using ZXing.Windows.Compatibility;
using System.Drawing.Imaging;

var writer = new BarcodeWriter
{
    Format = BarcodeFormat.CODE_128,
    Options = new EncodingOptions
    {
        Width = 300,
        Height = 100,
        Margin = 10
    }
};

using var bitmap = writer.Write("PRODUCT-001");
bitmap.Save("output.png", ImageFormat.Png);

// ZXing.Net: create writer, set options, call Write, save Bitmap
using ZXing;
using ZXing.Common;
using ZXing.Windows.Compatibility;
using System.Drawing.Imaging;

var writer = new BarcodeWriter
{
    Format = BarcodeFormat.CODE_128,
    Options = new EncodingOptions
    {
        Width = 300,
        Height = 100,
        Margin = 10
    }
};

using var bitmap = writer.Write("PRODUCT-001");
bitmap.Save("output.png", ImageFormat.Png);

Imports ZXing
Imports ZXing.Common
Imports ZXing.Windows.Compatibility
Imports System.Drawing.Imaging

Dim writer As New BarcodeWriter With {
    .Format = BarcodeFormat.CODE_128,
    .Options = New EncodingOptions With {
        .Width = 300,
        .Height = 100,
        .Margin = 10
    }
}

Using bitmap = writer.Write("PRODUCT-001")
    bitmap.Save("output.png", ImageFormat.Png)
End Using

Das Speichern in anderen Formaten als PNG oder JPEG, das Speichern in einer PDF-Datei oder das Erzeugen von binärem Ausgabe für eine HTTP-Antwort erfordert zusätzliche System.Drawing-Plumbing, das der Aufrufer implementiert.

IronBarcode Ansatz

IronBarcode's BarcodeWriter.CreateBarcode gibt ein GeneratedBarcode-Objekt zurück, das eingebaute Ausgabemethoden über eine fluente Kette bereitstellt:

// IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .SaveAsPng("output.png");

// IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .SaveAsPng("output.png");

Imports IronBarCode

' IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .SaveAsPng("output.png")

Das GeneratedBarcode-Objekt bietet auch .ToPngBinaryData(), .ToJpegBinaryData(), .ToStream() und .SaveAsPdf() — Ausgabeziele, die ZXing.Net erfordert, dass Aufrufer selbst mit System.Drawing implementieren.

Gleichzeitige und hocheffiziente Verarbeitung

Eine ZXing .NET Integration, die in einer Single-Thread-Konsolenanwendung korrekt funktioniert, kann nicht-deterministisches Verhalten zeigen, wenn derselbe Code in einen ASP.NET Core Controller verschoben wird, der gleichzeitige Anfragen verarbeitet, oder in einen Hintergrundjob, der Batches parallel verarbeitet. Das von ZXing .NET geforderte Instanzmuster pro Thread bedeutet, dass jede Anfrage oder parallele Aufgabe ein vollständiges Reader-Objekt mit dem zugehörigen konfigurierten Decodersatz zuweist, es einmal verwendet und anschließend verwirft. Mit zunehmendem Anfragevolumen wird dieser Zuteilungsdruck messbar. Teams, die diesen Punkt erreichen – insbesondere solche, die Scan-Pipelines mit hohem Durchsatz in den Bereichen Logistik, Lagerhaltung oder Dokumentenverarbeitung betreiben – suchen oft nach einer Bibliothek, deren Threading-Modell diesen Overhead nicht jedem Aufrufer auferlegt.

Scannen von Dokumenten in gemischten Formaten

Anwendungen, die Dokumente von Dritten akzeptieren, stoßen häufig auf Barcode-Formate, die bei der Konfiguration der Formatliste nicht berücksichtigt wurden. Eine für Code 128 entwickelte Versandintegration empfängt Sendungen von Partnern mittels QR-Codes. Ein medizinisches Dokumentationssystem, das für PDF 417-Begegnungen und Data Matrix-Symbologien eines neuen Geräteherstellers konfiguriert ist. In ZXing .NET führt jeder dieser Fälle zu einem stillen Nullwert anstelle eines Dekodierungsfehlers, was bedeutet, dass der Fehler möglicherweise erst bei einem Fehler in der nachfolgenden Verarbeitung sichtbar wird. Teams, die durch unbemerkte Formatfehler schlechte Erfahrungen gemacht haben – insbesondere in Kontexten, in denen ein übersehener Barcode geschäftliche Konsequenzen hat – beginnen, die Kosten der Formatlistenpflege gegen eine Bibliothek abzuwägen, die Formate automatisch erkennt.

PDF-Barcode-Extraktion

Viele Geschäftsdokumente kommen im PDF-Format an: Rechnungen, Versandmanifeste, Patientenakten, Konformitätsbescheinigungen. ZXing .NET kann diese nicht direkt lesen. Teams, die Barcodes aus PDFs extrahieren müssen, müssen letztendlich eine Rendering-Pipeline auf Basis von ZXing .NET aufbauen und pflegen – sie wählen eine PDF-Bibliothek aus, verwalten deren native Abhängigkeiten, implementieren eine Seitenrender-Schleife, handhaben die DPI-Konfiguration und schreiben eine Bereinigungslogik für temporäre Dateien. Dieser Infrastrukturcode ist keine Barcode-Logik; Es dient einzig und allein dazu, die Lücke zwischen dem, was ZXing .NET akzeptiert (Bitmaps), und dem, was Geschäftsdokumente tatsächlich sind (PDFs), zu schließen. Teams, die diese Brücke pflegen müssen – insbesondere wenn die PDF-Bibliothek selbst Lizenzierungs-, Bereitstellungs- und Plattformüberlegungen mit sich bringt – bevorzugen oft eine einzige Bibliothek, die die gesamte Eingabeoberfläche abdeckt.

Reduzierung der Bindungskomplexität

Projekte, die unter Windows gestartet und später auf Linux oder Docker bereitgestellt werden, stoßen direkt auf die Bindungsfragmentierung von ZXing.Net: Das Windows-Bindungspaket verwendet eine andere API als die plattformübergreifende ImageSharp-Bindung, und der Wechsel zwischen ihnen erfordert die Änderung sowohl der NuGet -Referenzen als auch des Bildladecodes. Teams, die ihre .NET Anwendungen routinemäßig containerisieren oder die gleiche Codebasis auf Entwicklerrechnern (Windows oder macOS) und Produktionsservern (Linux) ausführen, stellen fest, dass die Pflege zweier Codepfade für das Laden von Bildern jede zukünftige Änderung in der Scanschicht erschwert.

Entfernung der BarcodeReader-Instanziierung

Jeder new BarcodeReader()-Aufruf im Codebasis wird während der Migration entfernt. Das Instanziierungsmuster – Erstellung des Readers, Formatkonfiguration, Laden des Bildes, Dekodierungsaufruf – reduziert sich auf einen einzigen statischen Methodenaufruf. Dateien, die ZXing, ZXing.Common, ZXing.Windows.Compatibility, ZXing.ImageSharp und SixLabors.ImageSharp-Namespaces importieren, haben diese Importe entfernt und durch einen einzigen using IronBarCode; ersetzt.

Entfernung der Konfiguration "Mögliche Formate"

Der reader.Options.PossibleFormats-Zuweisungsblock wird bei jedem Aufrufort gelöscht. IronBarcode führt eine automatische Formaterkennung durch und akzeptiert keine Formatbeschränkungsliste. Das TryHarder-Flag wird durch die ReadingSpeed-Eigenschaft bei BarcodeReaderOptions ersetzt, die den Erkennungsaufwand steuert, ohne den Formatbereich einzuengen.

Bereinigung des Bindungspakets

Die Migration entfernt ZXing.Net, ZXing.Net.Bindings.Windows.Compatibility, alle ZXing.Net.Bindings.ImageSharp-Varianten (.V2 / .V3) und alle PdfiumViewer-Pakete, die hinzugefügt wurden, um das PDF-Lesen zu unterstützen. Wenn libgdiplus zu einem Dockerfile hinzugefügt wurde, um System.Drawing durch die Windows-Bindung auf Linux zu unterstützen, wird auch diese Zeile entfernt. IronBarcode benötigt im Docker-Image keine plattformspezifischen Abhängigkeiten.