API generacji Barcode4NET

Cały proces generowania wBarcode4NETwykorzystywał wzorzec ustawiający właściwości:

//Barcode4NET— manual DLL,.NET Frameworkonly
// Nie Pakiet NuGet — requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

//Barcode4NET— manual DLL,.NET Frameworkonly
// Nie Pakiet NuGet — requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Dim barcode As New Barcode4NET.Barcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.Width = 300
barcode.Height = 100
Dim barcodeImage As Bitmap = barcode.GenerateBarcode()
barcodeImage.Save(outputPath, ImageFormat.Png)

To wszystko, co oferuje interfejs API Barcode4NET. Biblioteka nie oferowała płynnego łączenia, nie posiadała możliwości odczytu, nie wspierała kodu QR i zaawansowanych opcji 2D, takich jak osadzanie logo lub kontrola korekcji błędów.

Szczegółowe porównanie funkcji

Podejście Barcode4NET

Barcode4NET wykorzystywał imperatywny wzorzec ustawiający właściwości. Deweloperzy instancjowali obiekt Barcode, przypisywali indywidualne wlasciwosci, nastepnie wywolywali GenerateBarcode(), aby otrzymac System.Drawing.Bitmap:

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Public Function GenerateLabel(sku As String) As Bitmap
    Dim barcode As New Barcode4NET.Barcode()
    barcode.Symbology = Symbology.Code128
    barcode.Data = sku
    barcode.Width = 400
    barcode.Height = 120
    Return barcode.GenerateBarcode()
End Function

Typ zwracany — System.Drawing.Bitmap — oznaczalo, ze kod wywolujacy byl odpowiedzialny za zapis, wyswietlenie lub strumieniowanie obrazu. Bylo to odpowiednie dla aplikacji WinForms, gdzie Bitmap mogl byc bezposrednio przypisany do PictureBox, ale wymagalo dodatkowych krokow konwersji dla kazdego innego celu wyjscia.

Podejście IronBarcode

IronBarcode wykorzystuje płynny statyczny interfejs API. Pojedyncze wywołanie metody inicjuje generowanie, a metody łańcuchowe konfigurują wynik przed metodą końcowego zapisania lub konwersji:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateLabel(sku As String) As Byte()
    Return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .ToPngBinaryData()
End Function

Enum BarcodeEncoding odpowiada bezposrednio enum'owi Symbology. .ResizeTo() zastepuje przypisania wlasciwosci Width i Height. Metody terminalne — .SaveAsPng(), .SaveAsJpeg(), .ToPngBinaryData() — zastepuja oddzielne wywolania GenerateBarcode() i zapisu bitmapy. W przypadku bardziej zaawansowanych scenariuszy generowania kodów kreskowych zapoznaj się z dokumentacją dotyczącą generowania kodów kreskowych IronBarcode.

Podejście Barcode4NET

Barcode4NET nie posiadał API do odczytu. Zespoły, które musiały dekodować BARCODES z obrazów lub zeskanowanych dokumentów, musiały zintegrować całkowicie oddzielną bibliotekę — albo ZXing.Net, alternatywę open source, albo komercyjny zestaw SDK do skanowania. W rezultacie powstały dwa oddzielne łańcuchy zależności:Barcode4NETdo generowania oraz druga biblioteka do odczytu.

Podejście IronBarcode

IronBarcode zapewnia BarcodeReader.Read() jako metode statyczna, ktora akceptuje sciezki do plikow obrazow, obiekty strumieniowe i dokumenty PDF:

using IronBarCode;

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

// Read all barcodes from a multi-page PDF — no extra PDF library required
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

using IronBarCode;

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

// Read all barcodes from a multi-page PDF — no extra PDF library required
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

Imports IronBarCode

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

' Read all barcodes from a multi-page PDF — no extra PDF library required
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

Dla scenariuszy z duza iloscia danych lub zakloconych obrazow klasa BarcodeReaderOptions zapewnia kontrole nad predkoscia odczytu i wykrywaniem wielu kodow kreskowych. Opcje konfiguracyjne można znaleźć w dokumentacji dotyczącej odczytu kodów kreskowych BarCode.

Podejście Barcode4NET

