Architektura Stateful Reader

ZXing.Net's BarcodeReader wymaga nowej instancji dla każdego wątku lub operacji równoległej. Poniższy wzorzec przedstawia minimalną poprawną konfigurację przetwarzania współbieżnego:

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

Wzorzec ThreadLocal<BarcodeReader> redukuje alokację dla każdego wywołania poprzez ponowne użycie jednej instancji na wątek, ale dodaje złożoność związaną z usuwaniem. W każdym przypadku, odpowiedzialność za bezpieczeństwo wątkowe spoczywa na wywołującym w ZXing.Net.

Szczegółowe porównanie funkcji

ZXing.Net Podejście

ZXing.Net's BarcodeReader to obiekt ze stanem. Po wywołaniu Decode zostaje zapisany stan wewnętrzny. Jeśli dwa wątki dzielą tę samą instancję, te zapisy rywalizują. Rezultaty są niedeterministyczne: można otrzymać wynik z innego obrazu, null tam, gdzie istnieje kod kreskowy, lub wyjątek. Prawidłowe podejście to stworzenie jednego czytnika na wątek — co oznacza, że każda równoległa lub asynchroniczna ścieżka przydziela czytnik, konfiguruje go, używa raz i wyrzuca:

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

Wzorzec ThreadLocal<BarcodeReader> redukuje alokację dla każdego wywołania poprzez ponowne użycie jednego czytnika na wątek, ale dodaje złożoność związaną z usuwaniem i nadal wymaga konfiguracji formatu dla każdej instancji.

Podejście IronBarcode

BarcodeReader.ReadIronBarcode to bezstanowa statyczna metoda. Nie ma instancji do dzielenia, nie ma instancji do izolowania i nie ma stanu konfiguracji do ochrony. To samo wywołanie działa bezpiecznie z dowolnej liczby współbieżnych wątków:

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

Dokumentacja IronBarcode'a asynchroniczne i wielowątkowe czytanie kodów kreskowych wyjaśnia wewnętrzny model puli wątków. Właściwość MaxParallelThreads kontroluje stopień równoległości bez potrzeby zewnętrznej koordynacji.

ZXing.Net Podejście

ZXing.Net wymaga, aby reader.Options.PossibleFormats było wypełniane przed każdym dekodowaniem. Jeśli format kodu kreskowego nie jest wymieniony, nie zostanie wykryty — bez błędu, ostrzeżenia i częściowego wyniku:

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

Jeśli wszystkie formaty są wymienione, aby uniknąć pominięć, wydajność ulega pogorszeniu. Jeśli umieszczone są tylko oczekiwane formaty, ciche pominięcia stają się ryzykiem, gdy obrazy pochodzą z zewnętrznych źródeł. Nie ma mechanizmu, aby ZXing.Net zgłaszał, że znalazł kod kreskowy w nieznanym formacie.

Podejście IronBarcode

IronBarcode automatycznie wykrywa wszystkie 50+ obsługiwanych formatów. Nie jest wymagana lub akceptowana lista formatów:

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

Dla aplikacji, które dostosowują prędkość odczytu do dokładności wykrywania,IronBarcode udostępnia enum ReadingSpeed — Faster, Balanced, Detailed, ExtremeDetail — bez potrzeby wyliczania formatu. Strojenie szybkości wpływa na to, jak agresywnie silnik przetwarza każdy obraz, a nie które formaty rozważa.

ZXing.Net Podejście

Gdy kod kreskowy przychodzi osadzony w PDF, ZXing.Net wymaga zewnętrznej biblioteki renderującej PDF. Najczęstsze obejście używa PdfiumViewer, który dodaje około 20 MB natywnych binariów i pętlę renderowania stron, którą wywołujący musi zaimplementować i utrzymywać:

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

Ten wzorzec ma rzeczywiste tryby awarii: błędna konfiguracja DPI powoduje ciche pominięcia, uprawnienia do plików tymczasowych zawodzą w izolowanych środowiskach, natywne biblioteki PdfiumViewer wymagają odrębnego zarządzania wdrożeniem, a konfiguracja nie działa na Linuxie bez dodatkowej konfiguracji.

