Platformve Bakım Kayıtları

MessagingToolkit.Barcode için NuGet paket metadatası, hedeflerini belgeler. Aşağıdaki tablodaki her giriş, kütüphanenin geliştirilme döneminde mevcut veya yakın olan bir platformu temsil eder:

Kütüphane, .NET Core, .NET 5, .NET 6, .NET 7, .NET 8 veya .NET 9 için uygun hedef çerçevesi yoktur. Bu çalıştırma zamanlarını hedefleyen projeler, paket uygun bir çerçeve ünvanı çözümleyemediğinde derleme zaman hatası ile karşılaşacak — çalıştırma zaman uyarısı değil, derleme hatası.

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

MessagingToolkit.Barcode Yaklaşımı

MessagingToolkit.Barcode, yalnızca .NET Framework 3.5, 4.0 ve 4.5'i hedefler. .NET Standard monokenesi yoktur,.NET Corehedefi yoktur ve modern çalıştırma zamanları için uyumluluk shed'i yoktur. Bir proje dosyası, bu paketi referans aldığında ve herhangi bir modern .NET sürümünü hedeflediğinde, NuGet geri yükleme işlemi bir çerçeve uyumluluk hatası ile başarısız olur — derleme devam etmez.

NuGet metadata'sındaki platform tablosu bunu somut hale getirir. Silverlight 3, 4 ve 5 hedef listeledir; her üçü de 2021'den beri durdurulmuştur. Windows Phone 7.0, 7.5, 7.8 ve 8.0 listelenmiştir; tüm bu sürümler 2014 ile 2017 arasında destek sonuna ulaşmıştır. Kalan hedefler — .NET Framework 3.5, 4.0 ve 4.5 — teknik olarak Windows'ta çalışır durumda kalır ama Microsoft tarafından sadece güvenlik yamaları alır, yeni bir özellik geliştirme yoktur.

Pratik sonuç, MessagingToolkit.Barcode'un çerçeve yükseltmesini engellemesidir. net472 hedefleyen ve bu pakete referans veren bir proje dosyası, paketi kaldırmadan net8.0 olarak değiştirilemez. Paket sadece eski değildir — modern bir hedef çerçeve kısaltmasının yokluğunda, projenin modern .NET yeteneklerine Erişimini sağlamasına izin verecek şekilde hedef çerçeve değişikliğine engel olur.

Desteklenen çerçevelerin ve dağıtım hedeflerinin tam listesini görmek için IronBarcode platform dokümantasyonunu inceleyin.

IronBarcode Yaklaşımı

IronBarcode, .NET Framework 4.6.2'den .NET 9'a kadar destekler, hem eski Windows uygulamalarını hem de modern çapraz platform dağıtımlarını kapsar. Tek bir NuGet paketi, ayrı grafik kütüphaneleri veya platforma özgü yapılandırma gerektirmeden tüm desteklenen platformlarda kurulur.

Çapraz platform desteği pratikte anlamlıdır. IronBarcode'un dahili görüntü hattı, .NET 6'da yalnızca Windows ile çalışan System.Drawing'e bağımlı değildir. Linux veya macOS'u hedefleyen uygulamalar — Docker kapsayıcılarında, Azure Uygulama Hizmeti Linux'ta veya AWS Lambda'da çalışanlar dahil — Windows dağıtımlarıyla aynıIronBarcode API'sini ve davranışını kullanır.

MessagingToolkit.Barcode Yaklaşımı

MessagingToolkit.Barcode ile okuma, bir BarcodeDecoder örneği oluşturmayı, resim dosyasından bir Bitmap oluşturmayı, bit eşlemcisini .Decode()'ye geçirmeyi ve .Text'ye erişmeden önce sonucu nul olup olmadığını kontrol etmeyi gerektirirdi. Oluşturma aynı nesne desenini takip ediyordu: bir BarcodeEncoder oluşturun, .Format özelliğini ayarlayın, bir Bitmap almak için .Encode() çağırın, sonra o bit eşlemi üzerinde .Save() çağırın.

