Dağılmış SDK Mimarisi

Neodynamic SDK'larını satın alan bir proje, başlangıçta iki ayrı lisans bloğunu yapılandırmalıdır. İkili LicenseOwner ve LicenseKey atamaları farklı ad alanları ve farklı sınıf adları kullanır ve hiçbir blok diğerine farkında değildir:

// Neodynamic: two products, two license configurations
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

// Neodynamic: two products, two license configurations
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

Imports Neodynamic.SDK.Barcode
Imports Neodynamic.SDK.BarcodeReader

' Neodynamic: two products, two license configurations

' Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company"
BarcodeProfessional.LicenseKey = "GEN-KEY"

' Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company"
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY"

Bu desen, her çevre boyunca — geliştirme, aşama ve üretim — tekrarlar ve her iki ürün de yükseltildiğinde veya yenilendiğinde sürdürülmelidir.

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

Neodynamic Barkod Okuyucu Yaklaşımı

Neodynamic Barcode Reader sadece lineer barkodları destekler. Okuyucuya bir 2D barkod gönderildiğinde, SDK boş veya null sonuç seti döndürür. Hiçbir istisna fırlatılmaz ve ne olduğuna dair bir hata mesajı gösterilmez. Bu SDK ile çalışan ekipler, genellikle QR kodu görüntülerine karşı okuyucuyu çağıran kodu dağıttıktan ve sonuç kümesinin daima boş olduğunu gözlemledikten sonra bu sınırlamayı keşfeder.

Neodynamic Reader kullanan kod tabanlarında yaygın bir savunma yöntemi, 2D bir format beklendiğinde bir istisna fırlatan açık bir kontrol yapısıdır:

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

Imports Neodynamic.SDK.BarcodeReader
Imports System.Drawing

Public Function ReadQrCode(imagePath As String) As String
    Using bitmap As New Bitmap(imagePath)
        Dim reader As New BarcodeReader()
        Dim results = reader.Read(bitmap)

        ' Results will be null or empty — QR codes are not recognised by this SDK
        If results Is Nothing OrElse Not results.Any() Then
            Throw New NotSupportedException("Neodynamic Barcode Reader does not support QR codes")
        End If

        Return results.First().Value
    End Using
End Function

Bu yöntem, Neodynamic Reader SDK ile yalnız başına tamamlanamaz. NotSupportedException bir geçici çözüm değildir - okuyucunun 2D girdi için gerçek yetenek sınırını yansıtır.

IronBarcode Yaklaşımı

IronBarcode, desteklenen tüm sembojileri aynı BarcodeReader.Read() çağrısı ile okur. Format, görüntü içeriğinden otomatik olarak algılanır. Bir QR kodu, bir Code 128 ve bir DataMatrix barkodu hepsinde aynı çağrı kodunu kullanır:

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

Imports IronBarCode

Public Function ReadQrCode(imagePath As String) As String
    ' QR codes, DataMatrix, PDF417 — all handled automatically
    Dim result = BarcodeReader.Read(imagePath).FirstOrDefault()
    Return If(result?.Value, Nothing)
End Function

Çağırıcı, beklenen bir format belirtmez.IronBarcode simgolojiyi tanır ve değeri döndürür. Çoklu barkod algılaması ve görüntü ön işleme dahil olmak üzere görüntü okuma seçeneklerinin tam detayları için bkz. görüntülerden barkod okuma rehberi.

Neodynamic Barcode Professional Yaklaşımı

Neodynamic'in jenerasyon API'si instance tabanlıdır. Bir BarcodeProfessional nesnesi oluşturulur, özellikleri tek tek atanır ve GetBarcodeImage(), bir System.Drawing.Image döndürmek için çağrılır. Resim daha sonra System.Drawing.Imaging.ImageFormat numaralandırması kullanılarak kaydedilir:

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

Imports Neodynamic.SDK.Barcode
Imports System.Drawing

' Configure license first
BarcodeProfessional.LicenseOwner = "Your Company"
BarcodeProfessional.LicenseKey = "YOUR-KEY"

' Build the barcode through property assignment
Dim barcode As New BarcodeProfessional()
barcode.Code = "12345678"
barcode.Symbology = Symbology.Code128
barcode.BarcodeUnit = BarcodeUnit.Pixel

' Get image and save via System.Drawing
Dim image As Image = barcode.GetBarcodeImage()
image.Save("output.png", Imaging.ImageFormat.Png)

