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

Wymagania dotyczące specyfikacji typu

Funkcja BarcodeScanner.Scan() w Spire.BarCode nie ma nadmiarowego wywołania, które akceptuje wyłącznie ścieżkę do pliku. Każda operacja odczytu wymaga, aby kod wywołujący zadeklarował format kodu kreskowego z wyprzedzeniem. W przypadku przepływów pracy opartych na jednym formacie jest to wykonalne, ale w przypadku przetwarzania dokumentów o mieszanych formatach powoduje to pętlę iteracji kandydatów:

// Spire.Barcode: multi-format detection requires a guessing loop
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: multi-format detection requires a guessing loop
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

Każdy typ dodany do tablicy kandydatów oznacza dodatkowy przebieg skanowania. Wszelkie formaty nieobecne na liście są pomijane bez powiadomienia. Programista jest odpowiedziąlny za prowadzenie wyczerpującego wykazu typów oraz ponowne testowanie za każdym razem, gdy do procesu wprowadzany jest nowy format.

Szczegółowe porównanie funkcji

Podejście Spire.BarCode

Funkcja BarcodeScanner.Scan() biblioteki Spire.BarCode wymaga podania parametru BarCodeType przy każdym wywołaniu. Wywołanie typu pojedynczego jest właściwe, gdy format jest znany i zagwarantowany:

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("barcode.png", BarCodeType.Code128)

For Each value As String In results
    Console.WriteLine(value)
Next

Gdy format nie jest znany z góry, jedynym dostępnym podejściem jest iteracja przez typy kandydujące. Każda iteracja to pełne skanowanie, a każdy format nieobecny na liście jest pomijany bez powiadomienia. Wynikiem jest string[], który nie zawiera żadnych informacji o typie, więc dalsze przekierowanie oparte na formacie wymaga dodatkowego zarządzania stanem przez wywołującego.

Podejście IronBarcode

IronBarcode's BarcodeReader.Read() nie wymaga parametru typu. Biblioteka automatycznie wykrywa format we wszystkich obsługiwanych symbolikach w jednym przebiegu. Odczyt BARCODE-ów z obrazów to pojedyncze wywołanie metody, niezależnie od tego, ile różnych formatów może zawierać źródło:

// IronBarcode — auto-detection built in
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.BarcodeType}: {result.Value}");
}

// IronBarcode — auto-detection built in
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.BarcodeType}: {result.Value}");
}

Imports IronBarCode

' IronBarcode — auto-detection built in
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.BarcodeType}: {result.Value}")
Next

Każdy obiekt wyniku zawiera BarcodeType, Value oraz metadane pozycyjne. Trasowanie w dół oparte na formacie nie wymaga dodatkowego stanu — typ jest obecny w samym wyniku.

Spire.BarCode Free Tier

FreeSpire.BarCode umieszcza duży znak wodny z informacją o wersji na wygenerowanych obrazach kodów kreskowych. Znak wodny zakrywa BARCODE w sposób, który sprawia, że nie nadaje się on do użytku produkcyjnego i uniemożliwia rzetelną ocenę jakości generowania. Wydajność skanowania jest celowo obniżona w wersji darmowej, co oznacza, że pomiary przepustowości wykonane podczas oceny nie odzwierciedlają rzeczywistej wydajności komercyjnej wersji Spire.BARCODE. Pakiet darmowy wymaga również klucza rejestracyjnego uzyskanego od E-iceblue, zanim okna dialogowe z ostrzeżeniami zostaną wyłączone podczas działania. Zestaw symboli dostępny w wersji bezpłatnej stanowi podzbiór oferty komercyjnej. Ograniczenia te łącznie oznaczają, że ocena oparta na FreeSpire.BarCode nie odzwierciedla dokładnie tego, co oferuje produkt komercyjny.

Tryb próbny IronBarcode

Wersja próbna IronBarcode to pakiet licencyjny używany bez klucza licencyjnego. Aplikacja Reading działa z pełną prędkością, obsługując wszystkie symbole i bez żadnych ograniczeń w działaniu. Opcje szybkości czytania i dokładności działają identycznie w trybie próbnym i licencjonowanym. Wygenerowany BARCODE w trybie próbnym zawiera niewielki znak wodny na krawędzi obrazu; nie zasłania samego kodu kreskowego. Zachowanie mierzone podczas oceny IronBarcode jest tym samym zachowaniem, które trafia do produkcji.

