Wzorzec generowaniaBarcodeLibCore

Standardowy przeplyw pracy generowaniaBarcodeLibwymaga stworzenia instancji, skonfigurowania wlasciwosci i wywolania Encode() z wymiarami:

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

Imports BarcodeStandard
Imports SkiaSharp

Dim b As New Barcode()
b.IncludeLabel = True
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Using stream = File.OpenWrite("barcode.png")
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
End Using

Oto pełny przebieg procesu tworzenia. Wzorzec ustawiania wlasciwosci jest projektem: konfiguracja odbywa sie na instancji przed wywolaniem Encode(), a zwracana wartosc to SKImage, ktora nalezy zakodowac i zapisac do strumienia.

Szczegółowe porównanie funkcji

Podejście BarcodeLib

BarcodeLib wymaga skonstruowania instancji i ustawienia wlasciwosci przed wywolaniem Encode() z wymiarami. Wyjsciem jest SKImage:

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

Imports BarcodeStandard
Imports SkiaSharp

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100)

    Using ms As New MemoryStream()
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
        Return ms.ToArray()
    End Using
End Function

Typ zwracany SKImage oznacza, ze wyjscie tablicy bajtow wymaga wywolania kodowania SKEncodedImageFormat i MemoryStream. Wlasciwosc IncludeLabel jest przelacznikiem logicznym -BarcodeLibrenderuje zakodowany ciag danych jako widoczna etykiete pod paskami.

Podejście IronBarcode

