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

Çoklu Paket Üretim Çalışma Akışı

Kurulum hikayesi kapsam farkını hemen göstermektedir.Barcoderile temel PNG çıktısı iki ayrı paket gerektirir:

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

Code128 barkod oluşturup PNG olarak kaydetmek için tam çalışma akışı üç namespace'i içe aktarımını, format özel bir kodlayıcı çağrısını, bir seçenekler nesnesi ile bir render inşasını, bir dosya akışını ve bir render çağrısını gerektirir:

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

Barkod formatlarını değiştirmek bir parametre değişikliği değildir - farklı bir namespace'i içe aktarmak ve farklı bir sınıf çağırmak gerekir. Code128Encoder.Encode, includeChecksum için bir bool alır, QrEncoder.Encode hata düzeltme seviyesi ve iki ek bool alır, ve DataMatrixEncoder.Encode sadece dize alır. Belirlenen bir formatta barkod oluşturmak için birleşik bir arayüz yoktur.

Detayli Özellik Karsilastirmasi

Barcoder Yaklaşımı

Barcoder format seçimini ayrı ad alanlarındaki ayrı kodlayıcı sınıflar üzerinden yönlendirir. Formatları değiştirmek, yeni bir using yönergesi eklemek ve farklı bir yöntem imzasına sahip farklı bir sınıf kullanmak anlamına gelir:

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

Her kodlayıcının kendi parametre sözleşmesi vardır. Mevcut bir projeye yeni bir format eklemek tek kelimelik bir değişiklik değildir — yeni bir ad alanı ekleme, yeni bir sınıf öğrenme ve yeni parametreleri anlama gerektirir.

IronBarcode Yaklaşımı

IronBarcode, birleşik BarcodeWriter sınıfında BarcodeEncoding enum üzerinden tüm format seçimini yönlendirir. Yeni bir format eklemek enum değerini tek kelimeyle değiştirmek demektir:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

Üretim kullanımı için, uygulama başladığında lisans anahtarını ekleyin:

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

IronBarcode barkod oluşturma belgeleri stil, kenar boşlukları ve renk özelleştirmesi de dahil bir dizi oluşturma seçeneklerini kapsar.

Barcoder Yaklaşımı

Barcoder'in kodlama ile render'dan ayrılması bir mimari olarak ilkelidir, ancak her çıktının format değişikliği için ek yük yaratır. Bir dosyaya kaydetmek, bir FileStream açmayı gerektirir. İkili veri almak, bir MemoryStream açmayı ve ToArray() çağırmayı gerektirir. Her çıkış senaryosu bir seçenekler nesnesi ile bir render yapılandırması gerektirir:

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

Boyut kontrolü dolaylı: PixelSize, doğrudan genişlik ve yükseklik belirlemesi değil, barkod modül boyutu üzerinde bir ölçek çarpanıdır.

IronBarcode Yaklaşımı

IronBarcode, zincirlenmiş yöntem çağrılarıyla her türlü çıktıya ulaşılabilen bir GeneratedBarcode nesnesi döndürür. Render oluşturumu yok, akış yönetimi yok:

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height) açıkça piksel boyutlarını alır ve aynı nesne üzerinde herhangi bir çıkış yöntemi ile zincirlenir.

Barcoder Yaklaşımı

Barcoder'un okuma veya kod çözme yeteneği yoktur. Kütüphane içinde bir API yoktur, planlı bir API yoktur ve bir çözüm yolu yoktur. Bir uygulamanın barkodları okuması gerekiyorsa, Barcoder'a ek olarak, ayrı bir NuGet bağımlılığı olan kendi API yüzeyi ve kendi sürümü olan ikinci bir kütüphane eklenmelidir. Bu, en az iki okuma ile ilgili bağımlılığı ifade eder: üretim içinBarcoderve okuma için başka bir şey.

IronBarcodeYaklaşımı

IronBarcode, aynı paket ve tutarlı API desenleri ile hem üretim hem de okuma özelliğini kapsar. BarcodeReader.Read() yöntemi resim dosyalarını, bayt dizilerini, akışları ve PDF'leri yerel olarak kabul eder:

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

//PDF'den okuma— no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

//PDF'den okuma— no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine(result.Value)
    Console.WriteLine(result.Format)
Next

' PDF'den okuma— no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

PDF'lerden okuma doğaldır — arada bir görüntü çıkarımı, bir dönüştürme kütüphanesi veya ek bir paket gerektirmez. IronBarcode barkod okuma belgeleri, çok sayfalı PDF'leri, ilgi alanı okumalarını ve performans ayarlamasını kapsar.

Okuma Gereksinimlere Eklendiğinde

Birçok proje, saf üretim hattı olarak başlar — etiket basma, belgeler için kod oluşturma, raporlara barkod gömme. Barcoder, bu projelere başlangıçta hizmet verir. Aynı uygulama daha sonra gelen barkodları doğrulayacak, taranan belgeleri işleyacak veya yüklenen PDF'lerden barkod çözecek olduğunda,Barcoderbir çözüm sunmaz. Takım, ikinci bir kütüphaneyi değerlendirmek, API'sini öğrenmek, NuGet sürümünü ayrı olarak yönetmek ve iki kütüphane arasındaki entegrasyon yüzeyini harekete geçirmek zorundadır. Bu aşamaya ulaşan takımlar, iki ayrı barkod bağımlılığı yerine her iki tarafı da ele alan bir kütüphaneye konsolide olurlar.

