BarcodeLib ve IronBarcode: C# Barkod Kütüphanesi Karşılaştırması

BarcodeLib Çekirdek Üretim Deseni

StandartBarcodeLibolusturma is akisi, bir örnek oluşturmayi, özellikleri ayarlamayi ve Encode() cagrisi yapmayi gerektirir:

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging

Dim b As New Barcode()
b.IncludeLabel = True
b.Width = 300
b.Height = 100
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")
img.Save("barcode.png", ImageFormat.Png)

Bu tam üretim iş akışıdır. Özellik-ayarci deseni tasarimi: Tüm konfigürasyon Encode() cagrisi yapilmadan once örnek uzerinde gerceklesir ve donen değer, ayri olarak kaydedilmesi veya bayt olarak cevrilmesi gereken bir System.Drawing.Image olur.

Detayli Özellik Karsilastirmasi

BarcodeLib Yaklaşımı

BarcodeLib, Encode() adimini cagrmadan once bir örnek oluşturmayi ve özellikleri ayarlamayi gerektirir. Cikti, bir System.Drawing.Image nesnesidir:

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.IO

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    b.Width = 300
    b.Height = 100
    Dim img As Image = b.Encode(TYPE.CODE128, data)

    Using ms As New MemoryStream()
        img.Save(ms, ImageFormat.Png)
        Return ms.ToArray()
    End Using
End Function

System.Drawing.Image, donus türü, bayt dizisi cikisi icin bir MemoryStream araci gerektigini gösterir. IncludeLabel ozelligi, boolean bir gecis — BarcodeLib, kodlanmis veri dizgisini otomatik olarak cubuklara altindaki gorunur etiket olarak cizer.

IronBarcode Yaklaşımı

IronBarcode'un oluşturması tamamen statiktir. CreateBarcode() sonraki yapılandırma zincirleri ve cikti yöntemleri zinciri dogrudan sonlandirir:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

Imports IronBarCode

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

.ToPngBinaryData() bayt dizisini dogrudan döndürür — ara Image veya MemoryStream nesnesi gerekmez. .AddAnnotationTextBelowBarcode() etiket dizgisini acikça alir, cubuklarin altinda hangi metnin gorunmesi gerektigini kontrol etmenizi saglar. Gelişmiş oluşturma senaryoları için IronBarcode barkod oluşturma belgelerine bakın.

BarcodeLib Yaklaşımı

BarcodeLib'in okuma API'si yoktur. Burada Decode(), Scan() veya ReadBarcode() metodu yok. Bu eksiklik bir sürüm farkı değildir — okuma, kütüphanenin tasarımının bir parçası olmamıştır. Bir kod çözme yöntemi çağrısı denemesi bir derleme hatasıyla sonuçlanır:

//BarcodeLib— reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

//BarcodeLib— reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

Imports BarcodeLib

Dim b As New Barcode()

' This will not compile — there is no Decode or Read method
' Dim value = b.Decode("barcode.png")       ' CS1061: no definition
' Dim value = b.Scan("barcode.png")         ' CS1061: no definition
' Dim value = b.ReadBarcode("barcode.png")  ' CS1061: no definition

' The only thing you can do is generate:
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")  ' this works

Hem oluşturma hem de okumaya ihtiyaç duyanBarcodeLibkullanıcıları, genellikle kendi bağımlılık yönetimi yükünü ve ikinci bir API yüzeyini ekleyen ikinci bir kütüphane - genellikle ZXing.Net - eklemelidir.

IronBarcode Yaklaşımı

BarcodeReader.Read() görüntü dosyalarini, PDF dosyalarini, akimlari ve System.Drawing.Bitmap nesnelerini kabul eder. PDF'lerden okuma için ek bir kütüphane gerektirmez:

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)

ReadingSpeed enumu, yuksek hacimli senaryolar icin tarama performansini ayarlamaya izin verir. Okuma yapılandırması kılavuzu için IronBarcode okuma belgelerine bakın.

BarcodeLib Yaklaşımı