Generacja w IronBarcode jest całkowicie statyczna. Konfiguracja lancuchuje sie po CreateBarcode(), a metody wyjsciowe koncza lancuch bezposrednio:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateCode128(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .AddBarcodeValueTextBelowBarcode() _
        .ToPngBinaryData()
End Function

.ToPngBinaryData() zwraca tablice bajtow bezposrednio - brak posrednich obiektow Image lub MemoryStream. .AddBarcodeValueTextBelowBarcode() renderuje zakodowany ciag danych jako etykiete pod paskami. Dla zaawansowanych scenariuszy generacji, zobacz dokumentację generacji kodu kreskowego IronBarcode.

Podejście BarcodeLib

BarcodeLib nie ma API do odczytu. Nie ma metody Decode(), Scan() ani ReadBarcode(). Odczyt nigdy nie był częścią projektu biblioteki. Każda próba wywołania metody dekodowania prowadzi do błędu kompilacji:

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

Imports BarcodeStandard
Imports SkiaSharp

Dim b = New Barcode()

' There is no Decode, Scan, or Read method on Barcode.
' b.Decode("barcode.png")      ' does not exist
' b.Scan("barcode.png")        ' does not exist
' b.ReadBarcode("barcode.png") ' does not exist

' The only public operation is generation:
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Zespoły, które potrzebują zarówno generowania, jak i odczytu oprócz BarcodeLib, muszą dodać drugą bibliotekę — zazwyczaj ZXing.Net — co wprowadza własne obciążenie zarządzaniem zależnościami i drugą powierzchnię API do utrzymania.

Podejście IronBarcode

BarcodeReader.Read() przyjmuje pliki obrazow, pliki PDF, strumienie i obiekty System.Drawing.Bitmap. Odczyt z pliku PDF nie wymaga dodatkowej biblioteki:

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

' Read from an image
Dim results = BarcodeReader.Read("barcode.png")
Console.WriteLine(results.First().Value)  ' "PRODUCT-12345"

' Read all barcodes from a PDF — no separate PDF library needed
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

enum ReadingSpeed pozwala na tuning wydajnosci skanowania w scenariuszach o duzym wolumenie. Aby uzyskać wskazówki dotyczące konfiguracji odczytu, zobacz dokumentację odczytu IronBarcode.

Podejście BarcodeLib

Poczawszy odBarcodeLib3.x, biblioteka wprowadzila SkiaSharp jako zaplecze graficzne w miejsce System.Drawing.Common, ktore stalo sie tylko dlaWindowspo .NET 6.BarcodeLib3.1.5 oglasza SkiaSharp >= 2.88.8. Jesli projekt juz uzywa SkiaSharp przez inna zaleznosc - co jest powszechne w projektach MAUI uzywajacych SkiaSharp.Views.Maui i Microsoft.Maui.Graphics, ktore zmierzaja w kierunku SkiaSharp 3.x - rozwiazane wersje moga sie nie zgadzac. Rezultatem jest ostrzeżenie NU1608 jako minimum, a w najgorszym przypadku błędne wiązanie zestawu podczas działania:

warning NU1608: Detected package version outside of dependency constraint:
BarcodeLib 3.1.5 requires SkiaSharp (>= 2.88.8) but
version SkiaSharp 3.116.1 was resolved.

Wymuszanie rozwiązania przez jawne odwołania do pakietu to jedna z dróg, chociaż nie gwarantuje zgodności podczas działania:

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />
  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />
  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

Nawet z jawnymi nadpisaniami, kompatybilność zależy od zgodności wezwań API wewnętrznychBarcodeLibz tym, co eksponuje rozwiązana wersja SkiaSharp. Jako projekt utrzymywany przez społeczność,BarcodeLibnie ma przywiązanego kontraktu wsparcia komercyjnego do swojego cyklu wydań.

Podejście IronBarcode

IronBarcode nie udostępnia grafu zależności SkiaSharp z kodem aplikacji. Nie ma negocjacji wersji do zarządzania, nie ma NU1608 do diagnozowania i nie ma ryzyka wiązania podczas działania związane z rozwiązaniem wersji SkiaSharp. Projekty MAUI, projekty Blazor i każda inna aplikacja, która zależy od SkiaSharp, mogą zainstalowaćIronBarcode bez żadnego konfliktu wersji. Dla wzorców integracji specyficznych dla MAUI, zobacz dokumentację MAUI IronBarcode.

Pojawia się potrzeba odczytu

System, który generował etykiety wysyłkowe przez miesiące, otrzymuje nowy wymóg: aplikacja musi również przetwarzać zwracane etykiety od dostawców. Integracja z magazynem wymaga parsowania kodów kreskowych z manifestów przesyłek przychodzących. System zarządzania dokumentami musi indeksować kody kreskowe na skanowanych PDF-ach.BarcodeLibnie może spełnić żadnego z tych wymogów — API do odczytu nie istnieje. Zespół ocenia dodanie ZXing.Net obok BarcodeLib, waży obciążenia związane z utrzymaniem dwóch bibliotek oraz dwóch oddzielnych grafów zależności i decyduje się na czyszlicsze rozwiązanie jako biblioteka, która obsługuje zarówno generowanie, jak i odczytywanie w ramach jednej instalacji NuGet.

Konflikt SkiaSharp w projekcie MAUI

Zespół dodajeBarcodeLibdo istniejącej aplikacji MAUI i natychmiast napotka ostrzeżenia NU1608 podczas przywracania. Badaja, identyfikuja niezgodnosc wersji miedzyBarcodeLibi SkiaSharp oczekiwanym zakresem a wersja wymagana przez MAUI, dodaja jawne <PackageReference> nadpisania, aby wymusic rozwiazanie, i doprowadzaja do przejscia budowy. Następnie napotykają awarię podczas działania na urządzeniu, gdy natywne binarne SkiaSharp ładują złą wersję. Naprawa wymaga głębszego spojrzenia na dziennik wiązania zestawu. Przekierowanie na IronBarcode usuwa problem u źródła — nie przez znalezienie kompatybilnej wersji SkiaSharp, ale przez całkowite wyeliminowanie wspólnej zależności.

Potrzebne przetwarzanie kodów kreskowych z PDF

Aplikacje, które generują dokumenty PDF z osadzonymi kodami kreskowymi — faktury, zlecenia pracy, manifests wysyłki — czasami muszą ponownie odczytać te kody kreskowe podczas przetwarzania w dół strumienia.BarcodeLibgeneruje obrazy kodów kreskowych, ale nie obsługuje PDF-ów na żadnym końcu. Odczytanie kodów kreskowych z PDF za pomocąBarcodeLibwymaga najpierw renderowania PDF do obrazów za pomocą oddzielnej biblioteki PDF, a następnie przekazywania tych obrazów do oddzielnej biblioteki odczytu.IronBarcode obsluguje caly lancuch natywnie: BarcodeReader.Read("file.pdf") przechodzi przez kazda strone I zwraca wszystkie wykryte kody kreskowe bez posredniego kroku renderowania.

Pojawia się potrzeba kodów QR lub innej symboliki 2D

Projekty, które początkowo wymagały tylko liniowych kodów kreskowych, często ewoluują, aby potrzebować kodów QR, macierzy danych, PDF417 lub wyjścia Aztec.BarcodeLibnie generuje zadnej symboilgii 2D w swojej serii 3.x — enum BarcodeStandard.Type nie zawiera zadnych pozycji QR lub innych pozycji 2D — wiec kazde zapotrzebowanie na 2D oznacza dodanie drugiej biblioteki lub calkowite zastapienie BarcodeLib. IronBarcode's QRCodeWriter i BarcodeWriter pokrywaja QR Code (z osadzaniem logo, kontrola kolorów i tuningiem korekcji bledow), Data Matrix, PDF417 i Aztec przez ten sam plynny API. Zepoły, których wymagania dotyczące symboliki przesuwają się w kierunku 2D, stwierdzają, że luka ta kieruje decyzję o migracji.

API instancyjne do statycznego API płynnego

KodBarcodeLibkorzysta z wzorca obiektu mutowalnego: utworz instancje Barcode, ustaw wlasciwosci, wywolaj Encode().IronBarcode uzywa statycznego wzorca plynnego: wywolaj BarcodeWriter.CreateBarcode(), lancuchowe metody konfiguracji, zakoncz metoda wyjsciowa. Istniejacy kod przechowujacy instancje Barcode jako pole lub przekazywany miedzy metodami bedzie wymagal restrukturyzacji. Typowa zmiana to zamiana bloku ustawiającego właściwości na łańcuchowe metody:

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

' The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .AddBarcodeValueTextBelowBarcode() _
    .SaveAsPng(outputPath)

SKImage do bezpośredniego wyjścia

BarcodeLib 3.x zwraca SKImage, co wymaga SKEncodedImageFormat i strumienia do produkcji bajtow. Kazdy kod typowany na SKImage lub przechodzacy przez image.Encode(...).SaveTo(stream) wymaga aktualizacji. Lancuch plynnosci IronBarcode konczy sie bezposrednio w wybranym formacie wyjsciowym — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — usuwajac potrzebe posredniego obiektu obrazu i kroku kodowania do strumienia.

Type Enum to BarcodeEncoding Enum

BarcodeLib 3.x uzywa BarcodeStandard.Type enum with wartosci PascalCase takie jak BarcodeStandard.Type.Code128.IronBarcode uzywa BarcodeEncoding enum z wartosciami takimi jak BarcodeEncoding.Code128. Wartosci 1D mapuja sie bezposrednio: Code128 → Code128, Ean13 → EAN13, UpcA → UPCA, Code39 → Code39. A grep dla BarcodeStandard.Type. w plikach .cs identyfikuje wszystkie wystapienia wymagajace aktualizacji.

Usunięcie odniesienia do SkiaSharp

Projekty, ktore dodaly jawne wpisy <PackageReference Include="SkiaSharp"> jedynie w celu rozwiazania ostrzezeniaBarcodeLibNU1608, moga usunac te nadpisania po przejsciu na IronBarcode. Polecenie dotnet list package --include-transitive potwierdza, czy SkiaSharp jest nadal wymagany przez inne pakiety w projekcie przed jego usunieciem.