Podejście IronBarcode

IronBarcode czyta kody kreskowe z PDF-ów natywnie — wszystkie strony, wszystkie formaty, bez zewnętrznych zależności. To samo wywołanie BarcodeReader.Read przyjmuje bezpośrednio ścieżki PDF:

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

Brak enumeracji stron, brak konfiguracji DPI, brak plików tymczasowych, brak oddzielnej biblioteki do wdrożenia razem z aplikacją.

ZXing.Net Podejście

Podstawowy pakiet ZXing.Net zapewnia logikę dekodowania, ale nie ładowanie obrazów. Wywołujący musi wybrać wiązanie w oparciu o swój docelowy cel wdrożenia:

Praktyczną konsekwencją jest to, że kod Windows używający System.Drawing.Bitmap nie kompiluje się ani nie działa na Linux. Konteneryzacja wymaga zmiany pakietów wiążących i przepisania kodu ładowania obrazów:

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

Użycie powiązań Windows na hoście Linux również wymaga libgdiplus w obrazie Docker, co dodaje około 50 MB do kontenera.

Podejście IronBarcode

IronBarcode dostarcza jeden pakiet dla wszystkich platform. To samo wywołanie BarcodeReader.Read(path) kompiluje i działa identycznie na Windows, Linux,macOSi wewnątrz kontenerów Docker. Nie są wymagane pakiety wiążące, warunki dla platform i dodatkowe zależności systemowe. Dla zespołów konteneryzujących aplikacje .NET, przewodnik setup IronBarcode dla Docker i Linux obejmuje wzorzec wdrożenia pakietu pojedynczego w szczegółach.

ZXing.Net Podejście

Klasa BarcodeWriter ZXing.Net tworzy obiekt pisarza, przyjmuje opcje kodowania, wywołuje Write, i zwraca Bitmap, który wywołujący muszą zapisać ręcznie używając System.Drawing.Imaging:

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

Zapis do formatów innych niż PNG lub JPEG, zapis do PDF lub tworzenie wyjścia binarnego dla odpowiedzi HTTP wymaga dodatkowych System.Drawing, które implementuje wywołujący.

Podejście IronBarcode

BarcodeWriter.CreateBarcodeIronBarcode zwraca obiekt GeneratedBarcode, który zapewnia wbudowane metody wyjścia przez łańcuch płynny:

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

Obiekt GeneratedBarcode również udostępnia .ToPngBinaryData(), .ToJpegBinaryData(), .ToStream() i .SaveAsPdf() — cele wyjścia, które ZXing.Net wymaga, aby wywołujący samodzielnie zaimplementowali przy użyciu System.Drawing.

Przetwarzanie równoległe i o wysokiej przepustowości

Integracja ZXing.Net, która działa poprawnie w jednowątkowej aplikacji konsolowej, może wykazywać zachowanie niedeterministyczne, gdy ten sam kod zostanie przeniesiony do kontrolera ASP.NET Core obsługującego równoczesne żądania lub do zadania w tle, które przetwarza partie danych równolegle. Wymagany przez ZXing.Net wzorzec instancji na wątek oznacza, że każde żądanie lub zadanie równoległe przydziela pełny obiekt czytnika z skonfigurowanym zestawem dekoderów, używa go raz, a następnie odrzuca. Wraz ze wzrostem liczby zgłoszeń presja związana z alokacją zasobów staje się wymierna. Zespoły, które osiągają ten etap — zwłaszcza te korzystające z wysokowydajnych potoków skanowania w logistyce, magazynowaniu lub przetwarzaniu dokumentów — często poszukują biblioteki, której model wątków nie nakłada tego obciążenia na każdego wywołującego.

Skanowanie dokumentów o mieszanym formacie

