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

Platforma i historia konserwacji

Metadane pakietu NuGet dla MessagingToolkit.BARCODE dokumentują jego docelowe przeznaczenie. Każda pozycja w poniższej tabeli odpowiada platformie, która była aktualna lub prawie aktualna w momencie tworzenia biblioteki:

Biblioteka nie posiada kompatybilnego frameworka docelowego dla .NET Core, .NET 5, .NET 6, .NET 7, .NET 8 ani .NET 9. Projekty skierowane do tych środowisk uruchomieniowych napotkają błąd kompilacji, gdy pakiet nie będzie w stanie rozpoznać kompatybilnego monikera frameworka — nie będzie to ostrzeżenie środowiska uruchomieniowego, ale błąd kompilacji.

Szczegółowe porównanie funkcji

Podejście MessagingToolkit.BarCode

MessagingToolkit.BarCode jest przeznaczony wyłącznie dla platform .NET Framework 3.5, 4.0 i 4.5. Nie ma monikera .NET Standard, nie jest przeznaczony dla .NET Core i nie ma nakładki kompatybilności dla nowoczesnych środowisk uruchomieniowych. Gdy plik projektu odwołuje się do tego pakietu i jest przeznaczony dla dowolnej nowoczesnej wersji .NET, operacja przywracania NuGet kończy się niepowodzeniem z powodu błędu zgodności frameworka — kompilacja nie jest kontynuowana.

Tabela platform w metadanych NuGet konkretnie to ilustruje. Wymieniono wersje docelowe Silverlight 3, 4 i 5; wszystkie trzy zostały wycofane z rynku w 2021 r. Wymieniono systemy Windows Phone 7.0, 7.5, 7.8 i 8.0; Wszystkie z nich przestały być obsługiwane w latach 2014–2017. Pozostałe wersje — .NET Framework 3.5, 4.0 i 4.5 — nadal działają w systemie Windows, ale Microsoft dostarcza dla nich tylko poprawki bezpieczeństwa, bez wprowadzania nowych funkcji.

W praktyce oznacza to, że MessagingToolkit.BarCode działa jako czynnik hamujący modernizację frameworka. Plik projektu, który jest skierowany do net472 i odwołuje się do tego pakietu, nie może zostać zmieniony na net8.0 bez uprzedniego usunięcia pakietu. Pakiet ten nie jest jedynie przestarzały — aktywnie uniemożliwia zmianę docelowego środowiska, która pozwoliłaby projektowi na dostęp do nowoczesnych możliwości .NET Framework.

Zapoznaj się z dokumentacją platformy IronBarcode, aby uzyskać pełną listę obsługiwanych frameworków i środowisk wdrożeniowych.

Podejście IronBarcode

IronBarcode obsługuje platformy od .NET Framework 4.6.2 do .NET 9, obejmując zarówno starsze aplikacje Windows, jak i nowoczesne wdrożenia wielopłatformowe. Pojedynczy pakiet NuGet instaluje się na wszystkich obsługiwanych platformach bez konieczności stosowania oddzielnych bibliotek graficznych lub konfiguracji specyficznej dla danej platformy.

Obsługa wielu platform ma praktyczne znaczenie. Wewnętrzny potok obrazów IronBarcode nie jest zależny od System.Drawing, który w .NET 6 stał się dostępny wyłącznie w systemie Windows. Aplikacje przeznaczone dla systemów Linux lub macOS — w tym te działające w kontenerach Docker, usłudze Azure App Service na systemie Linux lub AWS Lambda — korzystają z tego samego interfejsu API i zachowania IronBarcode, co wdrożenia w systemie Windows.

Podejście MessagingToolkit.BarCode