// MessagingToolkit.Barcode — .NET Framework target frameworks
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

// MessagingToolkit.Barcode — .NET Framework target frameworks
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

Imports MessagingToolkit.Barcode
Imports System.Drawing

' Reading
Dim barcodeReader As New BarcodeDecoder()
Dim bitmap As New Bitmap("barcode.png")
Dim result = barcodeReader.Decode(bitmap)
Dim value As String = result?.Text
Dim format As String = result?.BarcodeFormat.ToString()

' Writing
Dim barcodeWriter As New BarcodeEncoder()
barcodeWriter.Format = BarcodeFormat.QrCode
Dim outputBitmap = barcodeWriter.Encode("Hello World")
outputBitmap.Save("output.png")

Bitmap bağımlılığı rastgele değildir. System.Drawing.Bitmap Windows'ta GDI+ gerektirir. .NET 6 ve sonrasında, Linux veya macOS üzerinde System.Drawing kullanmaya çalışmak, çalışma zamanında bir PlatformNotSupportedException oluşturur. Mesajlaşma Aracı.Barcode montajı modern bir .NET projesinde yüklenebilseydi — kayıp çerçeve hedefi yüzünden olamaz — Bitmap bağımlılığı, platformlar arası dağıtımı her durumda engellerdi.

IronBarcode Yaklaşımı

IronBarcode genel olarak statik yöntemler kullanır. BarcodeReader.Read(), bir dosya yolu, bir Stream, bir bayt dizisi veya bir PDF dosya yolu kabul eder — Bitmap gerekmez. Sonuç, tek bir nullable nesne değil, bir koleksiyondur. Oluşturma, parametre olarak şifreleme türünü geçirerek BarcodeWriter.CreateBarcode() kullanır ve sonuç nesnesi doğrudan saklama yöntemlerini kullanıma sunar.

//IronBarcode— .NET Framework 4.6.2 through .NET 9
using IronBarCode;

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

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

//IronBarcode— .NET Framework 4.6.2 through .NET 9
using IronBarCode;

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

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

Imports IronBarCode

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

' Reading
Dim results = BarcodeReader.Read("barcode.png")
Dim value As String = results.FirstOrDefault()?.Value
Dim format As String = results.FirstOrDefault()?.Format.ToString()

' Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode) _
    .SaveAsPng("output.png")

Görüntülerden barkod okuma hakkında detaylı rehber için görüntülerden barkod okuma nasıl yapılır görülebilir. Code 128, EAN-13 ve UPC formatları dahil olmak üzere 1D barkodlar oluşturma hakkında bilgi için 1D barkodlar nasıl oluşturulur adresini inceleyin.

MessagingToolkit.Barcode Yaklaşımı

MessagingToolkit.Barcode, Nisan 2013'ten bu yana güncelleme almamıştır. O tarih sonrası keşfedilen herhangi bir güvenlik açığı — kütüphanenin kendi görüntü ayrıştırma mantığında, ZXing türevlerinde çözümleme uygulamasında veya transitif bağımlılıklarında — yamalanmamış olarak kalıyor. Bildirilmesi gereken bir kamu bakımcısı yok, takip edilecek bir güvenlik danışmanlığı süreci yok ve geliştirilse bile kullanıcılarına ulaşmasını sağlayacak bir sürüm mekanizması yok.

Güvenlik tarama araçları — Snyk, WhiteSource, GitHub Dependabot, NuGet denetimi — genellikle bakımı yapılmayan paketleri artırılmış risk olarak işaretler. İşaretleme, doğrulanmış bir CVE'ye dayalı değildir; doğrulanmış güvenlik açıklarının düzeltilmesini sağlayacak herhangi bir sürecin eksikliğini yansıtır. Bu, aktif bir bakımcısı ve belgelenmiş bir güvenlik yanıt süreci olan bir kütüphaneden farklı bir risk profili.

