Architektura Split SDK

Projekt, który zakupi oba SDK Neodynamic, musi skonfigurować dwa oddzielne bloki licencyjne podczas uruchamiania. Podwójne przypisania LicenseOwner i LicenseKey używają różnych przestrzeni nazw i różnych nazw klas, a żaden z bloków nie jest świadom istnienia drugiego:

// Neodynamic: two products, two license configurations
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

// Neodynamic: two products, two license configurations
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

Imports Neodynamic.SDK.Barcode
Imports Neodynamic.SDK.BarcodeReader

' Neodynamic: two products, two license configurations

' Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company"
BarcodeProfessional.LicenseKey = "GEN-KEY"

' Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company"
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY"

Ten schemat powtarza się w każdym środowisku — programistycznym, testowym i produkcyjnym — i musi być zachowany przy każdej aktualizacji lub odnowieniu produktu.

Szczegółowe porównanie funkcji

Podejście Neodynamic BarCode Reader

Neodynamic BarCode Reader obsługuje wyłącznie kody kreskowe liniowe. Gdy kod kreskowy 2D zostanie przesłany do czytnika, SDK zwraca pusty lub zerowy zestaw wyników. Nie jest zgłaszany żaden wyjątek, a żaden komunikat o błędzie nie wskazuje, co się stało. Zespoły pracujące z tym SDK zazwyczaj odkrywają to ograniczenie po wdrożeniu kodu wywołującego czytnik w odniesieniu do obrazów kodów QR i zauważeniu, że zbiór wyników jest zawsze pusty.

Typowym wzorcem defensywnym w kodach wykorzystujących Neodynamic Reader jest jawna kontrola, która zgłasza wyjątek, gdy oczekiwany jest format 2D:

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

Imports Neodynamic.SDK.BarcodeReader
Imports System.Drawing

Public Function ReadQrCode(imagePath As String) As String
    Using bitmap As New Bitmap(imagePath)
        Dim reader As New BarcodeReader()
        Dim results = reader.Read(bitmap)

        ' Results will be null or empty — QR codes are not recognised by this SDK
        If results Is Nothing OrElse Not results.Any() Then
            Throw New NotSupportedException("Neodynamic Barcode Reader does not support QR codes")
        End If

        Return results.First().Value
    End Using
End Function

Metody tej nie da się zrealizować wyłącznie przy użyciu zestawu SDK Neodynamic Reader. NotSupportedException nie jest obejściem — odzwierciedla rzeczywiste ograniczenie możliwości czytnika dla danych wejściowych 2D.

Podejście IronBarcode

IronBarcode odczytuje wszystkie obsługiwane symbologie przez jedno wywołanie BarcodeReader.Read(). Format jest wykrywany automatycznie na podstawie zawartości obrazu. QR, kod 128 i BarCode DataMatrix używają identycznego kodu wywołania:

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

Imports IronBarCode

Public Function ReadQrCode(imagePath As String) As String
    ' QR codes, DataMatrix, PDF417 — all handled automatically
    Dim result = BarcodeReader.Read(imagePath).FirstOrDefault()
    Return If(result?.Value, Nothing)
End Function

Zleceniodawca nie określa oczekiwanego formatu.IronBarcode identyfikuje symbolikę i zwraca wartość. Pełne informacje na temat opcji odczytu obrazów, w tym wykrywania wielu BARCODE'ów i wstępnego przetwarzania obrazów, można znaleźć w przewodniku dotyczącym odczytu BARCODE'ów z obrazów.

Professional approach to Neodynamic BarCode

API generowania firmy Neodynamic opiera się na instancjach. Tworzony jest obiekt BarcodeProfessional, jego właściwości są przypisywane indywidualnie, a następnie wywoływana jest funkcja GetBarcodeImage() w celu zwrócenia System.Drawing.Image. Obraz jest następnie zapisywany za pomocą wyliczenia System.Drawing.Imaging.ImageFormat:

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

Imports Neodynamic.SDK.Barcode
Imports System.Drawing

' Configure license first
BarcodeProfessional.LicenseOwner = "Your Company"
BarcodeProfessional.LicenseKey = "YOUR-KEY"

' Build the barcode through property assignment
Dim barcode As New BarcodeProfessional()
barcode.Code = "12345678"
barcode.Symbology = Symbology.Code128
barcode.BarcodeUnit = BarcodeUnit.Pixel

' Get image and save via System.Drawing
Dim image As Image = barcode.GetBarcodeImage()
image.Save("output.png", Imaging.ImageFormat.Png)