Podejście Spire.BarCode

Spire.BarCode nie posiada wbudowanej funkcji odczytu plików PDF. Aby wyodrębnić kody kreskowe z pliku PDF, programista musi zainstalować oddzielny pakiet Spire.PDF, zakupić oddzielną licencję Spire.PDF oraz napisać kod ręcznej iteracji stron i wyodrębniania obrazów, zanim będzie można rozpocząć skanowanie kodów kreskowych:

// Spire.Barcode + Spire.PDF: two libraries, two licenses
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required even here
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: two libraries, two licenses
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required even here
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

Dim pdf As New PdfDocument()
pdf.LoadFromFile("document.pdf")

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required even here
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

Ten wzorzec wymaga dwóch pakietów NuGet, dwóch umów licencyjnych oraz kodu do zarządzania stronami napisanego przez programistów. Jeśli BarCodes są osadzone w treści wektorowej, a nie w obrazach rastrowych w pliku PDF, metoda wyodrębniania obrazów może je całkowicie pominąć.

Podejście IronBarcode

IronBarcode obsługuje pliki PDF natywnie, bez żadnych dodatkowych zależności. Odczytywanie BARCODE-ów z dokumentów PDF to pojedyncze wywołanie metody przy użyciu tego samego interfejsu API BarcodeReader.Read(), co w przypadku plików graficznych. Numery stron są zawarte w każdym obiekcie wyniku:

// IronBarcode: native PDF support, no additional library
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}");
}

// IronBarcode: native PDF support, no additional library
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}");
}

Imports IronBarcode

Dim results = BarcodeReader.Read("document.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}")
Next

Nie jest wymagańe ręczne wyodrębnianie stron, dodatkowy pakiet ani zakup dodatkowej licencji.

Podejście Spire.BarCode

Model generowania Spire.BARCODE opiera się na zmiennym obiekcie konfiguracyjnym BarcodeSettings. Programista instancjonuje ustawienia, indywidualnie przypisuje właściwości, przekazuje obiekt ustawień do BarCodeGenerator, a następnie wywołuje GenerateImage():

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("barcode.png", ImageFormat.Png)

Obiekt ustawień, który może ulegać zmianom, oznacza, że konfiguracje mogą być przypadkowo udostępniane między wywołaniami, gdy pojedyncza instancja jest ponownie wykorzystywana w wielu operacjach generowania. Klasa generatora dodaje dodatkowy etap instancjonowania, który nie zawiera własnej logiki konfiguracyjnej.

Podejście IronBarcode

IronBarcode wykorzystuje statyczną metodę fabryczną z opcjonalnym łańcuchem płynnym. Nie ma obiektu ustawień ani instancji generatora do zarządzania:

// IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

// IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

Kody QR z niestandardowymi logo są dostępne we wszystkich poziomach licencji IronBarcode:

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-with-logo.png")

Przetwarzanie dokumentów o mieszanym formacie

Zespoły, które zaczynają od jednego znanego formatu BARCODE, często zauważają, że z czasem różnorodność formatów BARCODE rośnie. Aplikacja magazynowa, która zaczynała od etykiet Code128, może otrzymywać dostawy od dostawców korzystających z kodów DataMatrix, GS1-128 lub QR. Każdy nowy format wprowadzony do przepływu pracy wymaga aktualizacji tablicy kandydatów w pętli odgadywania typu, ponownego przetestowania logiki wykrywania oraz potwierdzenia, że żaden istniejący format nie został wyparowany przez kolejność iteracji. Kiedy różnorodność formatów osiąga punkt, w którym nakłady na utrzymanie tej pętli stają się powtarzającym się kosztem rozwoju, zespoły oceniają, czy automatyczne wykrywanie całkowicie wyeliminowałoby to obciążenie.

Integracja z PDF