UYUM çerçeveleri altında faaliyet gösteren ekipler — PCI DSS, HIPAA, SOC 2, ISO 27001 — için bunun pratik denetim sonuçları vardır. Bu çerçeveler, üçüncü taraf yazılımların aktif yama yönetimini bekler ve güvenlik açıkları için yanıt mekanizması olmayan bakımı yapılmayan bir paket, belirli bir CVE buna karşı başvuru yapılıp yapılmadığına bakılmaksızın denetim incelemesi sırasında genellikle işaretlenir. Bulgular, bilinen bir açığın varlığından çok bağımlılığın bakım duruşu ile ilgilidir.

IronBarcode Yaklaşımı

IronBarcode, güvenlik yamaları, bağımlılık güncellemeleri ve yeni işlevler kapsamında düzenli NuGet güncellemeleri alır. Kütüphane, destek sürecini belgeleyen ve her güncelleme için sürüm notları yayınlayan Iron Software tarafından geliştirilmiştir. Güvenlik danışmanlıkları uygulandığında, yama sürümlerinde ele alınır.

IronBarcode, MessagingToolkit.Barcode'un işlediği tüm formatlar dahil olmak üzere 50'den fazla barkod formatı destekler — QR Code, Code 128, EAN-13, EAN-8, UPC-A ve diğerleri — eski kütüphanenin asla desteklemediği formatların yanı sıra: DataMatrix, Aztec, PDF417 ve modern 2D simgolojilerin tam aralığı.

Çerçeve Modernleştirme Gereksinimleri

En yaygın tetikleyici planlanmış veya devam eden bir .NET yükseltmesidir. Bir ekip, bir projeyi .NET Framework 4.x'den .NET 6 veya daha yeni bir sürüme taşımaya karar verdiğinde, modern çerçeve desteği olmayan paketler için bağımlılık grafiği denetlenmelidir. MessagingToolkit.Barcode, modern bir hedef çerçeve monikerine karşı çözülemeyen engelleyici bir bağımlılık olarak bu denetimde görünecektir. IronBarcode'a geçiş, bu nedenle daha geniş .NET yükseltmesi için bir ön koşul olup, ayrı bir girişim değildir. Uygulama modernizasyonunu üstlenen ekipler, bu bağımlılığı tipik olarak yükseltme analizinin erken aşamasında keşfederler.

Güvenlik ve Uyum Yükümlülükleri

İkinci bir senaryo güvenlik incelemelerini ve uyum denetimlerini içerir. PCI DSS, HIPAA, SOC 2 veya ISO 27001 çerçeveleri altında faaliyet gösteren ekipler, üçüncü taraf bağımlılık sağlığını inceleyen periyodik denetimlere tabi olurlar. Yanıt mekanizması olmayan bakımı yapılmayan bir paket, işlem gerekçeleri üzerinde bir denetim bulgusu olarak ortaya çıkma eğilimindedir, belirli bir güvenlik açığı tespit edilip edilmediğinden bağımsız olarak. Bir güvenlik ekibi, MessagingToolkit.Barcode'u uygun olmayan bir bağımlılık olarak işaretlediğinde, çözüm yedeklemedir — uygulanacak bir yama yok, yükseltilecek bir sürüm yok ve bir güvenlik danışmanlığı için iletişim kurulacak bir bakımcı yok. IronBarcode'a geçiş, bir bakım yolu olmayan bir bağımlılığı düzenli güvenlik güncellemeleri alan bir bağımlılıkla değiştirerek denetim bulgusunu ele alır.

Yetkinlik Genişletme

