Barcode4NET Oluşturma API'si

Barcode4NET'te tam oluşturma iş akışı bir özellik ayarlayıcı deseni kullanıyordu:

//Barcode4NET— manual DLL,.NET Frameworkonly
//HayırNuGet paketi — requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

//Barcode4NET— manual DLL,.NET Frameworkonly
//HayırNuGet paketi — requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Dim barcode As New Barcode4NET.Barcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.Width = 300
barcode.Height = 100
Dim barcodeImage As Bitmap = barcode.GenerateBarcode()
barcodeImage.Save(outputPath, ImageFormat.Png)

Bu,Barcode4NETAPI yüzeyinin tam kapsamını temsil eder. Kütüphane, akıcı zincirleme sunmadı, okuma yeteneği yoktu, QR Code desteği yoktu, ve logo yerleştirme veya hata düzeltme kontrolü gibi gelişmiş 2D seçenekleri yoktu.

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

Barcode4NET Yaklaşımı

Barcode4NET, emir verici bir özellik ayarlayıcı deseni kullandı. Geliştiriciler bir Barcode nesnesi başlattı, bireysel özellikler atandı ve bir System.Drawing.Bitmap almak için GenerateBarcode() çağrıldı:

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Public Function GenerateLabel(sku As String) As Bitmap
    Dim barcode As New Barcode4NET.Barcode()
    barcode.Symbology = Symbology.Code128
    barcode.Data = sku
    barcode.Width = 400
    barcode.Height = 120
    Return barcode.GenerateBarcode()
End Function

Dönüş türü — System.Drawing.Bitmap —, çağıran kodun resmi kaydetmek, göstermek veya akışa almak için sorumlu olduğu anlamına geliyordu. Bu, bir WinForms uygulamalarında, bir Bitmap doğrudan bir PictureBox atanabilirdi, ancak başka bir çıktı hedefi için ek dönüştürme adımları gerektiriyordu.

IronBarcode Yaklaşımı

IronBarcode, akışkan bir statik API kullanır. Tek bir metod çağrısı oluşturmayı başlatır ve zincirlenebilir metodlar, terminal kaydetme veya dönüşüm metodundan önce sonucu yapılandırır:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateLabel(sku As String) As Byte()
    Return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .ToPngBinaryData()
End Function

BarcodeEncoding enum doğrudan Symbology enum ile eşleşir. .ResizeTo(), Width ve Height özellik atamalarının yerini alır. Terminal yöntemleri — .SaveAsPng(), .SaveAsJpeg(), .ToPngBinaryData() — ayrı GenerateBarcode() ve bitmap kaydetme çağrılarının yerini alır. Daha gelişmiş oluşturma senaryoları için IronBarcode barkod oluşturma belgelerine bakın.

Barcode4NET Yaklaşımı

Barcode4NET'in bir okuma API'si yoktu. Görüntülerden veya taranmış belgelerden barkodları çözmesi gereken ekipler, tamamen ayrı bir kütüphane - ya açık kaynaklı bir alternatif olan ZXing.Net ya da ticari bir tarama SDK'sı - entegre etmek zorundaydı. Sonuç, oluşturma içinBarcode4NETve okuma için ikinci bir kütüphane olmak üzere iki ayrı bağımlılık zinciriydi.

IronBarcode Yaklaşımı

IronBarcode, görüntü dosya yollarını, akış nesnelerini ve PDF belgelerini kabul eden statik bir yöntem olarak BarcodeReader.Read() sağlar:

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

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

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

Yüksek hacimli veya gürültülü görüntü senaryoları için BarcodeReaderOptions sınıfı, okuma hızı ve çoklu barkod algılama üzerinde kontrol sağlar. Yapılandırma seçenekleri için barkod okuma belgelerine bakın.

Barcode4NET Yaklaşımı

Barcode4NET,.NET Frameworkderlemelerine karşı derlendi. Windows üzerinde çalışıyor,.NET Frameworkuygulamalarında, IIS barındırılan Web Forms ve Windows Forms projelerinde çalışıyordu. Linux derlemeleri, .NET Core derlemeleri ve bulut çalışma ortamı desteği yoktu. Microsoft, .NET Core'u tanıttığında ve daha sonra platformu .NET 5+ olarak birleştirdiğinde, Barcode4NET'in karşılık gelen güncellemeleri olmadı. net5.0 veya daha yeni bir sürümü hedefleyen herhangi bir proje kütüphaneye hiç başvuramazdı.

