QRCoder.NET vs IronBarcode: Porównanie bibliotek kodów kreskowych C#

Projekt wyłącznie z kodem QR

QRCoder oddziela etap tworzenia danych od etapu renderowania. QRCodeGenerator generuje obiekt pośredni QRCodeData, który jest następnie przekazywany do klasy renderującej. Ten wzorzec zapewnia precyzyjną kontrolę nad formatem wyjściowym kosztem dodatkowych obiektów:

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

' PNG bytes via PngByteQRCode
Dim pngQR As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = pngQR.GetGraphic(20) ' 20px per module
File.WriteAllBytes("qr.png", pngBytes)

' SVG string via SvgQRCode
Dim svgContent As String = New SvgQRCode(qrCodeData).GetGraphic(10)
File.WriteAllText("qr.svg", svgContent)

Metoda QRCodeGenerator.CreateQrCode jest jedynym punktem wejścia do tworzenia kodu — nie ma CreateCode128, nie ma CreateDataMatrix, nie ma CreateEAN13. Biblioteka w pełni odpowiada zamierzonemu zakresowi.

Szczegółowe porównanie funkcji

Podejście QRCoder

QRCoder wykorzystuje schemat dwufazowy: QRCodeGenerator.CreateQrCode generuje obiekt pośredni QRCodeData, który koduje dane i poziom korekcji błędów, a oddzielna klasa renderująca konwertuje ten obiekt pośredni na pożądany format wyjściowy. Poziom ECC jest parametrem wymagańym, który nie ma wartości domyślnej — programiści muszą dokonać wyraźnego wyboru:

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

Dim qrCode As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = qrCode.GetGraphic(20) ' pixels per module
File.WriteAllBytes("qr.png", pngBytes)

Zaletą tego wzorca jest możliwość ponownego wykorzystania obiektu qrCodeData dla wielu formatów wyjściowych bez konieczności ponownego generowania danych kodu. Klasy rendererów obejmują między innymi PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode oraz BitmapByteQRCode.

Podejście IronBarcode

IronBarcode łączy generowanie i renderowanie w płynny łańcuch w statycznej klasie BarcodeWriter. Parametr BarcodeEncoding.QRCode wybiera format, a metody końcowe, takie jak SaveAsPng lub ToPngBinaryData, określają wynik:

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

Imports IronBarCode

' Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(400, 400) _
    .SaveAsPng("qr.png")

W przypadkach wymagających wyraźnej kontroli korekty błędów klasa QRCodeWriter zapewnia opcje specyficzne dla danego formatu:

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)
qr.SaveAsPng("qr.png")

Przewodnik po tworzeniu kodów kreskowych 2D IronBarcode obejmuje wszystkie obsługiwane formaty 2D, w tym QR Code, DataMatrix, PDF417 i Aztec, poprzez ten sam punkt wejścia BarcodeWriter.

Podejście QRCoder

Osadzanie logo QRCoder odbywa się poprzez klasę renderującą QRCode (odrębną od PngByteQRCode), która udostępnia przeciążenie GetGraphic akceptujące System.Drawing.Bitmap. Oznacza to, że kod wywołujący musi współpracować bezpośrednio z System.Drawing w celu załadowania pliku z logo:

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

Imports QRCoder
Imports System.Drawing

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H) ' High ECC required when logo occludes part of the code

Dim qrCode As New QRCode(qrCodeData)
Dim logoBitmap As New Bitmap("logo.png")
Dim qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap)
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png)

Dostosowanie kolorów przebiega według podobnego schematu poprzez parametry darkColor i lightColor przeciążenia GetGraphic.

Podejście IronBarcode

IronBarcode udostępnia osadzanie logo i zmiany kolorów jako nazwane metody w obiekcie wynikowym QRCodeWriter. Metoda AddBrandLogo przyjmuje ścieżkę do pliku, a ChangeBarCodeColor przyjmuje wartość Color:

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

Imports IronBarCode
Imports System.Drawing

' Logo embedding
Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-logo.png")

' Colour customisation
Dim coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500)
coloredQr.ChangeBarCodeColor(Color.DarkBlue)
coloredQr.SaveAsPng("colored-qr.png")

Przewodnik po dostosowywaniu stylu kodów QR szczegółowo omawia rozmiary logo, kombinacje kolorów oraz kontrolę strefy ciszy.

