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

Proces tworzenia pakietów wielopłatformowych

Opis instalacji od razu ilustruje różnicę w zakresie. W przypadku BarCode podstawowy wynik w formacie PNG wymaga dwóch oddzielnych pakietów:

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

Pełny przebieg generowania kodu kreskowego Code128 i zapisywania go jako pliku PNG wymaga trzech importów przestrzeni nazw, wywołania kodera specyficznego dla formatu, konstrukcji renderera z obiektem opcji, strumienia plików oraz wywołania renderowania:

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

Zmiana formatów kodów kreskowych nie jest zmianą parametrów — wymaga zaimportowania innej przestrzeni nazw i wywołania innej klasy. Code128Encoder.Encode przyjmuje wartość typu bool dla includeChecksum, QrEncoder.Encode przyjmuje poziom korekcji błędów i dwie dodatkowe wartości typu bool, a DataMatrixEncoder.Encode przyjmuje tylko ciąg znaków. Nie ma jednolitego interfejsu do tworzenia BARCODE'ów w określonym formacie.

Szczegółowe porównanie funkcji

Podejście BarCode

BarCode kieruje wybór formatu przez oddzielne klasy koderów w oddzielnych przestrzeniach nazw. Zmiana formatów oznacza dodanie nowej dyrektywy using oraz użycie innej klasy z inną sygnaturą metody:

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

Każdy koder ma własną umowę dotyczącą parametrów. Dodanie nowego formatu do istniejącego projektu to nie tylko zmiana jednego słowa — to import nowej przestrzeni nazw, nowa klasa do opanowania i nowe parametry do zrozumieniuiuiuiuia.

Podejście IronBarcode

IronBarcode kieruje cały wybór formatów przez wyliczenie BarcodeEncoding w ujednoliconej klasie BarcodeWriter. Dodanie nowego formatu wymaga zmiany jednej litery w wartości wyliczenia:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

W celu użycia w środowisku produkcyjnym należy dodać klucz licencyjny podczas uruchamiania aplikacji:

IronBarCode.License.LicenseKey = "YOUR-KEY";

IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

Dokumentacja dotycząca generowania kodów kreskowych w IronBarcode obejmuje pełen zakres opcji generowania, w tym stylizację, marginesy i dostosowywanie kolorów.

Podejście BarCode

Oddzielenie kodowania od renderowania w BarCoderze jest oparte na zasadach architektury, ale powoduje dodatkowe obciążenie przy każdej zmianie formatu wyjściowego. Zapisanie do pliku wymaga otwarcia FileStream. Pobieranie danych binarnych wymaga otwarcia MemoryStream i wywołania ToArray(). Każdy scenariusz wyjściowy wymaga skonstruowania renderera z obiektem opcji:

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

Kontrola rozmiaru jest pośrednia: PixelSize jest mnożnikiem skali rozmiaru modułu BarCode, a nie bezpośrednią specyfikacją szerokości i wysokości.

Podejście IronBarcode

IronBarcode zwraca obiekt GeneratedBarcode, z którego można uzyskać dowolną formę wyjściową poprzez łańcuch wywołań metod. Bez tworzenia rendererów, bez zarządzania strumieniami:

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height) przyjmuje wyraźne wymiary w pikselach i łączy się z dowolną metodą wyjściową na tym samym obiekcie.

Podejście BarCode

BarCode nie posiada funkcji odczytu ani dekodowania. W bibliotece nie ma API, nie planuje się wprowadzenia API ani nie ma żadnych rozwiązań zastępczych. Jeśli aplikacja musi odczytywać kody kreskowe, obok biblioteki BarCode należy dodać drugą bibliotekę — oddzielną zależność NuGet z własnym interfejsem API i własną wersją do śledzenia. Oznacza to co najmniej dwie zależności związane z odczytem: BarCode do generowania i coś innego do odczytu.

Podejście IronBarcode

IronBarcode obsługuje zarówno generowanie, jak i odczyt za pomocą tego samego pakietu i spójnych wzorców API. Metoda BarcodeReader.Read() akceptuje natywnie pliki graficzne, tablice bajtów, strumienie i pliki PDF:

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// Czytaj z pliku PDF — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// Czytaj z pliku PDF — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine(result.Value)
    Console.WriteLine(result.Format)
Next

' Czytaj z pliku PDF — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

Odczyt z plików PDF jest natywny — bez pośredniego wyodrębniania obrazów, bez biblioteki konwersji, bez dodatkowych pakietów. Dokumentacja dotycząca odczytu kodów kreskowych IronBarcode obejmuje wielostronicowe pliki PDF, odczyt obszarów zainteresowania oraz optymalizację wydajności.

Do wymagań dodano czytanie

Wiele projektów zaczyna się od zwykłych procesów generowania — drukowania etykiet, tworzenia kodów dla dokumentów, umieszczania BarCodes w raportach. BarCode obsługuje te projekty od samego początku. Gdy ta sama aplikacja będzie później musiała weryfikować przychodzące kody kreskowe, przetwarzać zeskanowane dokumenty lub dekodować kody kreskowe z przesłanych plików PDF, BarCode nie oferuje żadnego rozwiązania. Zespół musi ocenić drugą bibliotekę, zapoznać się z jej API, zarządzać jej wersją NuGet oddzielnie oraz zająć się integracją między dwiema bibliotekami. Zespoły, które osiągają ten etap, często konsolidują się w bibliotece obsługującej obie strony, zamiast utrzymywać dwie oddzielne zależności związane z BARCODE'ami.