Barcode4NET został skompilowany przy użyciu zestawów .NET Framework. Działało w systemie Windows, w aplikacjach .NET Framework, w projektach Web Forms i Windows Forms hostowanych przez IIS. Nie było kompilacji dla systemu Linux, kompilacji dla .NET Core ani obsługi środowiska uruchomieniowego w chmurze. Kiedy firma Microsoft wprowadziła platformę .NET Core, a następnie ujednoliciła ją jako .NET 5+, produktBarcode4NETnie otrzymał odpowiednich aktualizacji. Zadnen projekt celujacy w net5.0 lub nowszy nie mogl odniesc sie do biblioteki w ogole.

Model dystrybucji DLL pogłębił ograniczenia platformy. Każde środowisko kompilacji — stacja robocza programisty, agent kompilacji, kontenerDocker— wymagało, aby biblioteka DLL znajdowała się w znanej ścieżce. W wykladowych wdrozeniach oparte na kontenerach oznaczalo to albo pieczenie DLL w niestandardowy obraz bazowy, albo kopiowanie podczas budowy kontenera, zaden z nich nie jest zgodny z normalnymi procesami dotnet restore.

Podejście IronBarcode

IronBarcode obsługuje wiele frameworków z jednego pakietu NuGet: od.NET Framework4.6.2 do .NET 9 oraz wszystkie aktualne wersje .NET na systemach Windows, Linux i macOS. Wdrażanie do kontenerówDockerwykorzystuje standardowe obrazy środowiska uruchomieniowego .NET Standard bez modyfikacji. Azure Functions, AWS Lambda i inne środowiska uruchomieniowe bezserwerowe są obsługiwane przez ten sam pakiet NuGet. Polecenie dotnet restore rozwiazuje wszystkie zaleznosci bez manualnego zarzadzania plikami DLL.

Podejście Barcode4NET

Barcode4NET faktycznie kończy swój żywot. Nowe licencje nie są już sprzedawane przez ComponentSource, choć istniejący klienci mogą przedłużyć wsparcie i aktualizacje oprogramowania przez ComponentSource zgodnie z warunkami dostawcy. Jeśli nowy programista dołącza do zespołu używającego Barcode4NET, nie ma mechanizmu na zakupienie dodatkowego miejsca dla niego. Ostatnia wersja kodu była wersji 2.0 w 2007 roku, więc wszelkie wykryte od tego czasu defekty lub problemy z bezpieczeństwem nie są adresowane przez patche.

Podejście IronBarcode

IronBarcode to aktywnie rozwijany produkt komercyjny z Licencją wieczystą. Ceny zaczynają się od 749 USD za Lite License dla jednego programisty, dostępne są również poziomy Plus License (1499 USD, 3 programistów), Professional License (2999 USD, 10 programistów) oraz Unlimited License (5999 USD). Wszystkie poziomy obejmują wdrożenie bez opłat licencyjnych. Poprawki bezpieczeństwa, poprawki błędów i aktualizacje zgodności z wersjami .NET są dostarczane w regularnych odstępach czasu. Dostępna jest 30-dniowa bezpłatna wersja próbna do oceny bez klucza licencyjnego.

Zablokowana aktualizacja .NET

Najczęstszym czynnikiem skłaniającym do tłumaczenia jest projekt modernizacji platformy .NET. Zespol celuje net8.0 w swoj .csproj, uruchamia budowe i napotyka blad ladowania, poniewazBarcode4NETbyl zbudowany dla.NET Framework1.1 / 2.0 / 3.x i nie moze byc odniesiony z nowoczesnego celu .NET. W tej chwili zespół stoi przed dylematem — cofnąć zmianę frameworka docelowego i pozostać przy.NET Frameworklub zastąpić Barcode4NET. Migracji nie można odłożyć bez zablokowania szerszych działań modernizacyjnych.

Awarie potoku CI/CD po zmianach infrastruktury

Model dystrybucji bibliotek DLL firmyBarcode4NETpowoduje utajoną niestabilność w procesach kompilacji. W przypadku ponownego skonfigurowania agenta kompilacji, aktualizacji obrazu kontenera lub skonfigurowania nowego środowiska CI, bibliotekę DLLBarcode4NETnależy ręcznie umieścić w ścieżce oczekiwanej przez plik projektu. Zespoły, które nie udokumentowały tego etapu dokładnie, odkrywają problem dopiero wtedy, gdy proces się nie powiedzie. Przejscie na IronBarcode oznacza, ze dotnet restore zajmuje sie wszystkim — problem lokalizacji DLL przestaje istniec.

Nowi członkowie zespołu nie mogą uzyskać licencji