Zestaw SDK oferuje legalne opcje dostosowywania, w tym kontrolę DPI, wyrównanie tekstu, ustawienia kolorów oraz rozmiar strefy cichej. Są one przydatne w procesach PRINT, gdzie liczą się precyzyjne wymiary fizyczne. Sama funkcja generowania jest kompletna; Ograniczenia, które skłaniają do migracji, dotyczą strony odczytu, a nie generowania.

Podejście IronBarcode

IronBarcode wykorzystuje płynne podejście statyczne. Kodowanie i dane są przekazywane jako parametry do BarcodeWriter.CreateBarcode(), a format wyjściowy jest wyrażany jako nazwa metody na zwróconym obiekcie. Nie jest wymagany import System.Drawing:

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("output.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("output.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("output.png")

Do generowania kodów kreskowych 2D dedykowana klasa QRCodeWriter oferuje dodatkowe opcje specyficzne dla kodów QR:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .SaveAsPng("qrcode.png")

Wskazówki dotyczące generowania symboli 1D z opcjami rozmiaru i adnotacji można znaleźć w przewodniku tworzenia BARCODE'ów 1D. Aby dowiedzieć się więcej o tworzeniu kodów kreskowych 2D, w tym DataMatrix i PDF417, zapoznaj się z przewodnikiem dotyczącym tworzenia kodów kreskowych 2D.

Podejście Neodynamic

Funkcjonalność Neodynamic w zakresie kodów barcode jest podzielona na dwa oddzielnie licencjonowane produkty. Professional BarCode SDK obejmuje generowanie, a Barcode Reader SDK – odczyt. Każdy produkt wymaga osobnego zakupu i posiada oddzielny klucz licencyjny. Zespół, który zakupi oba produkty, musi utrzymywać dwa bloki konfiguracji LicenseOwner / LicenseKey, śledzić dwie oddzielne daty odnowienia i obsługiwać dwa oddzielne kanały wsparcia, gdy pojawią się problemy.

SDK Barcode Professional jest wyceniony na około $352 za jedną licencję dewelopera w edycji podstawowej oraz od około $705 w edycji Ultimate (licencje deweloperskie poprzez ComponentSource). SDK Barcode Reader ma osobny koszt i jest dostarczany według starego cennika — produkt został oznaczony jako koniec cyklu serwisowego dnia 31 grudnia 2019. Projekt, który wymaga odczytu 2D, nie może spełnić tego wymogu z produktami Neodynamic za jakąkolwiek cenę; należy dodać trzecią bibliotekę. Pełną listę elementów objętych jedną, ujednoliconą licencją można znaleźć na stronie poświęconej formatom BARCODE-ów obsługiwanych przez IronBarcode.

Podejście IronBarcode

IronBarcode jest sprzedawany jako pojedynczy produkt, który obejmuje wszystkie operacje związane z kodami kreskowymi — generowanie i odczyt we wszystkich obsługiwanych symbolikach — w ramach jednego klucza licencyjnego. Nie ma oddzielnej licencji dla czytnika, oddzielnej licencji dla generatora ani dodatkowych kosztów za obsługę formatu 2D. Klucz licencyjny jest ustawiany jednorazowo podczas uruchamiania aplikacji i nie wymaga dalszej konfiguracji:

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

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

Imports IronBarCode

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

Cena IronBarcode Lite wynosi 749 USD dla pojedynczego programisty i obejmuje pełen zestaw funkcji. Aby zapoznać się z aktualnymi poziomami cenowymi i opcjami ilościowymi, odwiedź stronę licencyjną IronBarcode.

Wymagania dotyczące odczytu kodów QR

Najczęstszym scenariuszem, który prowadzi zespoły z Neodynamic do IronBarcode, jest odkrycie, że kody QR wygenerowane przez Barcode Professional SDK nie mogą być odczytane przez Barcode Reader SDK. Zespoły tworzące systemy etykietowania produktów, narzędzia do zarządzania zapasami lub procesy śledzenia dokumentów często wdrażają generowanie i odczyt jako oddzielne fazy większego systemu. Gdy generowanie jest tworzone najpierw przy użyciu programu BarCode Professional, ograniczenie czytnika staje się widoczne dopiero w momencie próby uruchomienia komponentu odczytu. W tym momencie projekt został już przekazany firmie Neodynamic do realizacji, a dodanie trzeciej biblioteki do obsługi odczytu 2D wprowadza złożoność w zarządzaniu wersjami, która nie istniałaby w przypadku ujednoliconego zestawu SDK.

Zmniejszenie złożoności produktu

Niektóre zespoły decydują się na migrację nie z powodu konkretnej rozbieżności formatów, ale dlatego, że nakład pracy związany z utrzymywaniem dwóch oddzielnych produktów dla funkcji, która koncepcyjnie jest pojedynczą funkcją, staje się powracającym punktem tarcia. Dwa pakiety w pliku .csproj, dwa cykle odnowienia licencji, dwa zestawy notatek o wydaniu do przeglądu i dwa potencjalne źródła niekompatybilności w przypadku zastosowania aktualizacji .NET lub Windows — żaden z tych narzutów nie dostarcza funkcjonalności poza tym, co zapewniłby jeden zintegrowany pakiet. Zespoły przeprowadzające audyt zależności jako część aktualizacji .NET często identyfikują układ z dwoma pakietami Neodynamic jako okazję do uproszczenia.

Przetwarzanie BarCodes w plikach PDF

Aplikacje przetwarzające dokumenty PDF zawierające kody kreskowe stanowią scenariusz, w którym oba zestawy SDK firmy Neodynamic nie spełniają wymagań jednocześnie. Ani SDK do generowania, ani SDK do odczytu nie mogą otworzyć pliku PDF i wyodrębnić wartości BARCODE z jego stron. Zespoły pracujące z listami przewozowymi, fakturami, dokumentacją medyczną lub dowolnym przepływem dokumentów, w którym BarCodes są osadzone w plikach PDF, muszą wdrożyć pośredni etap wyodrębniania obrazów, zanim będzie można przystąpić do odczytu. Ten etap ekstrakcji wymaga dodatkowej biblioteki IronBarcode, co oznacza, że projekt ma już trzecie zależności, aby obejść ograniczenie, które wyeliminowałaby pojedyncza instalacja IronBarcode.

Spójność formatowania w trybie odczytu i zapisu

Zespoły obsługujące procesy związane z BarCode na dużą skalę czasami zauważają, że niespójności w obsłudze formatów między generowaniem a odczytem powodują problemy z testowaniem i walidacją. Gdy system generuje kody QR w jednym celu, a odczytuje różne typy formatów w innym, rozbieżność między tym, co obsługuje generator, a tym, co obsługuje czytnik, powoduje luki w testach round-trip. System, w którym generowanie i odczyt korzystają z tej samej biblioteki i tej samej listy obsługiwanych formatów, jest łatwiejszy do zweryfikowania. Weryfikacja, czy wygenerowany BARCODE może zostać pomyślnie odczytany, staje się operacją wykonywaną w ramach jednej biblioteki, a nie testem integracyjnym obejmującym wiele bibliotek.

Usuwanie podwójnych pakietów

Migracja z Neodynamic wymaga usunięcia obu pakietów NuGet: Neodynamic.SDK.Barcode i Neodynamic.SDK.BarcodeReader. Oba muszą zostać usunięte z pliku .csproj, a oba odpowiadające dyrektywy using muszą zostać usunięte z plików źródłowych. Uruchomienie dotnet remove package dla każdego z nich jest wystarczające; nie ma między nimi żadnych wspólnych zależności, które wymagałyby dodatkowego porządkowania.

Porządkowanie konfiguracji podwójnej licencji

Dwa bloki konfiguracji licencji — jeden dla BarcodeProfessional i jeden dla Neodynamic.SDK.BarcodeReader.BarcodeReader — są oba zastąpione pojedynczym przypisaniem IronBarCode.License.LicenseKey. To przypisanie jest wykonywane raz podczas uruchamiania aplikacji, zazwyczaj w Program.cs lub w bootstrap aplikacji do wstrzykiwania zależności. Wszelkie pliki konfiguracyjne lub zmienne środowiskowe, które przechowują klucze licencyjne Neodynamic, mogą zostać wycofane po zweryfikowaniu migracji.

Usunięcie wyjątku NotSupportedException

Bazy kodów, które napotkały ograniczenie odczytu 2D podczas rozwoju, często zawierają metody zastępcze, które rzucają NotSupportedException dla odczytu kodów QR lub DataMatrix. Te metody nie są obejściami — to szczere uznanie, że możliwość nie istniała. Po migracji do IronBarcode, każda taka metoda zostaje zastąpiona standardowym wywołaniem BarcodeReader.Read(imagePath). Nie jest wymagane żadne specjalne traktowanie; format jest wykrywany automatycznie.