Accusoft BarcodeXpress vs IronBarcode: Porównanie bibliotek kodów kreskowych C#

Wyjaśnienie systemu dwóch kluczy

BarcodeXpress dzieli licencjonowanie na dwie koncepcyjnie odrębne warstwy:

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

Imports Accusoft.BarcodeXpressSdk

Dim barcodeXpress As New BarcodeXpress()
' Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName"
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
' Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"))

Para SolutionName i SolutionKey aktywuje sam pakiet SDK. Wywołanie UnlockRuntime, które przyjmuje własny klucz i klucz rozwiązania jako oddzielne argumenty, aktywuje funkcje wdrażania produkcyjnego. Oba muszą być obecne i prawidłowe, aby wdrożenie produkcyjne zwracało kompletne, niezasłonięte wartości BARCODE.

Podczas przeglądu kodu ten wzorzec wywołuje przewidywalne pytanie: "Dłączego wywołujemy UnlockRuntime z dwoma różnymi kluczami?". Odpowiedź — że Accusoft traktuje licencjonowanie SDK i licencjonowanie wdrożeniowe jako odrębne produkty z oddzielnym rozliczeniem — nie zawsze jest oczywista na podstawie samego API. Zespoły utrzymujące ten kod sześć miesięcy po początkowej konfiguracji często muszą sięgać do dokumentacji, aby zrozumieć, który klucz jest który.

Właściwość IsRuntimeUnlocked pozwala sprawdzić, czy warstwa uruchomieniowa jest aktywna:

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

If Not barcodeXpress.Licensing.IsRuntimeUnlocked Then
    ' In this state, barcode values are partially obscured
    ' "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active")
End If

Ta kontrola jest zabezpieczeniem dodawanym przez zespoły, gdy zdają sobie sprawę, że wynik w trybie oceny zwraca w tle częściowe dane, zamiast zgłaszać wyjątek lub wyraźnie zakończyć się niepowodzeniem.

Szczegółowe porównanie funkcji

Podejście BarcodeXpress

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress()

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp"
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")

        ' Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime("RuntimeKey-XXXXXX", Convert.ToInt64("98765432109876"))

        ' Guard against partial-value mode
        If Not _barcodeXpress.Licensing.IsRuntimeUnlocked Then
            Throw New InvalidOperationException("Runtime license not active — barcode values will be obscured")
        End If
    End Sub
End Class

Jest to 15-wierszowy konstruktor, który służy wyłącznie do zarządzania dwoma oddzielnymi systemami kluczy licencyjnych przed rozpoczęciem jakiejkolwiek operacji związanej z BarCode. Zabezpieczenie IsRuntimeUnlocked nie jest opcjonalne — bez niego usługa w sposób niewidoczny zwróci wartości o obniżonej jakości w każdym środowisku, w którym brakuje klucza środowiska uruchomieniowego lub jest on nieprawidłowo skonfigurowany.

Podejście IronBarcode

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

' In Program.vb or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY"

To jest kompletna konfiguracja licencji. Bez oddzielnego odblokowywania środowiska uruchomieniowego, bez nazwy rozwiązania, bez wywołania UnlockRuntime z dwoma argumentami. W Dockerze staje się to zmienną środowiskową odczytywaną podczas uruchamiania. W potoku CI/CD jest to jeden sekret. W w orkiestratorze kontenerów jest to jedna zmienna środowiskowa wstrzyknięta do podu.

Podejście BarcodeXpress

Odczyt za pomocą BarcodeXpress wymaga skonfigurowania czytnika za pomocą SetPropertyValue, który przyjmuje stałą i wartość, a następnie wywołania Analyze() w celu pobrania wyników:

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress()
    barcodeXpress.Licensing.SolutionName = "AcmeCorp"
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"))

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath)
    barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.DataMatrixBarcode Or BarcodeType.QRCodeBarcode

    Dim results = barcodeXpress.reader.Analyze()
    Return results.Select(Function(r) r.BarcodeValue)
End Function

Stała cycBxeSetFilename jest sposobem API na określenie pliku do przetworzenia. Ten wzorzec — przekazywanie stałego identyfikatora wraz z wartością do ogólnej metody SetPropertyValue — przypomina starsze interfejsy API oparte na COM. Jeśli dokument zawiera format niewymieniony w BarcodeTypes, nie zostanie on znaleziony. W przypadku zmiany dokumentów źródłowych powoduje to dodatkowe obciążenie związane z utrzymaniem.

Podejście IronBarcode

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

Imports IronBarCode

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim results = BarcodeReader.Read(imagePath)
    Return results.Select(Function(r) r.Value)
End Function