.NET FrameworkUyumluluğu Kırılması

Barcoder.Renderer.Image.NET Frameworkdesteğini kaldırdı..NET Framework4.x üzerinde hizmetler veya masaüstü uygulamaları olan, bağımlılık bakım sırasında görüntü render paketini güncelleyen ekipler, bir derleme hatasıyla karşılaşır. Bu bir yanlış yapılandırma değildir — kütüphanenin platform destek kararıdır. IronBarcode, farklı hedefler için özel paketleme veya koşullu bağımlılıklar olmadan.NET Framework4.6.2'den .NET 9'a kadar destek sunar.

Paket Sürüm Kayması Koordinasyon Sorunlarına Yol Açıyor

Barcoder ve Barcoder.Renderer.Image bağımsız olarak sürümlendiğinde, birini diğerini güncellemeden güncellemek, bağımlılık yenilemesi sırasında ince uyumsuzluklar getirebilir. Birden çok projeyi içeren bir depoda — her biri farklı bir render paketi sürümü tüketiyorsa — projeler arasında tutarlı davranışı sağlamak, ekibin boyutuyla büyüyen bir koordinasyon problemi olur. IronBarcode'a konsolide olan ekipler, tek bir paket ve tek bir sürümü yönetmenin bu tür bir sorunu tamamen kaldırdığını bildirir.

Format Kapsamı Zamanla Genişliyor

Bir proje, başlangıçta Code128 etiketlerle başlayabilir ve daha sonra müşteri odaklı bağlantılar için QR kodları, ardından uyumluluk gereksinimleri için DataMatrix ekleyebilir.Barcoderile her format eklemesi, bir ad alanı eklemesi, farklı parametrelerle farklı bir kodlayıcı sınıfı ve potansiyel olarak yeni bir NuGet paketi demektir.IronBarcodeile, format eklemek, mevcut bir çağrıda BarcodeEncoding enum değerine yapılan bir değiştirmedir. Barkod format kapsamını genişletmeyi içeren yol haritalarına sahip ekipler, enum tabanlı modeli çok daha kolay bir şekilde sürdürülebilir bulurlar.

MAUI ve Çapraz Platform Dağıtım Gereksinimleri

Barcoder, MAUI, Docker, AWS Lambda veya Azure dağıtımlarına destek verdiğini belgelendirmez. Çapraz platform MAUI uygulamaları geliştiren veya barkod işlemeyi sunucusuz altyapıya dağıtan ekipler, Barcoder'in belgeleri ve testlerinin bu hedefleri kapsamadığını tespit eder. IronBarcode, iOS, Android, Windows, macOS MAUI hedefleri, Docker kapsayıcıları ve büyük bulut platformları arasında dağıtımı belgelendirir ve aktif olarak test eder.

IBarcode ile GeneratedBarcode Tür Değişikliği

Barcoder kodu, bir IBarcode değişkenini depolayan ve daha sonra bir işleyiciye ileten kod yeniden düzenlenmelidir. IronBarcode'da, GeneratedBarcode kendi çıkış yöntemlerini taşır — ayrı bir işleyici adımı yoktur. Şu anda IBarcode kabul eden herhangi bir yöntem imzası, GeneratedBarcode kabul etmeye değişmelidir, ve bu yöntemin içindeki işleme çağrısı, .SaveAsPng() veya .ToPngBinaryData() gibi doğrudan bir çağrı olmalıdır. Tür sistemi, derleme sırasında güncellenmesi gereken her konumu ortaya çıkaracaktır — IBarcode,Barcoderpaketleri kaldırıldıktan sonra çözülmeyecek.

PixelSize Doğrudan Eşdeğeri Yoktur

Barcoder'ın PixelSize'yi, bir barkodun doğal modül boyutu üzerinde bir ölçek çarpanıdır, açık piksel boyutu değildir. Çıkış genişliği, barkod içeriğine, formata ve skala çarpanına bağlıdır.IronBarcode.ResizeTo(width, height), açık piksel boyutları ile kullanır. Geçiş sırasında, mevcutBarcoderkodunun ürettiği gerçek çıkış boyutlarını ölçün ve .ResizeTo() çağrısında bu değerleri kullanın:

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

Ad Alanı Konsolidasyonu

Barcoder projeleri, kullanılan her format için bir using Barcoder.* ifadesi biriktirir. Geçiş sırasında, bunların tamamı tek bir using IronBarCode;'e çöker. Çözüm genelinde bir using Barcoder araması, güncellenmesi gereken her dosyayı tanımlayacaktır. Etkilenen dosya sayısı genellikle takımların beklediğinden daha fazladır, çünkü barkod formatına dokunan her dosya kendi format özelindeki ad alanını ithal ederdi.

SVG Çıkış Yolu Değişiklikleri

Barcoder.Renderer.Svg ve SvgRenderer sınıfını kullanan projeler, işleyici hattını GeneratedBarcode üzerinde doğrudan bir yöntem çağrısı ile değiştirir:

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

Tüm SVG render yerleri taşındıktan sonra Barcoder.Renderer.Svg paketi kaldırılabilir.