LEADTOOLS Barcode vs IronBarcode: Porównanie bibliotek kodów kreskowych C#

Architektura licencji oparta na plikach

Inicjalizacja LEADTOOLS wymaga około 20 linii kodu, zanim będzie można wykonać pierwszą operację związaną z BarCode. Sekwencja obejmuje rozpoznawanie ścieżki pliku, weryfikację wygaśnięcia oraz sprawdzanie blokady poszczególnych funkcji:

// LEADTOOLS: Ponad 20 wierszy 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: Ponad 20 wierszy 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

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

Ten blok inicjalizacyjny musi zostać pomyślnie wykonany, zanim jakakolwiek operacja odczytu lub zapisu BARCODE będzie działać. Jeśli plik .LIC nie istnieje, ścieżka jest nieprawidłowa lub uprawnienia do pliku są nieprawidłowe, LEADTOOLS nie zainicjuje się — nie w trybie cichym, ale z błędem, który zatrzymuje działanie.

Szczegółowe porównanie funkcji

Podejście LEADTOOLS

Licencjonowanie LEADTOOLS wymaga fizycznej obecności pliku .LIC w systemie plików w znanej ścieżce oraz podania ciągu znaków klucza programisty do RasterSupport.SetLicense. Po wywołaniu SetLicense aplikacja musi sprawdzić, czy licencja nie wygasła i czy każda funkcja BARCODE'a jest odblokowana indywidualnie. Dopiero po pozytywnym przejściu wszystkich kontroli można utworzyć BarcodeEngine:

// LEADTOOLS: Ponad 20 wierszy 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: Ponad 20 wierszy 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

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

Ten model oparty na plikach powstał przed pojawieniem się nowoczesnych systemów zarządzania sekretami. Plik .LIC musi być udostępniony w każdym środowisku, w którym działa aplikacja: na komputerach programistów, agentach kompilacji CI, serwerach stagingowych i hostach produkcyjnych.

Podejście IronBarcode

Inicjalizacja licencji IronBarcode to jedna linijka:

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

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

Klucz ten może pochodzić ze zmiennej środowiskowej, pliku konfiguracyjnego lub menedżera sekretów — z dowolnego miejsca, z którego może pochodzić ciąg znaków. Nie ma pliku do zlokalizowania, nie ma potrzeby pisania kodu sprawdzającego datę ważności ani weryfikacji blokady funkcji. Jeśli chodzi o konfigurację licencji i opcje wdrażania, dokumentacja obejmuje wszystkie wzorce: zmienne środowiskowe, appsettings.json, Azure Key Vault i inne.

Podejście LEADTOOLS

Wdrożenie LEADTOOLS w Dockerze wymaga skopiowania pliku .LIC do obrazu kontenera lub zamontowania go jako woluminu w czasie wykonywania:

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"]

Takie podejście wiąże się z pewnymi komplikacjami na dalszych etapach. Rotacja lub unieważnienie klucza licencyjnego wymaga odbudowy obrazu lub ponownego zamontowania woluminu. Pipeline CI/CD musi albo zatwierdzić plik .LIC, albo zdekodować go z tajnego klucza zakodowanego w base64 w czasie kompilacji. Tajne klucze Kubernetes zaprojektowane dla par klucz-wartość typu string muszą teraz przechowywać zawartość plików. Zespoły korzystające z kontenerów efemerycznych muszą rozwiązać problem udostępniania plików na każdym nowym węźle.

Podejście IronBarcode

IronBarcode nie wymaga żadnego pliku w kontenerze:

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

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

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

Model zmiennych środowiskowych współpracuje natywnie z sekretami Docker, sekretami Kubernetes, AWS Secrets Manager, Azure Key Vault i HashiCorp Vault — każdym systemem, który może wstrzyknąć ciąg znaków do środowiska kontenera. Dostępny jest pełny przewodnik wdrożeniowy dla Docker i Linux, obejmujący obrazy bazowe zarówno Alpine, jak i Debian.

Podejście LEADTOOLS

Odczytanie pliku przez LEADTOOLS wymaga utworzenia instancji RasterCodecs w celu załadowania obrazu, instancji BarcodeEngine w celu jego skanowania oraz jawnej tablicy wartości BarcodeSymbology określającej formaty, których należy szukać. Pominięcie symboliki w tablicy oznacza, że LEADTOOLS nie wykryje BARCODE-ów tego typu:

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

Podejście IronBarcode

IronBarcode automatycznie wykrywa formaty we wszystkich ponad 50 obsługiwanych symbolikach. Ścieżka do pliku jest przekazywana bezpośrednio; nie jest wymagańa warstwa ładowania obrazów ani tablica symboli:

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

Więcej szczegółów na temat opcji odczytu, równoważenia szybkości i dokładności oraz obsługi trudnych obrazów można znaleźć w przewodniku dotyczącym odczytu BarCODE-ów z obrazów, który obejmuje pełny zakres API.

Podejście LEADTOOLS

Generowanie BARCODE-ów w LEADTOOLS wymaga utworzenia obiektu BarcodeData z symbolem, wartością i granicami — następnie utworzenia pustego RasterImage z wyraźnymi wymiarami w pikselach, głębią bitową, kolejnością bajtów i perspektywą widoku — następnie wypełnienie go białym tłem za pomocą FillCommand — następnie wywołanie engine.Writer.WriteBarcode() — a na koniec zapisanie za pomocą RasterCodecs. To pięć odrębnych operacji na wielu typach obiektów:

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