Odczyt za pomocą MessagingToolkit.BarCode wymagał utworzenia instancji BarcodeDecoder, skonstruowania Bitmap z pliku obrazu, przekazania mapy bitowej do .Decode() oraz sprawdzenia wyniku pod kątem wartości null przed uzyskaniem dostępu do .Text. Generowanie przebiegało według tego samego wzorca instancji: utwórz BarcodeEncoder, ustaw jego właściwość .Format, wywołaj .Encode(), aby otrzymać Bitmap, a następnie wywołać .Save() na tej mapie bitowej.

// Only compiles on .NET Framework 4.5 or earlier
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

// Only compiles on .NET Framework 4.5 or earlier
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

Imports MessagingToolkit.Barcode
Imports System.Drawing

' Reading
Dim barcodeReader As New BarcodeDecoder()
Dim bitmap As New Bitmap("barcode.png")
Dim result = barcodeReader.Decode(bitmap)
Dim value As String = result?.Text
Dim format As String = result?.BarcodeFormat.ToString()

' Writing
Dim barcodeWriter As New BarcodeEncoder()
barcodeWriter.Format = BarcodeFormat.QrCode
Dim outputBitmap = barcodeWriter.Encode("Hello World")
outputBitmap.Save("output.png")

Zależność Bitmap nie jest przypadkowa. System.Drawing.Bitmap wymaga GDI+ w systemie Windows. W .NET 6 i nowszych wersjach próba użycia System.Drawing w systemie Linux lub macOS powoduje wygenerowanie błędu PlatformNotSupportedException w czasie wykonywania. Nawet gdyby zestaw MessagingToolkit.BarCode mógł zostać załadowany w nowoczesnym projekcie .NET — co nie jest możliwe z powodu brakującego docelowego frameworka — zależność Bitmap i tak uniemożliwiłaby wdrożenie międzyplatformowe.

Podejście IronBarcode

IronBarcode wykorzystuje wyłącznie metody statyczne. BarcodeReader.Read() akceptuje ścieżkę do pliku, Stream, tablicę bajtów lub ścieżkę do pliku PDF — nie jest wymagańe Bitmap. Wynikiem jest zbiór, a nie pojedynczy obiekt typu nullable. Generation używa BarcodeWriter.CreateBarcode() z typem kodowania przekazanym jako parametr, a obiekt wynikowy bezpośrednio udostępnia metody zapisywania.

// Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

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

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

// Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

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

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

Imports IronBarCode

' Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
IronBarCode.License.LicenseKey = "YOUR-KEY"

' Reading
Dim results = BarcodeReader.Read("barcode.png")
Dim value As String = results.FirstOrDefault()?.Value
Dim format As String = results.FirstOrDefault()?.Format.ToString()

' Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode) _
    .SaveAsPng("output.png")

Szczegółowe wskazówki dotyczące odczytywania BARCODE-ów z obrazów można znaleźć w artykułe "Jak odczytywać BARCODE-y z obrazów". Aby wygenerować kody kreskowe 1D, w tym formaty Code 128, EAN-13 i UPC, zobacz, jak tworzyć kody kreskowe 1D.

Podejście MessagingToolkit.BarCode

MessagingToolkit.BarCode nie otrzymało żadnych aktualizacji od 2014 roku. Wszelkie luki w zabezpieczeniach wykryte po tej dacie — w logice analizowania obrazów biblioteki, w implementacji dekodowania opartej na ZXing lub w jej zależnościach przechodnich — pozostają na stałe niezałatane. Nie ma administratora, którego należałoby powiadomić, nie ma procesu doradztwa w zakresie bezpieczeństwa, którego należałoby monitorować, ani mechanizmu wydawania aktualizacji, dzięki któremu poprawka mogłaby dotrzeć do użytkowników, nawet gdyby została opracowana.