Podejście QRCoder

QRCoder nie posiada API do odczytu kodów kreskowych. Klasa QRCodeGenerator oraz wszystkie klasy rendererów służą wyłącznie do generowania. Nie ma metody dekodowania kodu QR z obrazu, pliku lub strumienia. Aplikacje, które muszą zarówno generować, jak i odczytywać kody QR, muszą dodać oddzielną bibliotekę — zazwyczaj ZXing.Net — z własnym API, własną przestrzenią nazw i własnym cyklem konserwacji:

// QRCoder has no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

// QRCoder has no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

' QRCoder has no reading API.
' These methods do not exist:
'   qrGenerator.Decode("image.png")
'   QRCodeReader.Read("image.png")
'
' A separate library (e.g., ZXing.Net) is required for decoding.

Jest to decyzja projektowa, a nie przeoczenie — QRCoder jest wyraźnie biblioteką generującą.

Podejście IronBarcode

IronBarcode zawiera interfejs API do odczytu w tym samym pakiecie. BarcodeReader.Read akceptuje pliki graficzne, pliki PDF, strumienie oraz obiekty System.Drawing.Bitmap. Automatycznie wykrywa formaty BARCODE bez konieczności określania przez użytkownika, jakiego formatu szuka, i zwraca wszystkie BARCODE znalezione na obrazie:

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // QRCode, Code128, EAN13, etc.
}

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // QRCode, Code128, EAN13, etc.
}

Imports IronBarCode

' Reading a QR code — no separate library required
Dim results = BarcodeReader.Read("qr.png")
For Each result In results
    Console.WriteLine(result.Text)        ' decoded value
    Console.WriteLine(result.BarcodeType) ' QRCode, Code128, EAN13, etc.
Next

Przewodnik dotyczący odczytu BARCODE-ów z obrazów obejmuje odczyt z plików PDF, dokumentów wielostronicowych, strumieni oraz obrazów o niskiej rozdzielczości lub zawierających zakłócenia za pośrednictwem tego samego punktu wejścia.

Podejście QRCoder

QRCoder generuje wyłącznie kody QR — tak zostało zaprojektowane. Metoda QRCodeGenerator.CreateQrCode jest jedynym punktem wejścia generowania udostępnianym przez bibliotekę. Projekty, które rozpoczynają się od kodów QR, a później wymagają etykiet wysyłkowych w formacie Code 128, kodów produktów EAN-13 lub kodów zgodności farmaceutycznej DataMatrix, muszą wprowadzić drugą bibliotekę, aby obsłużyć każdy dodatkowy format:

using QRCoder;

// QRCoder is limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// Kod 128 requires a different library (e.g., NetBarcode)
// DataMatrix requires yet another library
// Reading any format requires yet another library

using QRCoder;

// QRCoder is limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// Kod 128 requires a different library (e.g., NetBarcode)
// DataMatrix requires yet another library
// Reading any format requires yet another library

Imports QRCoder

' QRCoder is limited to QR — other formats require separate packages
Dim qrGenerator As New QRCodeGenerator()
Dim qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M)

' Kod 128 requires a different library (e.g., NetBarcode)
' DataMatrix requires yet another library
' Reading any format requires yet another library

Podejście IronBarcode

IronBarcode obsługuje wszystkie rodziny formatów poprzez ten sam punkt wejścia BarcodeWriter.CreateBarcode. Przejście z kodu QR na Kod 128 i DataMatrix wymaga jedynie zmiany parametru BarcodeEncoding — bez dodatkowych pakietów, nowych przestrzeni nazw i oddzielnych interfejsów API:

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

Imports IronBarCode

' All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode) _
    .SaveAsPng("campaign-qr.png")

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product-code.png")

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-code.png")

Wymagania dotyczące formatu wykraczają poza QR

Większość wymagań dotyczących kodów kreskowych zaczyna się od kodów QR, a QRCoder niezawodnie radzi sobie z tym początkowym zakresem. Napięcie pojawia się, gdy do rozmowy wkracza drugi format. Zespoły logistyczne, które potrzebują etykiet Kod 128 do wysyłki, operacje detaliczne wymagające kodów produktów EAN-13, procesy farmaceutyczne wymagające DataMatrix do serializacji — każdy nowy format zmusza zespół do dodania kolejnej zależności NuGet. Koszt integracji każdej dodatkowej biblioteki obejmuje naukę nowej przestrzeni nazw, monitorowanie nowego cyklu wydawniczego oraz nowy punkt potencjalnego konfliktu wersji podczas aktualizacji Wersji .NET.