DLL dağıtım modeli platform kısıtlamasına neden olmaktadır. Her bir derleme ortamı – geliştirici çalışma istasyonu, derleme ajanı,Dockerkonteyneri – DLL'nin bilinen bir yolda bulunmasını gerektiriyordu. Konteyner tabanlı dağıtımlarda, bu ya DLL'yi özel bir temel imaj içerisine alma ya da yapı sırasında kopyalama anlamına geliyordu, bunlardan hiçbiri standart dotnet restore iş akışları ile uyumlu değildi.

IronBarcode Yaklaşımı

IronBarcode, tek bir NuGet paketinden çoklu çerçeveyi hedefler:.NET Framework4.6.2 ile .NET 9 arasında ve Windows, Linux ve macOS üzerinde mevcut tüm .NET sürümleri.Dockerkonteynerlerine dağıtım, standart .NET çalışma ortamı imajlarını değiştirmeden kullanır. Azure Functions, AWS Lambda ve diğer sunucusuz çalışma zamanları, aynı NuGet paketi aracılığıyla desteklenir. dotnet restore komutu, manuel DLL yönetimi olmadan tüm bağımlılıkları çözer.

Barcode4NET Yaklaşımı

Barcode4NET, etkili bir şekilde ömrünü tamamlamıştır. Yeni lisanslar ComponentSource üzerinden artık satılmıyor, ancak var olan müşteriler sağlayıcının şartlarına göre ComponentSource aracılığıyla Destek ve Yazılım Güncellemeleri yenileyebilir. Bir ekipBarcode4NETkullanan bir takıma yeni bir geliştirici katıldığında, onlar için ek bir koltuk satın alma mekanizması yoktur Son kod sürümü 2007'deki 2.0 sürümüydü, bu yüzden o sürümden beri keşfedilen herhangi bir hata veya güvenlik sorunu yama ile çözülmemiştir.

IronBarcode Yaklaşımı

IronBarcode, sürekli lisanslamayla aktif olarak bakımı yapılan ticari bir üründür. Katmanlar, tek geliştirici Lite lisansı için $749'dan başlar, Plus ($1,499, 3 geliştirici), Professional ($2,999, 10 geliştirici) ve Unlimited ($5,999) katmanlar mevcuttur. Tüm katmanlar telif ücretsiz dağıtım içerir. Güvenlik yamaları, hata düzeltmeleri ve .NET sürüm uyumluluk güncellemeleri düzenli bir serbest bırakma döngüsünde sunulur. Değerlendirme için lisans anahtarı olmadan 30 günlük ücretsiz deneme mevcuttur.

Engellenen .NET Yükseltmesi

En yaygın zorlayıcı olay bir .NET modernizasyon projesidir. Bir ekip net8.0 hedefler, .csproj'da çalışır, ve Barcode4NET'in.NET Framework1.1 / 2.0 / 3.x için oluşturulmuş olması ve modern bir .NET hedefinden referans alınamaması nedeniyle yükleme hatasıyla karşılaşır. Bu noktada ekip, ikili bir seçimle karşı karşıya - hedef çerçeve değişikliğini geri almak ve.NET Frameworküzerinde kalmak ya da Barcode4NET'i değiştirmek. Göç ertelenemez çünkü daha geniş modernleştirme çabasını engelleyecektir.

Altyapı Değişikliklerinden Sonra CI/CD Hattı Arızaları

Barcode4NET'in DLL dağıtım modeli, derleme hatlarında gizli bir kırılganlık yaratır. Bir derleme ajanı yeniden sağlandığında, bir konteyner imajı güncellendiğinde veya yeni bir CI ortamı yapılandırıldığında,Barcode4NETDLL'nin proje dosyasının beklediği yolda manuel olarak yerleştirilmesi gerekmektedir. Bu adımı dikkatle belgelemeyen ekipler, sorunu yalnızca hat hattı başarısız olduğunda keşfederler. IronBarcode'a geçiş yapmak, her şeyi dotnet restore'nun hallettiği anlamına gelir — DLL konum sorunu sona erer.

Yeni Takım Üyelerine Lisans Verilemiyor

