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

Architektura sterowania wyłącznie generacyjnego

SfBarcode to kontrolka WinForms z interfejsem API opartym na właściwościach: Text, Symbology, BarHeight, NarrowBarWidth, ShowText. Renderowanie BarCode na formularzu działa zgodnie z oczekiwaniami w projektancie WinForms. Generowanie pliku BarCode programowo wymaga wzorca DrawToBitmap, co wiąże się z wstępnym przydzieleniem Bitmap o odpowiednich wymiarach przed renderowaniem:

using Syncfusion.Windows.Forms.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

// Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "12345678";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.BarHeight = 100;
barcode.NarrowBarWidth = 1;
barcode.ShowText = true;

barcode.Width = 400;
barcode.Height = 150;
using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("barcode.png", ImageFormat.Png);

using Syncfusion.Windows.Forms.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

// Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "12345678";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.BarHeight = 100;
barcode.NarrowBarWidth = 1;
barcode.ShowText = true;

barcode.Width = 400;
barcode.Height = 150;
using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("barcode.png", ImageFormat.Png);

Imports Syncfusion.Windows.Forms.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

' Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")

Dim barcode As New SfBarcode()
barcode.Text = "12345678"
barcode.Symbology = BarcodeSymbolType.Code128A
barcode.BarHeight = 100
barcode.NarrowBarWidth = 1
barcode.ShowText = True

barcode.Width = 400
barcode.Height = 150
Using bitmap As New Bitmap(barcode.Width, barcode.Height)
    barcode.DrawToBitmap(bitmap, barcode.ClientRectangle)
    bitmap.Save("barcode.png", ImageFormat.Png)
End Using

Ten wzorzec zakłada ładowanie środowiska uruchomieniowego Windows Forms w każdym projekcie, który je wywołuje, w tym w aplikacjach konsolowych, usługach .NET Core i Azure Functions. Wariant Blazor, SfBarcodeGenerator, jest komponentem Razor i nie ma w ogóle ścieżki wyjściowej pliku po stronie serwera.

Szczegółowe porównanie funkcji

Podejście firmy Syncfusion

SfBarcode to kontrolka WinForms. Jego rolą jest renderowanie BARCODE jako części układu wizualnego formularza. Aby utworzyć plik na jego podstawie, programista musi wstępnie przydzielić Bitmap odpowiadający zamierzonemu rozmiarowi wyjściowemu, wywołać DrawToBitmap, a następnie wywołać Bitmap.Save. Każdy krok wymaga środowiska uruchomieniowego Windows Forms.

SfBarcodeGenerator dla Blazor to komponent Razor, który renderuje się w przeglądarce za pośrednictwem warstwy JavaScript Syncfusion Blazor. W SfBarcodeGenerator nie ma API po stronie serwera. Wygenerowanie kodu kreskowego do pobrania z aplikacji Blazor wymaga współpracy z JavaScriptem i wyzwałączy pobierania w przeglądarce, a nie wywołania API serwera.

W przypadku aplikacji MAUI SfBarcodeGenerator renderuje BARCODES w systemie układu MAUI. Generowanie BarCODE jako pliku do przesłania lub wydruku wymaga dodatkowych czynności, których sam kontrolka nie zapewnia.

Podejście IronBarcode

IronBarcode wykorzystuje statyczny, łańcuchowy interfejs API, który bezpośrednio generuje pliki wyjściowe. Ten sam wzorzec wywołania działa w każdym modelu aplikacji .NET bez modyfikacji:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

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

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

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

Dokumentacja dotycząca generowania BarCodes 1D obejmuje wszystkie obsługiwane symbole i opcje wyjściowe. Brak instancjonowania kontroli, brak wstępnie przydzielonego Bitmap oraz brak zależności od środowiska uruchomieniowego Windows Forms.

Podejście firmy Syncfusion

SfBarcode i SfBarcodeGenerator z założenia nie mają możliwości odczytu. Ekosystem Syncfusion wypełnia tę lukę dzięki Barcode Reader OPX, oddzielnemu produktówi komercyjnemu z własną licencją i ścieżką zakupu.

