BarcodeLib Çekirdek Oluşturma Deseni

StandartBarcodeLiboluşturma iş akışı, bir örnek oluşturmayı, özellikleri yapılandırmayı ve Encode()'a boyutlarla çağırmayı gerektirir:

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

Bu, tam oluşturma iş akışıdır. Özellik setter modeli tasarımdır: yapılandırma, Encode() çağrısından önce örnek üzerinde gerçekleşir ve dönen değer, kodlanması ve bir akışa yazılması gereken bir SKImage'dir.

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

BarcodeLib Yaklaşımı

BarcodeLib'de, Encode()'a boyutlarla çağrılmadan önce bir örnek oluşturmak ve özellikleri ayarlamak gereklidir. Çıktı bir SKImage'dir:

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

SKImage dönüş türü, bayt dizisi çıktısının bir SKEncodedImageFormat kodlama çağrısı ve bir MemoryStream gerektirdiği anlamına gelir. IncludeLabel özelliği bir boolean anahtarıdır — BarcodeLib, kodlanmış veri dizesini çubukların altında görünen etiket olarak render eder.

IronBarcode Yaklaşımı

IronBarcode'un oluşturması tamamen statik bir yapıya sahiptir. CreateBarcode() sonrasında yapılandırma zincirleri, ve çıktı metodları zinciri doğrudan sonlandırır:

// 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() bayt dizisini doğrudan döndürür — ara Image veya MemoryStream nesnesi yok. .AddBarcodeValueTextBelowBarcode(), kodlanmış veri dizesini çubukların altındaki etiket olarak render eder. İleri seviye oluşturma senaryoları için, IronBarcode barkod oluşturma belgelendirmesi 'ne bakın.

BarcodeLib Yaklaşımı

BarcodeLib'in okuma API'si yoktur. Decode(), Scan(), veya ReadBarcode() yöntemi yoktur. Okuma, kütüphanenin tasarımının hiçbir zaman bir parçası olmamıştır. Bir kod çözme metodunu çağırmaya yönelik herhangi bir deneme derleme hatasıyla sonuçlanır:

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)

BarcodeLib ile birlikte okunmayı ve oluşturmayı gerektiren ekipler, genellikle ZXing.Net gibi ikinci bir kütüphane eklemeli, bu da kendi bağımlılık yönetimini ve bakımı açısından ikinci bir API yüzeyi oluşturur.

IronBarcode Yaklaşımı

BarcodeReader.Read(), görüntü dosyalarını, PDF dosyalarını, akışları ve System.Drawing.Bitmap nesnelerini kabul eder. PDF'den okuma için ek bir kütüphane gerekmez:

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 enum, yüksek hacimli senaryolar için tarama performansını ayarlamaya izin verir. Okuma yapılandırması rehberi için, IronBarcode okuma belgelendirmesi 'ne bakın.

BarcodeLib Yaklaşımı

BarcodeLib 3.x ile başlayan kütüphane, .NET 6 sonrasında Windows'a özel hale gelen System.Drawing.Common'yi değiştirmek için bir grafik arka uç olarak SkiaSharp'ı tanıttı.BarcodeLib3.1.5 SkiaSharp >= 2.88.8 ilan eder. Bir proje başka bir bağımlılık yoluyla SkiaSharp kullandıysa — özellikle SkiaSharp.Views.Maui ve Microsoft.Maui.Graphics kullanan MAUI projelerinde yaygın — çözülen sürümler örtüşmeyebilir. Sonuç, en azından bir NU1608 uyarısı ve en kötü durumda çalışma zamanında bir montaj bağlama hatasıdır:

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.

Çözümün zorlanması, açık paket referansları ile bir yol olsa da, çalışma zamanı uyumluluğunu garanti etmez:

<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ılmalar olsa bile, uyumluluk, BarcodeLib'in iç API çağrılarının, çözülen SkiaSharp sürümünün sağladıklarıyla eşleşmesine bağlıdır. Topluluk tarafından sürdürülen bir proje olarak, BarcodeLib'in yayın döngüsüne bağlı hiçbir ticari destek sözleşmesi yoktur.

IronBarcode Yaklaşımı

IronBarcode, uygulama koduyla SkiaSharp bağımlılık grafiğini paylaşmaz. Yönetilecek bir sürüm pazarlığı yoktur, çözülecek bir NU1608 veya SkiaSharp sürüm çözümüyle bağlı çalışma zamanı montaj bağlama riski yoktur. MAUI projeleri, Blazor projeleri ve SkiaSharp'a bağımlı diğer uygulamalar, herhangi bir sürüm çatışması olmadan IronBarcode'u kurabilirler. MAUI özel entegrasyon kalıpları için, IronBarcode MAUI belgelendirmesine bakın.

Okuma Gereksinimi Ortaya Çıkar

Aylarca gönderi etiketleri üreten bir sistem yeni bir gereksinim alır: uygulama ayrıca tedarikçilerden iade edilen etiketleri de işleyecektir. Depo entegrasyonu gelen gönderi manifestosundaki barkodları okumalıdır. Bir belge yönetim sistemi, taranmış PDF'lerdeki barkodları indekslemelidir.BarcodeLibbu gereksinimlerin hiçbirini karşılayamaz — okuma API'si yoktur. Ekip,BarcodeLibile birlikte 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 hem oluşturma hem de okuma işlemlerini tek bir NuGet yüklemesinde ele alan bir kütüphane olduğunu belirler.