BarcodeLib 3.x ile başlayarak, kutuphane .NET 6'den sonra sadece Windows'a kalan System.Drawing.Common yerine grafikler icin arka plan olarak SkiaSharp'i tanitti. BarcodeLib, belirli bir SkiaSharp sürüm araligina baglidir. Bir proje zaten SkiaSharp'i baska bir bagimlilik araciligiyla kullanıyorsa — SkiaSharp.Views.Maui ve Microsoft.Maui.Graphics kullanan MAUI projelerinde yaygindir —, cozumlenen sürüm, BarcodeLib'in beklenen araliginin disina dusebilir. Sonuç minimumda bir NU1608 uyarısı ve en kötü durumda çalışma zamanında bir derleme bağlama başarısızlığıdır:

Uyarı NU1608: Bağımlılık sınırının dışında paket sürümü tespit edildi:
BarcodeLib 3.1.5, SkiaSharp'ı (>= 2.88.7 && < 2.89.0) gerektirir, ancak
SkiaSharp 3.116.1 sürümü çözüldü.

Açık paket referanslarıyla çözüm zorlamak, bir garanti olmaksızın karmaşıklık ekler:

<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>

Açık geçersiz kılmalara rağmen, uyumluluk, BarcodeLib'in dahili API çağrılarının sabitlenen sürümün açıkladıklarına uyması durumuna bağlıdır. Projeye etkili bir çözümü zamanında sağlamak için garanti eden bir destek sözleşmesi yoktur.

IronBarcode Yaklaşımı

IronBarcode, uygulama koduyla paylaşılan SkiaSharp bağımlılık grafiğini paylaşmaz. Yönetilecek bir sürüm müzakeresi, teşhis edilecek bir NU1608 veya SkiaSharp sürüm çözümlemesine bağlı bir çalışma zamanı derleme bağlama riski yoktur. MAUI projeleri, Blazor projeleri ve SkiaSharp'a bağımlı diğer tüm uygulamalar, IronBarcode'u sürüm çatışması olmadan kurabilir. MAUI'ye özgü entegrasyon desenleri için IronBarcode MAUI belgelerine bakın.

Okuma Gereksinimi Oluşur

Aylardır sevkıyat etiketleri üreten bir sistem yeni bir gereklilik alır: uygulama, tedarikçiden gelen iade etiketlerini de işlemelidir. Depo entegrasyonu, gelen nakliye manifestolarından barkodları ayrıştırması gerekir. Bir belge yönetim sistemi, taranmış PDF'lerdeki barkodları dizine eklemelidir. BarcodeLib, bu gereksinimlerin hiçbirini karşılayamaz — okuma API'si yoktur. Ekip,BarcodeLibyanında ZXing.Net eklemeyi değerlendirir, çift kütüphane bakım yükünü ve iki ayrı bağımlılık grafiğini tartar ve daha temiz yolun tek bir NuGet kurulumu altında hem oluşturma hem de okuma işlemlerini gerçekleştiren bir kütüphane olduğunu belirler.

MAUI Projesinde SkiaSharp Çatışması

Bir ekip, mevcut bir MAUI uygulamasınaBarcodeLibekler ve derleme sırasında hemen NU1608 uyarılarıyla karşılaşır. Versiyon uyumsuzlugunu saptayarak, MAUI'nin gerek duydugu sürüm ile BarcodeLib'in beklediginden farkli olan sürüm arasindaki esitsizligi belirler, @@@-CODE-458---@ dizinlerini acik bir sekilde ekleyerek cozum zorunlu hale getirirler ve yapıyı gecirmeyi saglarlar. Daha sonra yanlış sürüm yüklendiğinde cihazda bir çalışma zamanı çöküşü yaşarlar. Düzeltme, derleme bağlama günlüğüne daha derin bir araştırma gerektirir. İronBarcode'a geçiş yapmak, paylaşılan bağımlılığı tamamen ortadan kaldırarak sorunu kökünden çözer — uyumlu bir SkiaSharp sürümü bularak değil.

PDF Barkod İşleme Gereksinimi