IronBarcode automatycznie wykrywa format we wszystkich obsługiwanych symbolikach. Jeśli obraz zawiera kod 128, kod QR i DataMatrix, wszystkie trzy pojawiają się w zbiorze wyników bez żadnych zmian w konfiguracji. Aby zapewnić większą kontrolę nad sposobem odczytu, klasa BarcodeReaderOptions udostępnia ustawienia prędkości, liczby wątków oraz obsługi wielu kodów kreskowych.

Natywne odczytywanie plików PDF jest również dostępne za pomocą tej samej metody:

using IronBarCode;

// Język ojczysty PDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

using IronBarCode;

// Język ojczysty PDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

Imports IronBarCode

' Język ojczysty PDF support — no separate library needed
Dim results = BarcodeReader.Read("invoice-batch.pdf")

For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}")
Next

BarcodeXpress nie odczytuje plików PDF w sposób natywny. Najpierw należy renderować każdą stronę do obrazu, używając oddzielnej biblioteki, a następnie przekazać te obrazy do czytnika BarcodeXpress. Powoduje to dodanie zależności, etapu konwersji oraz dodatkowych kosztów licencji w zależności od wybranej biblioteki PDF.

Podejście BarcodeXpress

BarcodeXpress jest oparty na instancjach, a jego obiekt reader jest stanowy. Przetwarzanie równoległe wymaga jednej instancji na wątek, przy czym pełna dwuwarstwowa inicjalizacja licencji jest powtarzana w kontekście każdego wątku:

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic

Public Function ProcessBatch(imagePaths As IEnumerable(Of String)) As Dictionary(Of String, String)
    Dim results As New Dictionary(Of String, String)()

    For Each path In imagePaths
        _barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, path)
        _barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.QRCodeBarcode

        Dim barcodes = _barcodeXpress.reader.Analyze()
        If barcodes.Length > 0 Then
            results(path) = barcodes(0).BarcodeValue
        End If
    Next

    Return results
End Function

Wersja Standard Edition nakłada również ograniczenie do 40 stron na minutę. Przetworzenie partii 100 000 dokumentów przy prędkości 40 stron na minutę zajmuje około 41 godzin. Wersja Professional Edition znosi ten limit, ale wiąże się to z wyższym kosztem na programistę — oprócz już zakupionych licencji na środowisko uruchomieniowe.

Podejście IronBarcode

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

// IronBarcode — parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

// IronBarcode — parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.Threading.Tasks

' IronBarcode — parallel batch with thread-safe static API
Dim files = Directory.GetFiles("/incoming/scans", "*.png")
Dim allResults = New ConcurrentBag(Of String)()

Parallel.ForEach(files, Sub(file)
    Dim r = BarcodeReader.Read(file)
    For Each barcode In r
        allResults.Add($"{file}: {barcode.Value}")
    Next
End Sub)

Ponieważ metody statyczne IronBarcode są bezstanowe, Parallel.ForEach nad nimi jest bezpieczne i nie wymaga izolacji instancji. IronBarcode nie nakłada żadnych ograniczeń przepustowości w żadnym przedziale cenowym. W celu dostosowania wydajności odczytu klasa BarcodeReaderOptions udostępnia ustawienia ReadingSpeed i MaxParallelThreads:

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

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

Dim results = BarcodeReader.Read("warehouse-scan.png", options)

ReadingSpeed.Balanced jest wartością domyślną. Użyj ReadingSpeed.Faster dla potoków o dużej przepustowości, gdzie BARCODE jest wyraźny, lub ReadingSpeed.Detailed dla obrazów uszkodzonych lub o niskim kontraście.

Przekraczanie bariery 40 stron na minutę

Limit 40 stron na minutę w wersji Standard Edition wydaje się hojny, dopóki zespół biznesowy nie zdecyduje się na przetwarzanie wsadowe na koniec dnia archiwalnych faktur z całego roku. Przetworzenie partii 100 000 dokumentów przy tej szybkości zajmuje około 41 godzin. Przejście na wersję Professional Edition znosi limit, ale wiąże się z wyższym kosztem licencji na stanowisko programisty — oprócz już zakupionych licencji na środowisko uruchomieniowe. Zespoły, które po podpisaniu zamówienia odkrywają ograniczenia przepustowości, często stwierdzają, że całkowity koszt ich usunięcia znacznie przekracza początkowe szacunki.

Złożoność licencji w procesie CI/CD

Typowa konfiguracja CI/CD uruchamia kompilacje w kontenerach efemerycznych. W przypadku BarcodeXpress każde środowisko kompilacji wymaga zarówno pary kluczy SDK, jak i kluczy odblokowujących środowisko uruchomieniowe, zarządzanych jako oddzielne sekrety. Jeśli klucz środowiska uruchomieniowego jest nieobecny lub nieprawidłowo skonfigurowany, kompilacja może zakończyć się powodzeniem, ale testy integracyjne zwrócą niejasne wartości — jest to cichy tryb awarii, który łatwo przeoczyć w potoku testowym, jeśli asercje testowe nie są starannie napisane w odniesieniu do rzeczywistej zawartości kodu kreskowego.