Podejście IronBarcode

IronBarcode wewnętrznie obsługuje tworzenie obrazów, wypełnianie tła i kodowanie:

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

W celu tworzenia obrazów kodów kreskowych interfejs API IronBarcode udostępnia funkcje stylizacji, marginesów, obracania i konwersji formatów za pomocą płynnego łańcucha, a nie serii imperatywnych obiektów konfiguracyjnych.

Wdrażanie w kontenerach i chmurze

Zespoły przenoszące obciążenia do środowisk Docker, Kubernetes lub bezserwerowych napotykają model licencjonowania oparty na plikach jako konkretny problem operacyjny. Każda nowa instancja kontenera, każdy nowy region chmury i każde nowe Środowisko muszą mieć plik .LIC przygotowany i dostępny przed uruchomieniem aplikacji. Systemy zarządzania sekretami zaprojektowane dla sekretów o wartości łańcuchowej nie obsługują w sposób przejrzysty artefaktów opartych na plikach. Zespoły, które ujednoliciły proces konfiguracji poprzez wstrzykiwanie zmiennych środowiskowych, zauważają, że LEADTOOLS wymaga oddzielnego etapu przydzielania zasobów, który wykracza poza ich standardowy proces zarządzania sekretami. Wraz ze wzrostem liczby wdrożeń — automatyczne skalowanie, wdrożenie typu blue-green, replikacja w wielu regionach — rosną również koszty operacyjne związane z udostępnianiem plików.

Zajmowana przestrzeń przez SDK i zarządzanie zależnościami

Gdy odczyt lub generowanie kodów kreskowych jest głównym lub jedynym wymaganiem usługi, instalacja LEADTOOLS składająca się z pięciu pakietów oraz zależność od środowiska uruchomieniowego MSVC++ 2017 stanowią obciążenie, które wpływa na rozmiar obrazu kontenera, opóźnienie przy zimnym starcie w funkcjach bezserwerowych oraz czas kompilacji w potokach CI/CD. Zespoły tworzące lekkie mikrousługi lub funkcje w stylu Lambda uważają, że wdrażanie pełnego zestawu SDK do przetwarzania obrazów w celu zaspokojenia konkretnych potrzeb związanych z kodami BarCode powoduje powstanie powierzchni zależności, którą trudno uzasadnić podczas przeglądów kodu i architektury. Gdy przyszła aktualizacja platformy wymaga przetestowania zmiany natywnej zależności środowiska uruchomieniowego, zadanie to spoczywa na zespole odpowiedziąlnym za utrzymanie usługi.

Przejrzystość cen

Zespoły programistyczne, które muszą oszacować budżet projektu przed rozpoczęciem prac, nie są w stanie uzyskać pełnego obrazu kosztów na podstawie cennika opublikowanego przez LEADTOOLS. Ceny licencji deweloperskich wynoszą od 1295 do 1469 USD rocznie na programistę, ale ceny licencji na wdrożenie produkcyjne aplikacji serwerowych są wyceniane osobno przez dział sprzedaży. Zespół pięciu programistów obsługujący trzy serwery produkcyjne musi uzyskać indywidualną wycenę, zanim będzie mógł potwierdzić, że LEADTOOLS mieści się w ich budżecie. Zespoły, które wolą podejmować decyzje dotyczące zakupów w oparciu o opublikowane ceny — porównując opcje, uzyskując wewnętrzną zgodę lub planując wieloletnie budżety — uważają, że ten model wymaga rozmowy handlowej przed zakończeniem oceny.

Wymagania dotyczące wyłącznie BarCode

Aplikacje, które muszą odczytywać lub generować kody kreskowe bez konieczności korzystania z funkcji OCR, obrazówania DICOM, adnotacji dokumentów lub innych funkcji Suite LEADTOOLS, płacą za platformę o szerszym zakresie niż wymagają tego ich potrzeby. Wartość integracyjna LEADTOOLS — możliwość przekazywania danych między modułami OCR, BARCODE i przetwarzania dokumentów — jest rzeczywista, ale ma zastosowanie tylko wtedy, gdy aktywnie wykorzystuje się wiele funkcji z tej Suite. Gdy wymagania ograniczają się do skanowania kodów kreskowych w interfejsie API lub generowania ich w procesie przetwarzania dokumentów, wyspecjalizowana biblioteka kodów kreskowych bezpośrednio spełnia te wymagania, nie obciążając systemu kompleksową platformą obrazówania.

Zastąpienie inicjalizacji licencji

Cały blok inicjalizacji LEADTOOLS — ścieżka do pliku, sprawdzanie ważności i weryfikacja blokady poszczególnych funkcji — został zastąpiony jedną linią. Klucz licencyjny IronBarcode można przechowywać w dowolnym systemie zarządzania sekretami, który obsługuje ciągi znaków:

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

Wzorzec zmiennej środowiskowej Docker

Wiersz COPY LEADTOOLS.LIC w każdym pliku Dockerfile zostaje całkowicie usunięty. Licencja jest udostępniana poprzez zmienną środowiskową w czasie wykonywania, która współpracuje ze wszystkimi standardowymi mechanizmami wstrzykiwania sekretów:

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

Usuwanie pakietów

Pięć pakietów LEADTOOLS — oraz opcjonalny kodek PDF — zostało usuniętych i zastąpionych jednym pakietem:

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