Czytnik kodów kreskowych OPX wykorzystuje wewnętrznie bibliotekę ZXing.Net. ZXing.Net to biblioteka open source do odczytu BarCodes, opublikowana na licencji Apache 2.0. Apache 2.0 to liberalna licencja, która zezwala na nieograniczone wykorzystanie komercyjne. Każdy programista może zainstalować ZXing.Net bezpośrednio:

dotnet add package ZXing.Net

dotnet add package ZXing.Net

Zakup czytnika kodów kreskowych OPX oznacza opłacenie subskrypcji Syncfusion za nakładkę na bibliotekę, która jest dostępna bezpłatnie. Kompletny proces obsługi kodów kreskowych Syncfusion, obejmujący zarówno generowanie, jak i odczyt, wymaga dwóch oddzielnych produktów Syncfusion, dwóch umów licencyjnych i dwóch odrębnych interfejsów API.

Podejście IronBarcode

Odczyt BarCode jest zawarty w tym samym pakiecie NuGet, co generowanie. Nie są wymagańe żadne dodatkowe produkty ani licencje:

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

Dokumentacja dotycząca odczytu kodów kreskowych obejmuje wykrywanie wielu kodów kreskowych, ocenę pewności, odczyt z tablic bajtów oraz dostosowanie szybkości do dokładności. Odczytywanie dokumentów PDF jest również natywne i nie wymaga oddzielnej biblioteki PDF.

Podejście firmy Syncfusion

Licencja społecznościowa Syncfusion zapewnia bezpłatny dostęp, ale nakłada cztery warunki kwalifikacyjne, które muszą być spełnione jednocześnie: roczny przychód brutto poniżej 1 000 000 USD, pięciu lub mniej programistów, dziesięciu lub mniej pracowników oraz całkowity kapitał zewnętrzny poniżej 3 000 000 USD. Wszystkie cztery warunki muszą być spełnione w sposób ciągły. Organizacje rządowe nie kwalifikują się do udziału w programie. Spełnienie któregokolwiek z warunków powoduje natychmiastowe zobowiązanie do uzyskania licencji komercyjnej, a przejście z licencji społecznościowej na licencję komercyjną wiąże się ze wzrostem kosztów z 0 USD do około 995 USD rocznie na programistę w ramach poziomu Standard.

Oprócz spełnienia warunków kwalifikacyjnych klucze licencyjne Syncfusion są przypisane do konkretnych wersji. Klucz wydany dla Essential Studio 24.x nie jest weryfikowany po aktualizacji do wersji 25.x. Każda większa aktualizacja wersji NuGet wymaga uzyskania nowego klucza z portalu konta, aktualizacji sekretów środowiska oraz ponownego wdrożenia, aby zapobiec pojawianiu się znaków wodnych wersji próbnej w wynikach produkcyjnych.

Rejestracja platformy wymaga wykonania dodatkowych kroków. Aplikacja Blazor wymaga trzech oddzielnych wpisów konfiguracyjnych:

// Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

// Step 2: Service registration in Program.cs
builder.Services.AddSyncfusionBlazor();

// Step 3: Namespace imports in _Imports.razor
// @using Syncfusion.Blazor
// @using Syncfusion.Blazor.BarcodeGenerator

// Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

// Step 2: Service registration in Program.cs
builder.Services.AddSyncfusionBlazor();

// Step 3: Namespace imports in _Imports.razor
// @using Syncfusion.Blazor
// @using Syncfusion.Blazor.BarcodeGenerator

' Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")

' Step 2: Service registration in Program.vb
builder.Services.AddSyncfusionBlazor()

' Step 3: Namespace imports in _Imports.razor
' @Imports Syncfusion.Blazor
' @Imports Syncfusion.Blazor.BarcodeGenerator

Aplikacje MAUI wymagają czwartego kroku: builder.ConfigureSyncfusionCore().

