Architektura sterowania wyłącznie generacyjnego

SfBarcode to kontrolka WinForms z 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 z kodem kreskowym 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, to komponent 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 wygenerować z niej plik, programista musi wstępnie przydzielić Bitmap odpowiadające zamierzonemu rozmiarowi wyjścia, 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 przez warstwę JavaScript Syncfusion Blazor. Brak API po stronie serwera dla SfBarcodeGenerator. 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.

Dla aplikacji MAUI, SfBarcodeGenerator renderuje kody kreskowe w ramach systemu 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-LICENSE-KEY";

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

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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 instancjacji kontrolki, brak wstępnie przydzielonej Bitmap i brak zależności od środowiska runtime Windows Forms.

Podejście firmy Syncfusion

SfBarcode i SfBarcodeGenerator z natury nie mają zdolności do odczytu. Ekosystem Syncfusion wypełnia tę lukę dzięki Barcode Reader OPX, oddzielnemu produktowi 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

Czytnik Kodu Kreskowego OPX jest licencjonowany oddzielnie od elementów sterujących kod kreskowy Syncfusion. Kompletny workflow kodu kreskowego Syncfusion obejmujący generację i odczyt wymaga zatem dwóch produktów Syncfusion, dwóch umów licencyjnych oraz dwóch odrębnych powierzchni API — z produktem do odczytu opartym na swobodnie dostępnym open-source'owym dekoderze.

Podejście IronBarcode

Odczyt BarCode jest zawarty w tym samym pakiecie NuGet, co generowanie. Nie są wymagane ż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 finansowane z podatków są niekwalifikowane. Przekroczenie jakiegokolwiek warunku powoduje natychmiastowy obowiązek licencyjny komercyjny, a przejście z Licencji Community na licencję komercyjną oznacza przejście z $0 na roczną subskrypcję Essential Studio na jednego programistę, której wysokość jest podawana przez sprzedaż Syncfusion na żądanie.

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-LICENSE-KEY";

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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 wymagana.

Podejście firmy Syncfusion

Kontrolki kodów kreskowych Syncfusion nie umożliwiają generowania plików PDF. Osadzanie kodu kreskowego w dokumencie PDF przy użyciu narzędzi Syncfusion wymaga połączenia pakietu kontrolki kodu kreskowego z Syncfusion.Pdf, wygenerowania kodu kreskowego jako Bitmap przez DrawToBitmap, a następnie wstawienia tego bitmapy jako elementu obrazu w modelu obiektu 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 wymagana ż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 WinForms lub Blazor może zacząć od SfBarcode lub SfBarcodeGenerator w celach wyświetlania, a później otrzymać wymaganie dotyczące skanowania przychodzących kodów kreskowych z załadowanych obrazów, załączników e-mailowych lub zdjęć z kamer. 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 dotarły do tego punktu, często zastanawiają się, czy dodać drugi produkt komercyjny, czy zintegrować generację i odczyt w jednej bibliotece.

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 runtime Windows Forms, która nie przekłada się bezpośrednio na usługi ASP.NET Core, funkcje Azure, ani kontenery Docker Linux. Wzorzec DrawToBitmap wymaga powierzchni renderującej WinForms, która może nie istnieć w środowisku bezgłowym. 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. Musi być usunięte i zastąpione IronBarCode.License.LicenseKey = "KEY" w tym samym punkcie w sekwencji uruchamiania. Powiązane wywołania rejestracji usług (AddSyncfusionBlazor, ConfigureSyncfusionCore) i importy przestrzeni nazw w _Imports.razor muszą również zostać usunięte, jeśli nie pozostają inne komponenty Syncfusion w projekcie.

Wzorzec SfBarcode do BarcodeWriter

Przepływ pracy SfBarcode obejmuje instancję kontrolki, przypisanie właściwości, specyfikację wymiarów i renderowanie DrawToBitmap. Odpowiednik IronBarcode to pojedyncze połączone wywołanie: BarcodeWriter.CreateBarcode(value, encoding).ResizeTo(w, h).SaveAsPng(path). Wartości enum BarcodeSymbolType bezpośrednio pasują do wartości BarcodeEncoding — Code128A pasuje do Code128, QRBarcode pasuje do QRCodeWriter.CreateQrCode.

Wzorzec komponentu Blazor do punktu końcowego API

SfBarcodeGenerator to komponent Razor; Zastąpienie go terminem IronBarcode jest zmianą strukturalną, a nie zamianą znak po znaku. Wzorzec IronBarcode dla Blazor jest minimalnym punktem końcowym API, który zwraca obraz kodu kreskowego jako bajty, odwoływany z komponentu Razor za pomocą standardowego znacznika <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.