SDK, DPI kontrolü, metin hizalaması, renk ayarları ve sessiz alan boyutlandırması dahil olmak üzere yasalar izin verdiği şekilde özelleştirme seçenekleri sunar. Bunlar, hassas fiziksel boyutların önemli olduğu baskı iş akışları için faydalıdır. Jenerasyon yeteneği kendisi tamdır; Görme taraması gerektiren kısıtlamalar, jenerasyon tarafında değil, okuma tarafındadır.

IronBarcode Yaklaşımı

IronBarcode, akıcı statik bir yaklaşım kullanır. Kodlama ve veriler BarcodeWriter.CreateBarcode() birer parametre olarak geçirilir ve çıktı formatı döndürülen nesne üzerinde bir yöntem adı olarak ifade edilir. Herhangi bir System.Drawing 'e alım gereksinimi yoktur:

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("output.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("output.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("output.png")

2D barkod oluşturma için, adanmış QRCodeWriter sınıfı QR kodlarına özgü ek seçenekler sunar:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .SaveAsPng("qrcode.png")

Boyutlandırma ve açıklama seçenekleri ile 1D sembollerinin nasıl üretileceği hakkında rehberlik için 1D barkodlar oluşturma rehberi'ne bakın. DataMatrix ve PDF417 dahil olmak üzere 2D barkod oluşturma için 2D barkodlar oluşturma rehberi'ne bakın.

Neodynamic Yaklaşımı

Neodynamic'in barkod yeteneği iki ayrı lisanslı ürüne bölünmüştür. Barcode Professional SDK üretimi kapsar ve Barcode Reader SDK okuma için kapsam sağlar. Her ürün ayrı satın alım gerektirir ve ayrı bir lisans anahtarı taşır. Her iki ürünü de satın alan bir ekip, iki LicenseOwner / LicenseKey yapılandırma bloğunu korumalı, iki ayrı yenileme tarihini takip etmeli ve sorunlar ortaya çıktığında iki ayrı destek kanalıyla ilgilenmelidir.

Barkod Profesyonel SDK, Temel sürümde tek geliştirici lisansı için yaklaşık 352 USD'den ve Ultimate sürümde yaklaşık 705 USD'den fiyatlandırılmıştır (geliştirici lisansları ComponentSource üzerinden). Barkod Okuyucu SDK ayrı bir maliyet taşır ve eski fiyatlandırma altında sağlanır — ürün hizmet sonu olarak 31 Aralık 2019'da işaretlendi. Bir proje, Neodynamic ürünleri ile herhangi bir fiyatla bu gereksinimi karşılayamayacak olan 2D okuma gerektirir; üçüncü bir kütüphane eklenmelidir. Tek bir birleşik lisansın kapsadığıların tam listesini görmek için IronBarcode desteklenen barkod formatları sayfası'ne bakın.

IronBarcode Yaklaşımı

IronBarcode, tüm barkod işlemlerini – tüm desteklenen sembolojilerde üretim ve okuma – tek bir lisans anahtarı altında kapsayan tek bir ürün olarak satılır. Ayrı bir okuma lisansı yoktur, ayrı bir jeneratör lisansı yoktur ve 2D format desteği için ek maliyet yoktur. Lisans anahtarı uygulama başlangıcında bir kez ayarlanır ve daha fazla yapılandırma gerekmez:

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

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

Imports IronBarCode

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

IronBarcode Lite, tek bir geliştirici için $749 fiyatla belirlenmiştir ve tam yetenek setini kapsar. Mevcut fiyat düzeyleri ve hacim seçenekleri için IronBarcode lisans sayfası'na bakın.

QR Kod Okuma Gereksinimleri

Ekipleri Neodynamic'ten IronBarcode'ya yönlendiren en yaygın senaryo, Barcode Professional SDK tarafından üretilen QR kodlarının Barcode Reader SDK tarafından yeniden okunamayacağının keşfedilmesidir. Ürün etiketleme sistemleri, envanter yönetim araçları veya belge takip iş akışları inşa eden ekipler genellikle üretim ve okumayı daha büyük bir sistemin ayrı aşamaları olarak uygular. Üretim önce Barcode Professional kullanılarak inşa edildiğinde, okuma komponenti denendiğinde okuyucu sınırlaması sadece belirgin hale gelir. Bu noktada, proje zaten üretim için Neodynamic'e taahhütte bulunmuştur ve 2D okuma için üçüncü bir kütüphane eklemek sürüm yönetimi karmaşıklığı yaratır ki bu birleşik bir SDK'da yoktur.

Ürün Karmaşıklığı Azaltma

Bazı takımlar belirli bir format boşluğu nedeniyle değil, kavramsal olarak tek bir yetenek olan şey için iki ayrı ürünü sürdürmenin önemsiz bir sürtüşme noktası haline gelmesi nedeniyle taşınma kararı verir. .NET veya Windows güncellemeleri uygulandığında potansiyel uyumsuzluk kaynakları olarak uygulanacak .NET yükseltme sırasında bağımlılık denetimi yapan ekipler, genellikle Neodynamic çift paket düzenlemesini bir basitleştirme fırsatı olarak görür.

PDF Barkod İşleme

İçinde barkodlar bulunan PDF belgelerini işleyen uygulamalar, her iki Neodynamic SDK'nın da aynı anda yetersiz kaldığı bir senaryo temsil eder. Ne üretim SDK'sı ne de okuma SDK'sı bir PDF dosyasını açabilir ve sayfalarından barkod değerleri çıkarabilir. Kargo manifestoları, fatura belgeleri, tıbbi kayıtlar veya barkodların PDF'lerde gömülü olduğu herhangi bir belge iş akışı üzerinde çalışan ekipler, herhangi bir okuma gerçekleşmeden önce bir ara resim çıkarma adımı uygulamak zorundadır. Bu çıkarma adımı ek bir kütüphane gerektirir, bu da projenin, tek bir IronBarcode kurulumunun ortadan kaldıracağı bir sınırlamayı aşmak için zaten üçüncü bir bağımlılık taşıdığı anlamına gelir.

Okuma ve Yazma Üzerinde Format Tutarlılığı

Barkod iş akışlarını ölçek üzerinde işleten ekipler bazen, üretim ve okuma arasında format desteğindeki tutarsızlıklar test ve doğrulama sorunlarına neden olur. Bir sistem bir amaç için QR kodları üretip başka bir amaç için farklı format türlerini okuduğunda, üreticinin desteklediği ile okuyucunun desteklediği arasındaki ayrışma, döngü testi boşlukları oluşturur. Üretim ve okuma aynı kütüphaneyi ve aynı destekli format listesini paylaştığında bir sistemi doğrulamak daha basittir. Üretilen bir barkodun başarıyla geri okunabileceğini doğrulamak, çoklu kütüphane entegrasyon testi yerine, tek bir kütüphane işlemi haline gelir.

Çift Paket Kaldırma

Neodynamic'den geçiş yapmak, her iki NuGet paketinin de kaldırılmasını gerektirir: Neodynamic.SDK.Barcode ve Neodynamic.SDK.BarcodeReader. Her iki .csproj dosyasından kaldırılmalı ve her iki karşılık gelen using komutları kaynak dosyalardan kaldırılmalıdır. Her biri için dotnet remove package çalıştırmak yeterlidir; ikisi arasında ek bir temizleme gerektirecek ortak bir bağımlılık yoktur.

Çift Lisans Yapılandırma Temizleme

Her ikisi de BarcodeProfessional ve Neodynamic.SDK.BarcodeReader.BarcodeReader için olan iki lisans yapılandırma bloğu, tek bir IronBarCode.License.LicenseKey ataması ile değiştirilir. Bu atama uygulama başlangıcında bir kez yapılır, genellikle Program.cs veya uygulamanın bağımlılık enjeksiyon açılış yolunda. Geçiş doğrulandıktan sonra Neodynamic lisans anahtarlarını saklayan herhangi bir yapılandırma dosyası veya ortam değişkenleri devre dışı bırakılabilir.

NotSupportedException Kaldırma

Geliştirme sırasında 2D okuma sınırlamasıyla karşılaşan kod tabanları, genellikle QR kodu veya DataMatrix okuma için NotSupportedException fırlatan yer tutucu yöntemler içerir. Bu yöntemler geçici çözümler değildir - yetenek mevcut olmadığı için dürüst kabulleridir. IronBarcode'a geçişten sonra, her bir yöntem gövdesi standart bir BarcodeReader.Read(imagePath) çağrısı ile değiştirilir. Özel bir işleme gerek yoktur; format otomatik olarak tespit edilir.