Narzędzia do skanowania bezpieczeństwa — Snyk, WhiteSource, GitHub Dependabot, NuGet audit — oznaczają porzucone pakiety jako wysokiego ryzyka. Zgłoszenie nie jest uzależnione od potwierdzonego CVE; odzwierciedla brak jakiegokolwiek procesu, dzięki któremu można by usunąć potwierdzone luki w zabezpieczeniach. Jest to profil ryzyka diametralnie różny od biblioteki posiadającej aktywnego opiekuna i udokumentówany proces reagowania na zagrożenia bezpieczeństwa.

Dla zespołów działających w ramach ram zgodności — PCI DSS, HIPAA, SOC 2, ISO 27001 — ma to praktyczne konsekwencje audytowe. Frameworki te wymagają aktywnego zarządzania poprawkami oprogramowania innych firm. Porzucony pakiet bez mechanizmu reagowania na luki w zabezpieczeniach nie przejdzie audytu zgodności, niezależnie od tego, czy zgłoszono konkretny numer CVE. Wynikiem audytu jest brak utrzymywalnej zależności, a nie obecność znanego exploita.

Podejście IronBarcode

IronBarcode otrzymuje regularne aktualizacje NuGet obejmujące poprawki bezpieczeństwa, aktualizacje zależności i nowe funkcje. Biblioteka została opracowana przez firmę Iron Software, która prowadzi udokumentówany proces wsparcia technicznego i publikuje informacje o aktualizacjach dla każdej wersji. W stosownych przypadkach zalecenia dotyczące bezpieczeństwa są uwzględniane w wydaniach poprawek.

IronBarcode obsługuje ponad 50 formatów kodów kreskowych, w tym wszystkie formaty obsługiwane przez MessagingToolkit.BarCode — QR Code, Code 128, EAN-13, EAN-8, UPC-A i inne — a także formaty, których starsza biblioteka nigdy nie obsługiwała: DataMatrix, Aztec, PDF417 oraz pełen zakres nowoczesnych symboli 2D.

Wymagania dotyczące modernizacji frameworka

Najczęstszym powodem jest planowana lub trwająca aktualizacja platformy .NET. Kiedy zespół decyduje się przenieść projekt z .NET Framework 4.x do .NET 6 lub nowszego, należy sprawdzić wykres zależności pod kątem pakietów, które nie obsługują nowoczesnego frameworka. MessagingToolkit.BARCODE pojawi się w tym audycie jako zależność blokująca — taka, której nie można rozwiązać w odniesieniu do nowoczesnego monikera docelowego frameworka. Migracja do IronBarcode jest zatem warunkiem wstępnym szerszej aktualizacji platformy .NET, a nie odrębną inicjatywą. Zespoły zajmujące się modernizacją aplikacji zazwyczaj odkrywają tę zależność na wczesnym etapie analizy aktualizacji.

Obowiązki w zakresie bezpieczeństwa i zgodności

Drugi scenariusz dotyczy przeglądów bezpieczeństwa i audytów zgodności. Zespoły działające w ramach standardów PCI DSS, HIPAA, SOC 2 lub ISO 27001 przechodzą okresowe audyty, podczas których sprawdzany jest stan zależności od podmiotów zewnętrznych. Porzucony pakiet bez mechanizmu reagowania na zagrożenia bezpieczeństwa nie przechodzi tych audytów ze względów proceduralnych, niezależnie od tego, czy zidentyfikowano konkretną lukę w zabezpieczeniach. Gdy zespół ds. bezpieczeństwa oznaczy MessagingToolkit.BarCode jako zależność niezgodną z wymógąmi, rozwiązaniem jest wymiana — nie ma łatki do zastosowania, wersji do aktualizacji ani dostawcy, z którym można skontaktować się w sprawie porady dotyczącej bezpieczeństwa. Migracja do IronBarcode rozwiązuje problem wskazany w audycie poprzez zastąpienie zależności bez ścieżki konserwacji taką, która otrzymuje regularne aktualizacje zabezpieczeń.

Rozszerzenie możliwości

