Çok Paketli Üretim İş Akışı

Kurulum hikayesi hemen kapsam farkını 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

Bir Code128 barkodu oluşturmak ve bunu bir PNG olarak kaydetmek için tam iş akışı üç ad alanı alımı, format özel kodlayıcı çağrısı, bir seçenekler nesnesiyle bir oluşturucu yapımı, bir dosya akışı ve bir işleme çağrısı gerektirir:

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

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ğil — farklı bir ad alanı almak ve farklı bir sınıf çağırmak gerektirir. Code128Encoder.Encode, includeChecksum için bir bool alır, QrEncoder.Encode bir hata düzeltme seviyesi ve iki ek bool alır ve DataMatrixEncoder.Encode yalnızca dizeyi alır. Belirtilen bir formatta bir barkod oluşturmak için birleşik bir arayüz yoktur.

Ayrıntılı Özellik Karşılaştırması

Barcoder Yaklaşımı

Barcoder, format seçim işlemini ayrı ad alanlarındaki ayrı kodlayıcı sınıflar üzerinden yönlendirir. Format değiştirmek yeni bir using direktifi eklemek ve farklı bir yöntem imza ile farklı bir sınıf kullanmak anlamına gelir:

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

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

// DataMatrix
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

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

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

// DataMatrix
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
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix
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ğil — yeni bir ad alanı alımı, öğrenilecek yeni bir sınıf ve anlayacak yeni parametreler.

IronBarcode Yaklaşımı

IronBarcode, tüm format seçimini birleşik BarcodeWriter sınıfındaki BarcodeEncoding enum yoluyla yönetir. Yeni bir format eklemek, enum değerindeki tek kelimelik bir değişikliktir:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// DataMatrix
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated 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şlangıcında lisans anahtarını ekleyin:

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

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

Imports IronBarCode

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

IronBarcode barkod oluşturma belgesi, stil, kenar boşlukları ve renk özelleştirme dahil olmak üzere üretim seçeneklerinin tam kapsamını kapsar.

Barcoder Yaklaşımı

Barcoder'ın kodlamayı işlemden ayırması bir mimari olarak ilkelidir, ancak her çıktı formatı değişimi için ek maliyet yaratır. Bir dosyaya kaydetmek için bir FileStream açılması gerekir. İkili veri almak için bir MemoryStream açılması ve ToArray() çağrısı gerekir. Her çıktı senaryosu, bir seçenekler nesnesiyle bir işlemci oluşturmayı gerektirir:

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' File output
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})
Using stream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Binary data via MemoryStream
Using ms = New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

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

IronBarcode Yaklaşımı

IronBarcode, zincirleme metod çağrıları ile herhangi bir çıkış formuna erişilebilen bir GeneratedBarcode nesnesi döndürür. Oluşturucu veya 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 piksel boyutlarını alır ve aynı nesne üzerindeki herhangi bir çıkış yöntemi ile zincirlenir.

Barcoder Yaklaşımı

Barcoder'ın okuma veya kod çözme yeteneği yoktur. Bir API, planlanmış bir API veya kütüphane içinde bir çözüm yolu yoktur. Bir uygulamanın barkod okuması gerekiyorsa, Barcoder'ın yanında başka bir kütüphane — kendi API yüzeyi ve takip edilmesi gereken kendi versiyonu olan ayrı bir NuGet bağımlılığı — eklenmelidir. Bu, en az iki okuma yan yana bağımlılık anlamına gelir: üretim içinBarcoderve okuma için başka bir şey.

IronBarcode Yaklaşımı

IronBarcode, aynı paket ve tutarlı API düzenekleri ile hem üretim hem de okuma işlemini kapsar. BarcodeReader.Read() metodu, yerel olarak görüntü dosyalarını, bayt dizilerini, akışları ve PDF'leri 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 oku natively
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 oku natively
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 oku natively
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ğal — ara görüntü çıkarma, dönüşüm kütüphanesi, ek paket yoktur. IronBarcode barkod okuma belgesi, çok sayfalı PDF'ler, ilgi bölgesi okuması ve performans ayarlamalarını kapsar.

Okuma Gereksinimlere Eklenir

Birçok proje, saf üretim hatları olarak başlar — etiket yazdırır, belgeler için kodlar oluşturur, raporlara barkod gömer. Barcoder, bu projelere başlangıçta hizmet eder. Aynı uygulama daha sonra gelen barkodları doğrulamak, taranmış belgeleri işlemek veya yüklenen PDF'lerden barkod çözmek gerektiğinde,Barcoderileriye doğru bir yol sunmaz. Ekip, ikinci bir kütüphaneyi değerlendirmeli, API'sini öğrenmeli, NuGet sürümünü ayrı ayrı yönetmeli ve iki kütüphane arasındaki entegrasyon yüzeyini ele almalıdır. Bu noktaya ulaşan ekipler, genellikle iki ayrı barkod bağımlılığı yerine her iki tarafı da ele alan bir kütüphaneye konsolide olurlar.