MAUI Projesinde SkiaSharp Çatışması

Bir ekip, mevcut bir MAUI uygulamasınaBarcodeLibekler ve hemen geri yükleme sırasında NU1608 uyarılarıyla karşılaşır. Version mismatch sorunlarını çözmek için, BarcodeLib'in beklenen SkiaSharp aralığı ile MAUI'nin gerektirdiği versiyon arasındaki farkı tespit edip inceleme yaparak, çözümü zorlamak için explicit <PackageReference> geçersiz kılmaları ekler ve yapıyı geçirirler. Daha sonra cihaz üzerinde, SkiaSharp'ın yerel ikilityelerini yanlış sürüm yüklediğinde bir çalışma zamanı çökmesiyle karşılaşırlar. Düzeltme, montaj bağlama günlüğünde daha derin bir araştırma gerektirir. IronBarcode'a geçmek, çatışmayı kökten kaldırır — uyumlu bir SkiaSharp sürümü bulmak yerine, paylaşılan bağımlılığı tamamen ortadan kaldırarak.

PDF Barkod İşleme Gereklidir

Yerleşik barkodlarla PDF belgeleri üreten uygulamalar — faturalar, iş emirleri, gönderi listeleri — bazen bu barkodları aşağı yönde işleme sırasında tekrar okumak zorunda kalır.BarcodeLibbarkod görüntüleri oluşturur ancak her iki taraf için PDF desteği yoktur. PDF'denBarcodeLibile barkod okumak, önce PDF'yi bir ayrı PDF kütüphanesi kullanarak görüntülere dönüştürmeyi, ardından bu görüntüleri ayrı bir okuma kütüphanesine aktarmayı gerektirir.IronBarcode tüm zinciri yerel olarak ele alır: BarcodeReader.Read("file.pdf") her sayfayı geçer ve herhangi bir ara render adımı olmadan tespit edilen tüm barkodları döndürür.

QR Kod veya Diğer 2D Sembol İhtiyacı Görünür

Başlangıçta yalnızca doğrusal barkod gerektiren projeler genellikle QR Kod, Data Matrix, PDF417 veya Aztec çıktısına ihtiyaç duyacak şekilde evrilir. BarcodeLib, 3.x serisinde herhangi bir 2D semboloji üretmez — BarcodeStandard.Type enum, QR Code veya diğer 2D girişler içermez — bu nedenle herhangi bir 2D gerekliliği, ikinci bir kütüphaneyi eklemek veya BarcodeLib'i tamamen değiştirmek anlamına gelir. IronBarcode'un QRCodeWriter ve BarcodeWriter, aynı akıcı API üzerinden QR Code (logo yerleştirme, renk kontrolü ve hata düzeltme ayarı ile), Data Matrix, PDF417 ve Aztec'i kapsar. Semboloji gereksinimleri 2D'ye doğru ilerleyen ekipler, bu açığın taşıma kararı üzerinde etkili olduğunu bulur.

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

BarcodeLib kodları bir değiştirilebilir nesne modeli kullanır: bir Barcode örneği oluşturur, özellikleri ayarlar, Encode() çağrısı yaparsınız.IronBarcode sabit bir akıcı model kullanır: BarcodeWriter.CreateBarcode() çağrısını yapın, yapılandırma metodlarını zincirleyin, bir çıktı metodu ile sonlandırın. Bir Barcode örneğini bir alan olarak saklayan veya metodlar arasında geçiren mevcut kodun yeniden yapılandırılması gerekecek. Tipik değişiklik, özellik ayarlama bloğunu bir yöntem zinciriyle değiştirmektir:

// 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'ten Doğrudan Çıkış

BarcodeLib 3.x döner SKImage, bu da bayt üretmek için bir SKEncodedImageFormat ve bir akış gerektirir. SKImage üzerine yazılmış veya image.Encode(...).SaveTo(stream) içinden geçen herhangi bir kodun güncellenmesi gerekecektir. IronBarcode'un akıcı zinciri, arzu edilen çıktı formatı ile doğrudan sonlanır — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — ara görsel nesneyi ve akışa kodlama adımına ihtiyacı ortadan kaldırarak.

Tür Enum'undan BarcodeEncoding Enum'una

BarcodeLib 3.x, PascalCase değerleriyle BarcodeStandard.Type enumunu kullanır, örneğin BarcodeStandard.Type.Code128. IronBarcode, BarcodeEncoding enumunu BarcodeEncoding.Code128 gibi değerlerle kullanır. 1D değerler doğrudan eşleşir: Code128 → Code128, Ean13 → EAN13, UpcA → UPCA, Code39 → Code39. BarcodeStandard.Type. için .cs dosyaları arasında grep, güncellenmesi gereken tüm olayları belirler.

SkiaSharp Referansı Temizleme

BarcodeLib'in NU1608 uyarılarını çözmek için yalnızca explicit <PackageReference Include="SkiaSharp"> girişleri ekleyen projeler, IronBarcode'a geçtikten sonra bu geçersiz kılmaları kaldırabilirler. dotnet list package --include-transitive komutu, SkiaSharp'ın projedeki diğer paketler tarafından hala gerekip gerekmediğini kontrol eder.