Trzeci scenariusz ma miejsce, gdy nowe wymagania wykraczają poza możliwości MessagingToolkit.BarCode. Aplikacje przetwarzające zeskanowane dokumenty lub pliki PDF wymagają odczytu kodów kreskowych z tych formatów — MessagingToolkit.BarCode akceptował jedynie dane wejściowe w formacie bitmapowym, co uniemożliwiało odczyt plików PDF bez oddzielnej warstwy ekstrakcji. Aplikacje generujące kody kreskowe do dostarczania przez Internet wymagają wyjścia SVG lub base64 — MessagingToolkit.BARCODE zwracało Bitmap, co wymagało dodatkowych kroków konwersji i zależności System.Drawing.Imaging. Gdy wymagania produktówe rozszerzają się na te obszary, ograniczenia starszej biblioteki stają się ograniczeniami inżynieryjnymi, których nie da się obejść w ramach jej interfejsu API.

Platforma Docelowy wzrost

Czwartym scenariuszem jest dodanie nowych miejsc wdrożenia. Zespoły, które początkowo tworzyły aplikacje wyłącznie dla systemu Windows, a obecnie rozszerzają swoją działalność na hosting w systemie Linux, środowiska programistyczne macOS, kontenery Docker lub funkcje chmurowe w środowiskach uruchomieniowych Linux, napotykają na zależność System.Drawing jako problem blokujący. MessagingToolkit.BarCode wymaga System.Drawing.Bitmap dla wszystkich operacji wejścia i wyjścia, a System.Drawing jest dostępny tylko w systemie Windows w .NET 6 i nowszych wersjach. Każde środowisko docelowe inne niż Windows sprawia, że ta zależność staje się błędem środowiska uruchomieniowego, a nie tylko problemem kompatybilności. Przejście na IronBarcode całkowicie eliminuje wymóg System.Drawing, umożliwiając wdrożenie wielopłatformowe, do którego dąży zespół.

Zastąpienie przestrzeni nazw

Każdy plik zawierający using MessagingToolkit.Barcode; wymaga aktualizacji do using IronBarCode;. Wyszukiwanie starego ciągu znaków przestrzeni nazw w całym kodzie jest najbardziej wiarygodnym punktem wyjścia do określenia zakresu migracji. Pliki, które importują System.Drawing wyłącznie dla typu Bitmap używanego z MessagingToolkit.BarCode, mogą mieć ten import całkowicie usunięty po wdrożeniu IronBarcode, ponieważ IronBarcode tego nie wymaga.

Zmiana docelowej platformy

Usunięcie pliku MessagingToolkit.BARCODE z pliku projektu umożliwia aktualizację nazwy docelowej platformy. Zmiana z <TargetFramework>net472</TargetFramework> na <TargetFramework>net8.0</TargetFramework> staje się możliwa po usunięciu blokującej zależności. IronBarcode obsługuje obie strony tej zmiany — jest kompatybilny zarówno z .NET Framework 4.6.2, jak i z .NET 8 — dzięki czemu można go zainstalować przed sfinalizowaniem aktualizacji frameworka, co pozwala na przeprowadzenie migracji etapami, a nie w jednym kroku.

Różnice w przestrzeni nazw BarcodeWriter

MessagingToolkit.BARCODE używał BarcodeEncoder jako klasy generującej, z formatem ustawionym jako właściwość (barcodeWriter.Format = BarcodeFormat.QrCode) przed wywołaniem .Encode(). IronBarcode używa BarcodeWriter.CreateBarcode() jako metody statycznej, z typem kodowania przekazywanym jako parametr. Nazwy wyliczeń różnią się: BarcodeFormat.QrCode staje się BarcodeEncoding.QRCode, a BarcodeFormat.Code128 staje się BarcodeEncoding.Code128. Wynikiem CreateBarcode() jest obiekt płynny z .SaveAsPng(), .SaveAsJpeg(), .SaveAsSvg() i inne metody wyjściowe — nie zwraca Bitmap.