Wymagania dotyczące wdrożenia w środowisku izolowanym i bezpiecznym

Niektóre środowiska — systemy opieki zdrowotnej przetwarzające dokumentację pacjentów, przepływy dokumentów rządowych, przetwarzanie back-office w instytucjach finansowych — nie mogą zezwalać na sprawdzanie licencji poprzez wychodzące połączenia sieciowe. System licencji uruchomieniowych BarcodeXpress wykorzystuje infrastrukturę licencyjną Accusoft, co może stanowić problem zgodności w środowiskach o ścisłych ograniczeniach ruchu wychodzącego z sieci. Zespoły działające w tych środowiskach często wybierają biblioteki, których weryfikacja licencji odbywa się całkowicie lokalnie.

Docker i wdrażanie kontenerów

BarcodeXpress w Dockerze zazwyczaj wymaga zamontowania pliku licencji w kontenerze w znanej ścieżce lub skonfigurowania serwera licencji i skierowania kontenera na niego. Oba podejścia zwiększają złożoność wdrożenia — pliki licencji muszą być dystrybuowane i synchronizowane, a serwer licencji stanowi dodatkowy element infrastruktury, który należy utrzymywać. Zespoły przechodzące na architekturę mikrousług lub wzorce wdrażania bezserwerowego zauważają, że podejście oparte na plikach konfiguracyjnych nie przekłada się w sposób przejrzysty na niezmienne obrazy kontenerów.

Wymagania dotyczące dokładności oceny

Zespoły, które przed podjęciem decyzji o zakupie muszą sprawdzić dokładność odczytu na własnych dokumentach, uważają tryb ewaluacyjny BarcodeXpress za zasadniczo ograniczony. Testowanie na rzeczywistych skanach dokumentów — sprawdzanie, czy biblioteka radzi sobie z kodami kreskowymi o niskim kontraście, przekrzywionymi obrazami lub stronami zawierającymi wiele kodów kreskowych — wymaga kompletnych, zdekodowanych wartości. Częściowo zasłonięty wynik pokazuje jedynie, że biblioteka znalazła BARCODE, a nie to, czy odczytała go poprawnie.

Zarządzanie instancjami do wywołań statycznych

BarcodeXpress wymaga utworzenia i licencjonowania instancji BarcodeXpress przed rozpoczęciem jakiejkolwiek operacji. Metody statyczne IronBarcode nie wymagają instancji. Zespoły przeprowadzające migrację zazwyczaj mają klasę BarcodeService, której konstruktor w dużej mierze składa się ze standardowego kodu licencyjnego — po migracji konstruktor ten można całkowicie usunąć lub zredukować do przypisania pojedynczego klucza licencyjnego.

Usunięcie wyliczenia BarcodeTypes

Każda operacja odczytu w BarcodeXpress wymaga przypisania flagi BarcodeTypes w celu określenia symboli, których należy szukać. IronBarcode domyślnie automatycznie wykrywa wszystkie obsługiwane formaty. Podczas migracji wszystkie przypisania reader.BarcodeTypes = ... można usunąć bez zastępowania. Jeśli ze względu na wydajność konieczne jest ograniczenie przestrzeni wyszukiwania, BarcodeReaderOptions obsługuje filtrowanie formatów jako opcję wyraźnie wybraną, a nie domyślną.

Zmiany nazw właściwości wynikowych

Dwie zmiany nazw właściwości mają wpływ na cały kod przetwarzania wyników: result.BarcodeValue staje się result.Value, a result.BarcodeType staje się result.Format. Funkcja wyszukiwania i zamiany w całym rozwiązaniu pozwala zająć się obiema kwestiami. Wyniki IronBarcode ujawniają również result.Confidence i result.PageNumber, które nie mają odpowiednika w BarcodeXpress i mogą być wykorzystane do dodatkowego filtrowania bez konieczności wprowadzania zmian w kodzie istniejącej obsługi wyników.

Konfiguracja licencji Docker

Wdrożenia BarcodeXpress w Dockerze zazwyczaj wykorzystują zamontowany plik konfiguracyjny licencji. IronBarcode używa zmiennej środowiskowej. Migracja polega na usunięciu instrukcji COPY z pliku konfiguracyjnego i dodaniu pojedynczego przypisania zmiennej środowiskowej. W Kubernetes klucz licencyjny staje się sekretnym odniesieniem w specyfikacji podu, a nie zamontowanym woluminem.