Aplikacje, które akceptują dokumenty od stron trzecich, często napotykają formaty BARCODE, których nie przewidziano podczas konfiguracji listy formatów. Integracja wysyłkowa stworzona dla Code 128 odbiera przesyłkę od partnera za pomocą kodów QR. System dokumentacji medycznej skonfigurowany dla formatu PDF 417 napotyka symbole Data Matrix od nowego dostawcy sprzętu. W ZXing.Net każdy z tych przypadków powoduje cichą wartość null zamiast błędu dekodowania, co oznacza, że pominięcie może nie ujawnić się, dopóki nie zawiedzie dalsze przetwarzanie. Zespoły, które poniosły straty z powodu niezauważonych błędów formatowania — szczególnie w sytuacjach, gdzie brak BarCODE'a ma konsekwencje biznesowe — zaczynają rozważać koszty utrzymania listy formatów w porównaniu z biblioteką, która automatycznie wykrywa formaty.

Ekstrakcja BarCodes z plików PDF

Wiele dokumentów biznesowych przychodzi w formacie PDF: faktury, listy przewozowe, dokumentacja pacjentów, certyfikaty zgodności. ZXing.Net nie może odczytać tych plików bezpośrednio. Zespoły, które muszą wyodrębniać kody kreskowe z plików PDF, w końcu budują i utrzymują potok renderowania oparty na ZXing.Net — wybierając bibliotekę PDF, zarządzając jej natywnymi zależnościami, wdrażając pętlę renderowania stron, obsługując konfigurację DPI i pisząc logikę czyszczenia plików tymczasowych. Ten kod infrastruktury nie jest logiką BarCode; istnieje wyłącznie po to, aby wypełnić lukę między tym, co akceptuje ZXing.Net (mapy bitowe), a tym, czym faktycznie są dokumenty biznesowe (pliki PDF). Zespoły, które muszą utrzymywać ten pomost — zwłaszcza gdy sama biblioteka PDF ma własne wymagania dotyczące licencji, wdrażania i platformy — często preferują jedną bibliotekę, która obsługuje cały zakres danych wejściowych.

Zmniejszenie złożoności powiązań

Projekty, które rozpoczynają się w systemie Windows, a następnie są wdrażane w systemie Linux lub Docker, bezpośrednio napotykają problem fragmentacji powiązań ZXing.Net: pakiet powiązań dla systemu Windows wykorzystuje inne API niż wielopłatformowe powiązanie ImageSharp, a przełączanie się między nimi wymaga zmiany zarówno odwołań NuGet, jak i kodu ładującego obrazy. Zespoły, które rutynowo konteneryzują swoje aplikacje .NET lub które uruchamiają ten sam kod na komputerach programistów (Windows lub macOS) i serwerach produkcyjnych (Linux), zauważają, że utrzymywanie dwóch ścieżek kodu do ładowania obrazów utrudnia każdą przyszłą zmianę w warstwie skanującej.

Usunięcie instancji BarcodeReader

Każde wywołanie new BarcodeReader() w kodzie jest usuwane podczas migracji. Wzorzec instancjonowania — utworzenie czytnika, konfiguracja formatu, ładowanie obrazu, wywołanie dekodowania — sprowadza się do jednego wywołania metody statycznej. Pliki, które importują przestrzenie nazw ZXing, ZXing.Common, ZXing.Windows.Compatibility, ZXing.ImageSharp i SixLabors.ImageSharp, mają te importy usunięte i zastąpione jednym using IronBarCode;.

Usunięcie konfiguracji PossibleFormats

Blok przypisania reader.Options.PossibleFormats jest usuwany w każdym miejscu wywołania.IronBarcode wykonuje automatyczne wykrywanie formatu i nie akceptuje listy ograniczeń formatu. Flaga TryHarder jest zastępowana właściwością ReadingSpeed na BarcodeReaderOptions, która kontroluje wysiłek wykrywania bez zawężania zakresu formatu.

Porządkowanie pakietów wiązanych

Migracja usuwa ZXing.Net, ZXing.Net.Bindings.Windows.Compatibility, dowolny wariant ZXing.Net.Bindings.ImageSharp (.V2 / .V3), oraz dowolne pakiety PdfiumViewer, które zostały dodane do wsparcia odczytu PDF. Jeśli libgdiplus zostało dodane do pliku Dockerfile, aby wspierać System.Drawing poprzez powiązanie Windows na Linux, ta linia jest również usuwana.IronBarcode nie wymaga żadnych zależności specyficznych dla platformy w obrazie Docker.