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:

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

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 bool dla includeChecksum, QrEncoder.Encode przyjmuje poziom korekty bledow i dwa dodatkowe bool, a DataMatrixEncoder.Encode przyjmuje tylko ciag znakow. 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 formatow oznacza dodanie nowej dyrektywy using i uzycie innej klasy z inna sygnatura metody:

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

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

// DataMatrix
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

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

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

// DataMatrix
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
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix
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 zrozumienia.

Podejście IronBarcode

IronBarcode kieruje caly wybor formatu przez enum BarcodeEncoding w zunifikowanej 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated 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-LICENSE-KEY";

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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. Aby zapisac do pliku, nalezy otworzyc FileStream. Aby uzyskac dane binarne, nalezy otworzyc MemoryStream i wywolac ToArray(). Każdy scenariusz wyjściowy wymaga skonstruowania renderera z obiektem opcji:

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' File output
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})
Using stream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Binary data via MemoryStream
Using ms = New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

Kontrola rozmiaru jest posrednia: PixelSize jest mnoznikiem skali na rozmiarze modulu kodu kreskowego, a nie bezposrednim okresleniem szerokosci i wysokosci.

Podejście IronBarcode

IronBarcode zwraca obiekt GeneratedBarcode, z ktorego kazda forma wyjsciowa moze byc osiagnieta poprzez laczone wywolania 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 jawne wymiary pikseli i laczy sie z kazda metoda wyjsciowa 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() przyjmuje pliki graficzne, tablice bajtowe, strumienie i pliki PDF natywnie:

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 natively
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 natively
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 natively
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 przestal wspierac .NET Framework. Zespoły zajmujące się utrzymaniem usług lub aplikacji desktopowych w środowisku.NET Framework4.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 Framework4.6.2 do.NET 9bez specjalnych pakietów lub zależności warunkowych dla różnych środowisk docelowych.

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

Gdy Barcoder i Barcoder.Renderer.Image sa wersjonowane niezaleznie, aktualizacja jednego bez drugiego podczas odswiezania zaleznosci moze wprowadzic subtelne niezgodnosci. 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 IronBarcode, dodanie formatu to zmiana wartosci enum BarcodeEncoding w istniejacym wywolaniu. 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.

IBarcode do zmiany typu GeneratedBarcode

Kod Barcoder, ktory przechowuje zmienna IBarcode i przekazuje ja do renderer'a pozniej, musi zostac przeksztalcony. W IronBarcodeGeneratedBarcode zawiera swoje wlasne metody wyjsciowe — nie ma osobnego kroku renderera. Kazda sygnatura metody, ktora obecnie przyjmuje IBarcode, powinna zostac zmieniona, aby przyjmowac GeneratedBarcode, a wywolanie renderowania w tej metodzie powinno stac sie bezposrednim wywolaniem, jak .SaveAsPng() lub .ToPngBinaryData(). System typow ujawni kazda lokalizacje, ktora wymaga aktualizacji podczas kompilacji — IBarcode nie bedzie rozwiazany po usunieciu pakietow Barcoder.

PixelSize nie ma bezposredniego odpowiednika

PixelSize BarCode jest mnoznikiem skalujacym na naturalnym rozmiarze modulu kodu kreskowego, a nie jawna wielkoscia pikseli. Szerokość wydruku zależy od zawartości BarCode, formatu oraz mnożnika w połączeniu.IronBarcode korzysta z .ResizeTo(width, height) z jawnymi wymiarami pikseli. Podczas migracji nalezy zmierzyc rzeczywiste wymiary wyjscia, jakie produkowane sa przez istniejacy kod Barcoder, i uzyc tych wartosci w wywolaniu .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 kumuluja oswiadczenia using Barcoder.* — jedno na uzyty format. Podczas migracji wszystkie one scalaja sie do pojedynczego using IronBarCode;. Wyszukiwanie using Barcoder w calej rozwiazaniu zidentyfikuje kazdy plik, ktory wymaga 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 korzystajace z Barcoder.Renderer.Svg oraz klasy SvgRenderer zastepuja potok renderer'a bezposrednim wywolaniem metody na 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 moze zostac usuniety, gdy wszystkie miejsca renderowania SVG zostana zmigrowane.