Odczytywanie BarCode staje się konieczne

Aplikacja generująca kody QR wychodzące na potrzeby kampanii jest systemem służącym wyłącznie do generowania. Aplikacja, która przetwarza również przesyłki przychodzące, weryfikuje kody produktów w momencie ich dostarczenia lub sprawdza bilety podczas wydarzenia, jest systemem generowania i odczytu. QRCoder z założenia nie posiada funkcji odczytu — tę lukę musi wypełnić druga biblioteka. Wprowadzenie biblioteki odczytu znacznie zmienia ślad integracyjny podsystemu BarCode, zwłaszcza jeśli biblioteka odczytu nakłada własne wymagania dotyczące specyfikacji formatu lub ograniczenia dotyczące bezpieczeństwa wątków.

Obciążenie związane z utrzymaniem wielu bibliotek

Naturalny schemat tworzenia projektu opartego na QRCoderze przebiega w przewidywalny sposób: QRCoder do generowania kodów QR, biblioteka kodów kreskowych 1D do etykiet wysyłkowych, biblioteka odczytu do dekodowania. Każda biblioteka posiada własną dokumentację, własny cykl wydawania wersji oraz własną historię zmian wprowadzających niekompatybilność. Niewielka aktualizacja wersji .NET dla jednej biblioteki może zbiegać się w czasie z istotną zmianą w innej. Zespoły, które zarządzają tymi zasobami od lat, informują, że ukryty koszt nie wynika z początkowej integracji, ale z narastających kosztów utrzymania w wielu cyklach aktualizacji.

Obsługa dokumentów PDF

Generowanie barcode'ów do osadzenia w raportach PDF lub wyodrębnianie barcode'ów z przychodzących dokumentów PDF w procesie przetwarzania dokumentów nie jest możliwe w QRCoder. Obsługa plików PDF wymaga albo pełnej biblioteki PDF z funkcjami BarCode, albo dedykowanej kombinacji bibliotek. Zespoły tworzące procesy oparte na dokumentach — przetwarzanie faktur, raportowanie zgodności, generowanie etykiet na podstawie szablonów PDF — zauważają, że zakres działania QRCoder pokrywa się z wymaganiami dotyczącymi plików PDF już na wczesnym etapie cyklu życia projektu.

Format ciągu znaków PayloadGenerator

Klasy pomocnicze QRCoder PayloadGenerator generują ciągi znaków zgodne z publicznymi standardami danych QR. Na przykład format WiFi generuje WIFI:T:WPA;S:NetworkName;P:Password;;. Ciągi te można tworzyć bezpośrednio w IronBarcode bez klasy pomocniczej, ponieważ format jest publicznym standardem udokumentówanym w specyfikacji kodu QR. Zespoły, które często używają PayloadGenerator, powinny rozważyć napisanie małych statycznych metod pomocniczych, które odtwarzają konstrukcję ciągu znaków.

Mapowanie enumów ECCLevel

QRCoder używa QRCodeGenerator.ECCLevel z wartościami L, M, Q, H. IronBarcode używa QRCodeWriter.QrErrorCorrectionLevel z wartościami Low, Medium, Quartile i Highest. Mapowanie jest bezpośrednie, ale odniesienia do enumów muszą zostać zaktualizowane we wszystkich miejscach wywołania. Podczas gdy QRCoder wymagał wyraźnego wyboru ECC przy każdym wywołaniu CreateQrCode, IronBarcode stosuje rozsądne ustawienie domyślne, gdy używana jest ścieżka BarcodeWriter.CreateBarcode.

Usunięcie klasy Renderer

Klasy renderujące QRCoder — PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode — stają się zbędne po migracji. IronBarcode wbudowuje renderowanie w łańcuch fluent w GeneratedBarcode, więc wzorzec obiektu renderera pośredniego nie jest przenoszony. Kod, który instancjonuje te klasy rendererów, można zastąpić wywołaniami metod terminalowych w wyniku BarcodeWriter.