Bir yüklenici projeye katıldığında veya ikinci bir geliştirici barkod özellikleri üzerinde çalışmak istediğinde satın alınacak bir lisans yok. Ekip, bu kısıtlamayı aşmak zorundadır - ya yeni geliştirici tamamen barkod kodundan kaçınır ya da birisi orijinal şartlar altında yasal olarak devredilemeyebilir bir lisansı devreder. Her iki duruma da bir ürün geliştiren bir ekip için sürdürülebilir değildir.

Güvenlik ve Uyum Denetimleri

Malzeme Bill'i oluşturma veya ömür sonu veritabanlarına karşı bağımlılıkları kontrol eden organizasyonlar, Barcode4NET'i bir bulgu olarak karşıladı. 2007'den beri herhangi bir kod sürümü olmayan ticari bir üründür ve CVE takibi veya yama akışı yoktur. Güvenlik denetçileri, bu durumdaki bağımlılıkları tipik olarak aktif olarak bakımı yapılan kütüphanelerden farklı şekilde ele alır, ve bulgu genellikle ertelenmiş bir risk olmaktan ziyade resmi bir düzeltme maddesine dönüşür.

Mevcut Bir İş Akışına Okuma Yeteneği Ekleme

Başlangıçta Barcode4NET'i yalnızca oluşturma iş akışları için kullanan ekipler, daha sonra taranmış belgelerden barkodları doğrulamaları, kullanıcı tarafından yüklenen görüntüleri işlemeleri veya PDF faturalarından veri çıkarmaları gerektiğini keşfederler.Barcode4NETile bu, ikinci bir kütüphane entegrasyonunu gerektirir. IronBarcode'un BarcodeReader.Read()'u hem görüntüleri hem de PDF'leri yerel olarak işler, bağımlılığı tek bir bakımlı pakette birleştirir.

DLL Referansının Kaldırılması

Barcode4NET hiçbir zaman bir NuGet paketi olarak dağıtılmadığı için dotnet remove package komutu yoktur. Kütüphaneye başvuran her .csproj dosyası, diskteki DLL'ye işaret eden bir <Reference Include="Barcode4NET"> unsurunu içerir. Bu öğelerin her biri manuel olarak bulunmalı ve kaldırılmalıdır. Çözüm boyunca bir grep onları bulur:

grep -rl "Barcode4NET" --include="*.csproj" .

grep -rl "Barcode4NET" --include="*.csproj" .

Kaynak kontrolündeki DLL dizini — tipik olarak ThirdParty/Barcode4NET/ veya lib/ — git rm ile silinmek üzere hazır hale getirilmelidir.

Bitmapten Bayt Dizisine Dönüş Türü Değişikliği

Barcode4NET'in GenerateBarcode()'u bir System.Drawing.Bitmap döndürür. IronBarcode'un akışkan zinciri .ToPngBinaryData()'de sona erer, byte[] döndüren, veya doğrudan diske yazan .SaveAsPng(). Dönüş değerini bir Bitmap türünde değişkene atayan veya bir WinForms PictureBox gibi bir Bitmap bekleyen bir metoda geçiren kod, çağrı yerinde tek satırlık bir ayarlama gerektirir: bayt dizisini bir MemoryStream içine sarın ve Image.FromStream() çağrılır.

Sembololoji Enum Yeniden Adlandırma

Barcode4NET'teki Symbology enum, IronBarcode'daki BarcodeEncoding enum ile doğrudan eşleşir. Tüm yaygın değerler — Code128, Code39, EAN13, UPCA, QRCode — adlarını korur. Symbology. ile BarcodeEncoding. arasında çözüm genelinde bir bul ve değiştir işlemi çoğu durumu kapsar, ancak her değişiklik bağlamın doğrulanması için gözden geçirilmelidir.

Yapı Komut Dosyası Temizliği

Barcode4NET DLL'sini çıktı dizinlerine veya yapı ajanlarına kopyalayan yapı komut dosyaları ve CI/CD yapılandırma dosyaları güncellenmelidir. NuGet göçünden sonra, bu adımların eşdeğeri yoktur — dotnet restore tüm manuel DLL yönetiminin yerini alır. Geçişten sonra eski DLL kopyalama adımlarını yerinde bırakmak yapı hatalarına neden olmaz, ancak gelecekteki bakımcılar için kafa karışıklığı yaratan ölü bir yapılandırmayı temsil eder.