Podejście IronBarcode

Aktywacja licencji IronBarcode jest jednorazowa i identyczna na wszystkich platformach oraz w modelach aplikacji:

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

Strona licencyjna IronBarcode opisuje model licencji wieczystej. Przewodnik po konfiguracji klucza licencyjnego obejmuje wzorce zmiennych środowiskowych dla wdrożeń CI/CD i Docker. Klucz nie zmienia się między wydaniami pomniejszymi i poprawkami w ramach głównej wersji, a rejestracja usługi specyficznej dla platformy nie jest wymagańa.

Podejście firmy Syncfusion

Kontrolki kodów kreskowych Syncfusion nie umożliwiają generowania plików PDF. Osadzenie kodu kreskowego w dokumencie PDF przy użyciu narzędzi Syncfusion wymaga połączenia pakietu kontrolnego kodu kreskowego z Syncfusion.Pdf, wygenerowania kodu kreskowego jako Bitmap poprzez DrawToBitmap, a następnie wstawienia tej mapy bitowej jako elementu obrazu w modelu obiektowym dokumentu PDF. Ten proces obejmuje dwa oddzielne produkty Syncfusion, dwa pakiety NuGet oraz wieloetapowy proces renderowania.

Odczytywanie kodów kreskowych z istniejących dokumentów PDF nie jest obsługiwane ani przez kontrolkę kodów kreskowych, ani przez Barcode Reader OPX.

Podejście IronBarcode

PDF jest formatem wyjściowym pierwszej klasy w IronBarcode. Nie jest wymagańa żadna biblioteka dodatkowa:

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPdf("barcode.pdf");

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPdf("barcode.pdf");

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .SaveAsPdf("barcode.pdf")

Biblioteka odczytuje również BarCodes bezpośrednio z dokumentów PDF:

var pdfResults = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

var pdfResults = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