Gdy do projektu dołącza wykonawca lub drugi programista musi pracować nad funkcjami BarCode, nie ma potrzeby zakupu licencji. Zespół musi obejść to ograniczenie — albo nowy programista całkowicie unika kodu BARCODE, albo ktoś przenosi licencję, która zgodnie z pierwotnymi warunkami może nie podlegać przeniesieniu. Żadna z tych sytuacji nie jest do utrzymania dla zespołu, który aktywnie rozwija produkt.

Audyty bezpieczeństwa i zgodności

Organizacje, które generują listy komponentów oprogramowania (SBM) lub sprawdzają zależności w bazach danych dotyczących wycofanych produktów, napotykająBarcode4NETjako wynik wyszukiwania. To komercyjny produkt bez wydawań kodu od 2007 roku i bez śledzenia CVE ani strumienia poprawek. Audytorzy bezpieczeństwa zazwyczaj traktują zależności w tym stanie inaczej niż utrzymywane aktywnie biblioteki, a wykryte problemy często stają się formalnym elementem do naprawy, a nie odłożonym ryzykiem.

Możliwość czytania dodana do istniejącego przepływu pracy

Zespoły, które początkowo używałyBarcode4NETwyłącznie do generowania kodów kreskowych, później odkrywają, że muszą weryfikować kody kreskowe ze skanowanych dokumentów, przetwarzać obrazy przesłane przez użytkowników lub wyodrębniać dane z faktur w formacie PDF. W przypadkuBarcode4NETwymaga to zintegrowania drugiej biblioteki. Funkcjonalnosc BarcodeReader.Read() w IronBarcode obsluguje zarowno obrazy jak i PDF-y natywnie, konsolidujac zaleznosc w jeden utrzymywany pakiet.

Usunięcie odwołania do biblioteki DLL

Barcode4NET nigdy nie byl dystrybuowany jako pakiet NuGet, wiec nie ma komendy dotnet remove package. Kazdy plik .csproj, ktory odnosi sie do biblioteki, zawiera element <Reference Include="Barcode4NET"> z <HintPath> wskazujacym na DLL na dysku. Każdy z tych elementów musi zostać znaleziony i usunięty ręcznie. Wyszukiwanie w całym rozwiązaniu pozwala je zlokalizować:

grep -rl "Barcode4NET" --include="*.csproj" .

grep -rl "Barcode4NET" --include="*.csproj" .

Katalog DLL w kontroli zrodel — zazwyczaj ThirdParty/Barcode4NET/ lub lib/ — musi rowniez byc przygotowany do usuniecia z git rm.

Zmiana typu zwracanego z bitmapy na tablicę bajtów

Funkcja GenerateBarcode() wBarcode4NETzwraca System.Drawing.Bitmap. W lancuchu fluent w IronBarcode konczy sie .ToPngBinaryData() zwracajac byte[], lub .SaveAsPng() zapisujac bezposrednio na dysku. Kod, ktory przypisuje wartosc zwracana do zmiennej typu Bitmap lub przekazuje go do metody oczekujacej Bitmap — takiej jak formularz WinForms PictureBox — wymaga jednej linii dostosowania w miejscu wywolania: owijanie tablicy bajtowej w MemoryStream i wywolanie Image.FromStream().

Symbologia Zmiana nazwy wyliczenia

Enum Symbology wBarcode4NETbezposrednio odwzorowuje sie na enum BarcodeEncoding w IronBarcode. Wszystkie typowe wartosci — Code128, Code39, EAN13, UPCA, QRCode — zachowuja swoje nazwy. Rozwiazanie globalne znajdz-i-zamien Symbology. na BarcodeEncoding. obejmuje wiekszosc przypadkow, chociaz kazda wymiana powinna byc sprawdzana, aby potwierdzic kontekst.

Porządkowanie skryptów kompilacji

Należy zaktualizować skrypty kompilacji oraz pliki konfiguracyjne CI/CD, które kopiują bibliotekę DLLBarcode4NETdo katalogów wyjściowych lub agentów kompilacji. Te kroki nie maja odpowiednika po migracji NuGet — dotnet restore zastepuje wszystke reczne zarzadzanie DLL. Pozostawienie nieaktualnych kopii plików DLL po migracji nie spowoduje błędów kompilacji, ale stanowią one martwą konfigurację, która może powodować zamieszanie wśród przyszłych opiekunów projektu.