Gömülü barkodlarla PDF belgeleri üreten uygulamalar — faturalar, iş emirleri, nakliye manifestoları — bazen bu barkodları aşağı akış işlemleri sırasında yeniden okumak zorunda kalır.BarcodeLibbarkod görüntüleri oluşturur ancak PDF desteği yoktur.BarcodeLibile bir PDF'den barkod okumak, önce bir ayrı PDF kütüphanesi kullanarak PDF'yi görüntülere dönüştürmeyi, ardından bu görüntüleri ayrı bir okuma kütüphanesine geçirmeyi gerektirir. IronBarcode, tam zinciri yerel olarak ele alır: BarcodeReader.Read("file.pdf"), her sayfayi gezer ve bir ara cizim adimi olmadan tüm tespit edilen barkodları geri dönderir.

QR Kod Özellikleri Temel Oluşturmayı Aşıyor

Başlangıçta yalnızca temel QR kodu oluşturma gerektiren projeler, genellikle logo yerleştirme, renk özelleştirme veya hata düzeltme seviyesi yapılandırması gerektirmeye evrilir. BarcodeLib, TYPE.QR_Code uzerinden QR kodlarini destekler, ancak standart Width, Height ve IncludeLabel özelliklerinin oteesinde seçenek sunmaz. IronBarcode'nin QRCodeWriter 'si, zincirleme metodlar vasitasiyla logo gomulebilirliklerini, renk kontrolunu ve hata düzeltme ayarlamalarını açığa cikarir. QR kod gereksinimleri BarcodeLib'in temel uygulamasının sunduklarını aşmış olan ekipler, özellik boşluğunun göç kararını yönlendirdiğini görür.

Örnek API'den Statik Akıcı API'ye

BarcodeLib kodu, değiştirilebilir nesne modelini kullanir: bir Barcode ornegi oluşturun, özellikleri ayarlayin, Encode() cagrisi yapin. IronBarcode, statik ayrintili bir modeli kullanır: BarcodeWriter.CreateBarcode() cagrisi yapın, yapılandırma metodlarini zincirleyin, bir cikti yöntemiyle sonlandirin. Bir alanda saklanan veya metodlar arasinda gecisi yapilan bir Barcode ornegini kullanan mevcut kod yapılandırilmasi gerekecektir. Tipik değişiklik, özellik ayarlayıcı bloğunu bir yöntem zinciri ile değiştirmektir:

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

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

System.Drawing.Image'dan Doğrudan Çıkışa

BarcodeLib, System.Drawing.Image dönderir, bu da bayt oluşturmak icin MemoryStream gerektirir. Image ve System.Drawing.Image ile yazilan herhangi bir kod güncellenmelidir. IronBarcode'nin yapılandırma zinciri istenen cikti formatini dogrudan sonlandirır — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() —, bu da ara bir görüntü nesnesi ve MemoryStream adimina ihtiyaçı ortadan kaldirir.

TYPE Enum'dan BarcodeEncoding Enum'una

BarcodeLib, TYPE sinifini buyuk harf sabitleri ile kullanır, örnegin TYPE.CODE128 gibi. IronBarcode, BarcodeEncoding enumunu PascalCase degerlerle kullanir, örneğin BarcodeEncoding.Code128 gibi. Değerler doğrudan eşleşir. Bir TYPE\.'i .cs dosyalari boyunca arayarak güncellenmesi gereken tüm örnekleri belirler, ve sistemli bir bul ve değiştir işlemi yaygin formatları kaplar: CODE128 → Code128, EAN13 → EAN13, UPCA → UPCA, QR_Code → QRCode.

SkiaSharp Referans Temizleme

BarcodeLib'in NU1608 uyarilarini cozumlemek icin sadece acikça <PackageReference Include="SkiaSharp"> girisi ekleyen projeler, IronBarcode'a gectikten sonra bu geçersiz kilmalari kaldırabilir. dotnet list package --include-transitive komutu, proje icindeki diğer paketler tarafindan SkiaSharp'in hala gerekip gerekmedigini kontrol eder ve sonra kaldirir.