.NET Framework Uyumlu Olmama Durumu

Barcoder.Renderer.Image,.NET Frameworkdesteğini bıraktı. Bakım yapan ya da.NET Framework4.x üzerinde masaüstü uygulamaları bulunan ekipler, rutin bağımlılık bakımında görüntü işleme paketini güncellerken bir inşa hatasıyla karşılaşır. Bu bir yanlış yapılandırma değil — kütüphane tarafından alınan bir platform desteği kararı. IronBarcode,.NET Framework4.6.2 ile.NET 9arasında destek sunar, farklı hedefler için özel paketleme veya koşullu bağımlılıklar gerektirmez.

Paket Sürümü Farklılığı Koordinasyon Sorunları Yaratır

Barcoder ve Barcoder.Renderer.Image bağımsız olarak versiyonlanmış olduğunda, bunlardan birini diğerinden bağımsız olarak güncellemek, bir bağımlılık yenilemesi sırasında ince uyumsuzluklar oluşturabilir. Bir depo birden fazla proje içeriyorsa - her biri her oluşturucu paketinin farklı bir sürümünü kullanıyorsa - projeler arasında tutarlı davranış sağlaması, ekibin büyüklüğüyle koordinasyon sorunu haline gelir. IronBarcode'a konsolide olan ekipler, tek bir paket ve tek bir sürümü yönetmenin bu sorun kategorisini tamamen ortadan kaldırdığını bildiriyor.

Format Kapsamı Zamanla Genişler

Bir proje, Code128 etiketleri ile başlayabilir, daha sonra müşteri bağlantıları için QR kodları ve ardından uyumluluk gereksinimleri için DataMatrix ekleyebilir.Barcoderile her format eklentisi, yeni një ad alanı alınımı, farklı yöntem parametrelerine sahip bir kodlayıcı sınıf ve muhtemelen yeni bir NuGet paketi anlamına gelir.IronBarcode ile, bir format eklemek mevcut bir çağrıda BarcodeEncoding enum değerine bir değişikliktir. Barkod format kapsamını genişletmeyi içeren yol haritalarına sahip ekipler, enum tabanlı modeli önemli ölçüde daha kolay bulurlar.

MAUI ve Çok Platformlu Dağıtım Gereksinimleri

Barcoder, MAUI, Docker, AWS Lambda veya Azure dağıtımları için destek belgelememektedir. Çapraz platform MAUI uygulamaları oluşturan veya sunucusuz altyapıya barkod işlemeyi dağıtan ekipler, Barcoder'ın belgelerinin ve testlerinin bu hedefleri kapsamadığını tespit eder. IronBarcode, iOS, Android, Windows, macOS MAUI hedefleri, Docker konteynerleri ve büyük bulut platformları arasında dağıtımı belgeler ve aktif olarak test eder.

IBarcode'den GeneratedBarcode Tür Değişimi

Barcoder kodu, bir IBarcode değişkeni depolayan ve bunu daha sonra bir rendera geçiren kodun yeniden yapılandırılması gerekir. IronBarcode'da, GeneratedBarcode kendi çıkış yöntemlerini taşır — ayrı bir renderer adımı yoktur. Şu anda IBarcode kabul eden herhangi bir yöntem imzası, GeneratedBarcode kabul edecek şekilde değişmeli ve o yöntemin içindeki render çağrısı .SaveAsPng() veya .ToPngBinaryData() gibi doğrudan bir çağrıya dönüşmeli. Tür sistemi, derleme sırasında güncelleme gerektiren her yeri ortaya çıkaracaktır — IBarcode,Barcoderpaketleri kaldırıldıktan sonra çözülemez.

PixelSize Doğrudan Bir Karşılığına Sahip Değil

Barcoder'ın PixelSize, barkodun doğal modül boyutu üzerinde bir ölçek çarpanıdır, belirli bir piksel boyutu değildir. Çıktı genişliği, barkod içeriğine, formata ve çarpanla birlikte kombinasyona bağlıdır. IronBarcode, belirli piksel boyutları ile .ResizeTo(width, height) kullanır. Geçiş sırasında, mevcutBarcoderkodunun ürettiği gerçek çıkış boyutlarını ölçün ve bu değerleri .ResizeTo() çağrısında 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 birer tane olmak üzere using Barcoder.* ifadelerini biriktirir. Geçiş sırasında, tüm bunlar tek bir using IronBarCode; içine çöker. Tüm çözümdeki using Barcoder araması, güncelleme gerektiren her dosyayı tanımlar. Etkilenen dosya sayısı genellikle ekiplerin beklediğinden daha fazladır, çünkü bir barkod formatını dokunan her dosya kendi format-spesifik ad alanını eklenmiştir.

SVG Çıktı Yolu Değişiklikleri

Barcoder.Renderer.Svg ve SvgRenderer sınıfını kullanan projeler, renderer hattını GeneratedBarcode üzerindeki 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")

Barcoder.Renderer.Svg paketi, tüm SVG rendering konumları taşındıktan sonra kaldırılabilir.