Dim pdfResults = BarcodeReader.Read("shipping-manifest.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

Przewodnik po generowaniu plików PDF z BarCode obejmuje wielostronicowe wydruki oraz osadzanie BarCode obok innych treści w pliku PDF.

Wymagania dotyczące odczytu BarCode

Zespół pracujący wyłącznie w środowisku WinForms lub Blazor może rozpocząć pracę od SfBarcode lub SfBarcodeGenerator w celach prezentacyjnych, a później otrzymać wymaganie skanowania przychodzących BarCodes z przesłanych obrazów, załączników e-mailowych lub zdjęć zrobionych aparatem. W tym momencie interfejs kontrolny Syncfusion nie oferuje żadnego rozwiązania. Dokumentacja Syncfusion kieruje zespoły do Barcode Reader OPX, który jest oddzielnym produktem komercyjnym wykorzystującym ZXing.Net — bibliotekę dostępną bezpłatnie na licencji Apache 2.0. Zespoły, które to odkrywają, często ponownie oceniają, czy utrzymywanie płatnej nakładki na darmowe oprogramowanie jest właściwą decyzją architektoniczną, zwłaszcza gdy ujednolicona biblioteka do generowania i odczytu całkowicie wyeliminowałaby pośrednictwo.

Generowanie po stronie serwera i backend

Aplikacje, które początkowo są narzędziami desktopowymi typu WinForms lub WPF, czasami ewoluują i obejmują warstwę API sieci Web, usługę przetwarzania w tle lub funkcję w chmurze, która wymaga generowania plików BARCODE. SfBarcode zawiera zależność od środowiska uruchomieniowego Windows Forms, która nie przekłada się bezpośrednio na usługi ASP.NET Core, Azure Functions ani kontenery Docker w systemie Linux. Wzorzec DrawToBitmap wymaga powierzchni renderowania WinForms, która może nie istnieć w środowisku bezinterfejsowym. Zespoły, które osiągają ten punkt, zazwyczaj potrzebują biblioteki, której model generowania jest od samego początku oddzielony od stosu renderowania interfejsu użytkownika.

Zmiany w zakresie kwalifikowalności do licencji społecznościowej

Licencja społecznościowa Syncfusion jest atrakcyjna dla zespołów na wczesnym etapie rozwoju, właśnie wtedy, gdy rozwijają się one najszybciej. Cztery równoczesne warunki kwalifikacyjne — przychody, liczba pracowników i pozyskany kapitał — tworzą barierę licencyjną, która może pojawić się nagle. Runda finansowania serii A zazwyczaj pozwala startupowi przekroczyć próg kapitałowy 3 000 000 USD w dniu zamknięcia rundy, co powoduje obowiązek uzyskania licencji komercyjnej niezależnie od liczby deweloperow lub przychodów. Zespoły, które zbudowały procesy produkcyjne w oparciu o licencję Community, muszą uwzględnić koszty i czas trwania tego przejścia, zwłaszcza gdy licencja komercyjna obejmuje pełną Suite Essential Studio, a nie tylko komponent BarCode.

Zmniejszenie obciążenia związanego z konfiguracją specyficzną dla danej wersji

Zespoły operacyjne zajmujące się utrzymaniem aplikacji Syncfusion w potokach CI/CD napotykają na rotację kluczy licencyjnych jako powtarzające się zadanie związane z aktualizacjami wersji NuGet. Klucz ważny dla Essential Studio 24.x przestaje działać po aktualizacji do wersji 25.x, co oznacza konieczność aktualizacji tajnych danych w każdym środowisku wdrożeniowym oraz sprawdzenia, czy w wynikach produkcyjnych nie pojawiły się znaki wodne wersji próbnej. Zespoły, które często wydają nowe wersje lub mają wiele miejsc wdrożenia, uważają, że ten dodatkowy wysiłek jest nieproporcjonalny do korzyści, zwłaszcza gdy głównym celem jest wygenerowanie obrazu BARCODE, a nie korzystanie z pełnej Suite komponentów interfejsu użytkownika.

Usunięcie rejestracji SyncfusionLicenseProvider

Wywołanie licencji Syncfusion — SyncfusionLicenseProvider.RegisterLicense("KEY") — zazwyczaj pojawia się w Program.cs, App.xaml.cs lub w metodzie uruchamiania aplikacji. Należy go usunąć i zastąpić IronBarCode.License.LicenseKey = "KEY" w tym samym miejscu sekwencji startowej. Powiązane wywołania rejestracji usług (AddSyncfusionBlazor, ConfigureSyncfusionCore) oraz importy przestrzeni nazw w _Imports.razor również należy usunąć, jeśli w projekcie nie pozostały żadne inne komponenty Syncfusion.

Wzorzec SfBarcode do BarcodeWriter

Przepływ pracy SfBarcode obejmuje instancjonowanie kontrolki, przypisywanie właściwości, określanie wymiarów oraz DrawToBitmap renderowanie. Odpowiednikiem IronBarcode jest pojedyncze wywołanie łańcuchowe: BarcodeWriter.CreateBarcode(value, encoding).ResizeTo(w, h).SaveAsPng(path). Wartości wyliczeniowe BarcodeSymbolType odpowiadają bezpośrednio wartościom BarcodeEncoding — Code128A odpowiada Code128, QRBarcode odpowiada QRCodeWriter.CreateQrCode.

Wzorzec komponentu Blazor do punktu końcowego API

SfBarcodeGenerator jest komponentem Razor; Zastąpienie go terminem IronBarcode jest zmianą strukturalną, a nie zamianą znak po znaku. Wzorzec IronBarcode dla Blazor to minimalny punkt końcowy API, który zwraca obraz kodu kreskowego w postaci bajtów, odwołujący się do komponentu Razor za pomocą standardowego tagu <img src="...">. Takie podejście pozwala uzyskać punkt końcowy po stronie serwera, który można testować niezależnie i ponownie wykorzystywać w różnych klientach, zamiast komponentu renderowanego przez przeglądarkę, powiązanego z warstwą JavaScript Syncfusion Blazor.