Złamanie zgodności z platformą .NET Framework

Barcoder.Renderer.Image zrezygnowało z obsługi .NET Framework. Zespoły zajmujące się utrzymaniem usług lub aplikacji desktopowych w środowisku .NET Framework 4.x, które aktualizują pakiet renderera obrazów podczas rutynowej konserwacji zależności, napotykają błąd kompilacji. Nie jest to błąd konfiguracji — jest to decyzja biblioteki dotycząca obsługi platformy. IronBarcode obsługuje platformy od .NET Framework 4.6.2 do .NET 9 bez specjalnych pakietów lub zależności warunkówych dla różnych środowisk docelowych.

Różnice w wersjach pakietów powodują problemy z koordynacją

Ponieważ wersje Barcoder i Barcoder.Renderer.Image są niezależne, aktualizacja jednej z nich bez drugiej podczas odświeżania zależności może spowodować subtelne niezgodności. W repozytorium zawierającym wiele projektów — z których każdy korzysta z innej wersji każdego pakietu renderującego — zapewnienie spójnego działania we wszystkich projektach staje się problemem koordynacyjnym, który rośnie wraz z wielkością zespołu. Zespoły, które przeszły na IronBarcode, zgłaszają, że zarządzanie jednym pakietem i jedną wersją całkowicie eliminuje tego typu problemy.

Zakres formatów rozszerza się z biegiem czasu

Projekt może rozpocząć się od etykiet Code128, a następnie dodać kody QR dla linków przeznaczonych dla klientów, a potem DataMatrix w celu spełnienia wymogów zgodności. W przypadku Barcodera każde dodanie formatu oznacza import nowej przestrzeni nazw, inną klasę kodera z innymi parametrami metod oraz potencjalnie nowy pakiet NuGet. W przypadku IronBarcode dodanie formatu polega na zmianie wartości wyliczeniowej BarcodeEncoding w istniejącym wywołaniu. Zespoły, których plany rozwoju obejmują rozszerzenie obsługi formatów kodów kreskowych, uważają model oparty na wyliczeniach za znacznie łatwiejszy w utrzymaniu.

Wymagania dotyczące MAUI i wdrażania wielopłatformowego

BarCode nie dokumentuje obsługi wdrożeń MAUI, Docker, AWS Lambda ani Azure. Zespoły tworzące wielopłatformowe aplikacje MAUI lub wdrażające przetwarzanie kodów kreskowych w infrastrukturze bezserwerowej zauważają, że dokumentacja i testy Barcodera nie obejmują tych celów. IronBarcode dokumentuje i aktywnie testuje wdrażanie na platformach iOS, Android, Windows, macOS MAUI, w kontenerach Docker oraz na głównych platformach chmurowych.

Zmiana typu z IBarcode na GeneratedBarcode

Kod BarCode, który przechowuje zmienną IBarcode i przekazuje ją później do renderera, musi zostać zrefaktoryzowany. W IronBarcode GeneratedBarcode posiada własne metody wyjściowe — nie ma oddzielnego etapu renderowania. Każda sygnatura metody, która obecnie akceptuje IBarcode, powinna zostać zmieniona tak, aby akceptowała GeneratedBarcode, a wywołanie renderowania wewnątrz tej metody powinno stać się wywołaniem bezpośrednim, takim jak .SaveAsPng() lub .ToPngBinaryData(). System typów wskaże wszystkie miejsca wymagające aktualizacji podczas kompilacji — IBarcode nie zostanie rozwiązane po usunięciu pakietów BARCODE.

PixelSize Nie ma bezpośredniego odpowiednika

PixelSize firmy BarCode to mnożnik skali naturalnego rozmiaru modułu BARCODE, a nie konkretny wymiar w pikselach. Szerokość wydruku zależy od zawartości BarCode, formatu oraz mnożnika w połączeniu. IronBarcode używa .ResizeTo(width, height) z wyraźnymi wymiarami w pikselach. Podczas migracji zmierz rzeczywiste wymiary wyjściowe generowane przez istniejący kod BARCODE i użyj tych wartości w wywołaniu .ResizeTo():

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

Konsolidacja przestrzeni nazw

Projekty BarCode gromadzą instrukcje using Barcoder.* — po jednej dla każdego używanego formatu. Podczas migracji wszystkie te elementy zostaną zredukowane do pojedynczego using IronBarCode;. Wyszukanie using Barcoder w całym rozwiązaniu pozwoli zidentyfikować wszystkie pliki wymagające aktualizacji. Liczba plików, których to dotyczy, jest zazwyczaj większa niż zespoły się spodziewają, ponieważ każdy plik związany z formatem BarCode importował własną przestrzeń nazw specyficzną dla tego formatu.

Zmiany ścieżki wyjściowej SVG

Projekty wykorzystujące Barcoder.Renderer.Svg i klasę SvgRenderer zastępują potok renderowania bezpośrednim wywołaniem metody GeneratedBarcode:

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

Pakiet Barcoder.Renderer.Svg można usunąć po migracji wszystkich witryn renderujących SVG.