W aplikacjach obsługujących duże ilości dokumentów często zdarza się, że BarCodes muszą być wyodrębniane z plików PDF, a nie z pojedynczych obrazów. W przepływie pracy Spire.BarCode przejście to wymaga nabyćia licencji Spire.PDF, zintegrowania drugiego pakietu oraz napisania infrastruktury do iteracji stron i wyodrębniania obrazów, zanim będzie można przystąpić do odczytu kodów kreskowych. Zespoły, które nie przewidziały tego wymogu przy początkowym zakupie, muszą teraz zarządzać dwiema licencjami na produkty i dwoma interfejsami API w celu wykonania zadania, które koncepcyjnie należy do odczytu kodów kreskowych. Odkrycie, że obsługa plików PDF wymaga osobnego zakupu, jest częstym powodem ponownej oceny wyboru produktu.

Ograniczenia dotyczące bezpłatnego poziomu

Zespoły, które przetestowały FreeSpire.BarCode, a następnie zakupiły licencję komercyjną, czasami zgłaszają, że produkt komercyjny zachowuje się inaczej niż sugerowały to wyniki testów. Jest to zamierzone działanie: bezpłatna wersja celowo obniża wydajność odczytu i ogranicza zestaw symboli, co oznacza, że testy porównawcze i testy pokrycia formatów przeprowadzone podczas oceny nie mają zastosowania w przypadku wdrożenia komercyjnego. Kiedy zespół odkrywa tę rozbieżność po zakupie, często szuka alternatyw, których zachowanie w wersji próbnej jest reprezentatywne dla zachowania w środowisku produkcyjnym.

Zmniejszenie liczby produktów

Organizacje, które standaryzują swój stos technologiczny, czasami identyfikują Spire.BarCode jako jeden z elementów rosnącego asortymentu produktów E-iceblue, z których każdy ma własny koszt licencji i cykl odnowienia. Jeśli głównym motorem działania Spire.BarCode jest odczytywanie kodów kreskowych w ramach procesu przetwarzania dokumentów — a nie głęboka integracja z Spire.Doc lub Spire.XLS — zespoły oceniają, czy pojedyncza, samodzielna biblioteka kodów kreskowych zmniejszyłaby zarówno złożoność licencjonowania, jak i zakres wsparcia technicznego.

Usunięcie parametru BarCodeType

Każde wywołanie scanner.Scan() w kodzie źródłowym Spire.BarCode zawiera argument BarCodeType. Zastąpienie tych wywołań przez BarcodeReader.Read() całkowicie usuwa parametr typu. Pętle odgadywania typów — bloki foreach, które iterują przez potencjalne wartości BarCodeType — można całkowicie usunąć; Pojedyncze wywołanie BarcodeReader.Read() zastępuje całą pętlę.

Aktualizacja typu zwracanej wartości

Funkcja Scan() biblioteki Spire.BarCode zwraca string[]. IronBarcode zwraca kolekcję BarcodeResults. Należy zaktualizować miejsca wywołań, które przypisują string[] lub przekazują wyniki do metod oczekujących tego typu. Pobieranie wartości jako tablicy odbywa się za pomocą .Select(r => r.Value).ToArray(); Dostęp do pierwszego wyniku odbywa się za pomocą .First()?.Value.

Usunięcie pakietu Spire.PDF

Jeśli Spire.PDF został zainstalowany wyłącznie w celu obsługi wyodrębniania kodów kreskowych z plików PDF, można go usunąć po migracji do IronBarcode. Wszystkie importy using Spire.Pdf; i bloki iteracji stron podręcznika zostały zastąpione pojedynczym wywołaniem BarcodeReader.Read("file.pdf"). Jeśli Spire.PDF jest używane do innych operacji na dokumentach poza wyodrębnianiem kodów BARCODE, należy je zachować i zastąpić jedynie ścieżki kodu związane z kodami BARCODE.

Zmiany w przestrzeni nazw

Zastąp using Spire.Barcode; przez using IronBarCode;. Wyliczenie BarCodeType jest zastępowane przez BarcodeEncoding podczas generowania i nie wymaga odpowiednika podczas odczytu. Inicjalizacja licencji zmienia się z BarcodeSettings.ApplyKey() lub Spire.License.LicenseProvider.SetLicenseKey() na pojedyncze przypisanie właściwości IronBarCode.License.LicenseKey podczas uruchamiania aplikacji.