Üçüncü bir senaryo, yeni gereksinimlerin MessagingToolkit.Barcode'un sunabileceğinin ötesine geçtiğinde ortaya çıkar. Taralı belgeleri veya PDF dosyalarını işleyen uygulamalar, bu formatlardan barkod okumasına ihtiyaç duyar — MessagingToolkit.Barcode yalnızca bitmap girdileri kabul ettiğinden PDF okuma, ayrı bir çıkarım katmanı olmadan mümkün değildir. Web iletimine yönelik barkod üreten uygulamalar SVG veya base64 çıktısına ihtiyaç duyar — MessagingToolkit.Barcode bir Bitmap döndürdü, ek dönüştürme adımları ve System.Drawing.Imaging bağımlılığı gerektirirdi. Ürün gereksinimleri bu alanlara genişlediğinde, eski kütüphanenin sınırlandırmaları mühendislik kısıtlamaları haline gelir ve API yüzeyi içinde çözülemez.

PlatformHedef Büyümesi

Dördüncü bir senaryo, yeni dağıtım hedeflerinin eklenmesidir. Başlangıçta yalnızca Windows uygulamaları geliştiren ve Linux barındırma, macOS geliştirme ortamları, Docker kapsayıcıları veya Linux çalışma zamanlarındaki bulut işlevlerine genişleyen ekipler, bir engelleyici sorun olarak System.Drawing bağımlılığı ile karşılaşır. MessagingToolkit.Barcode, tüm giriş ve çıkış işlemleri için System.Drawing.Bitmap gerektirir ve System.Drawing, .NET 6 ve üstünde yalnızca Windows'ta çalışır. Windows olmayan herhangi bir dağıtım hedefi bu bağımlılığı bir çalışma zamanı hatası haline getirir, sadece bir uyumluluk sorunu değil. IronBarcode'a geçiş, ekibin sağlamaya çalıştığı platformlar arası dağıtımı etkinleştirerek, System.Drawing gerekliliğini tamamen ortadan kaldırır.

Ad Alanı Değiştirme

using MessagingToolkit.Barcode; içeren her dosya, using IronBarCode; için bir güncelleme gerektirir. Eski isim alanı dizesi için tüm kod tabanında arama yapmak, geçiş kapsamını belirlemenin en güvenilir başlangıç ​​noktasıdır. System.Drawing'i yalnızca MessagingToolkit.Barcode ile kullanılan Bitmap türü için içe aktaran dosyalar,IronBarcode devrede olduğunda bu içe aktarmayı tamamen kaldırabilir, çünkü IronBarcode buna ihtiyaç duymaz.

Hedef Çerçeve Değişikliği

Proje dosyasından MessagingToolkit.Barcode'u kaldırmak, hedef çerçeve monikerinin güncellenmesini mümkün kılar. Engelleyici bağımlılık kaldırıldığında, <TargetFramework>net472</TargetFramework> değişikliği <TargetFramework>net8.0</TargetFramework> olarak mümkündür. IronBarcode, bu değişimin her iki tarafını da destekler — .NET Framework 4.6.2 ile .NET 8 ile uyumludur — bu nedenle, çerçeve yükseltmesi tamamlanmadan önce yüklenebilir ve tek bir adımda değil, geçişli bir geçişe izin verir.

BarcodeWriter İsim Alanı Farklılıkları

MessagingToolkit.Barcode, oluşturma sınıfı olarak BarcodeEncoder kullandı, biçim olarak bir özellik (barcodeWriter.Format = BarcodeFormat.QrCode) ayarlandıktan sonra .Encode() çağrılır.IronBarcodeBarcodeWriter.CreateBarcode() parametre olarak şifreleme türünü geçirerek statik bir yöntem olarak kullanır. Sıralama adları farklıdır: BarcodeFormat.QrCode, BarcodeEncoding.QRCode olur ve BarcodeFormat.Code128, BarcodeEncoding.Code128 olur. CreateBarcode() sonucu, .SaveAsPng(), .SaveAsJpeg(), .SaveAsSvg() ve diğer çıkış yöntemleri ile akıcı bir nesnedir — bir Bitmap döndürmez.