Accusoft BarcodeXpress ve IronBarcode: C# Barkod Kütüphanesi Karşılaştırması

Çift Anahtar Sistemi Açıklandı

BarcodeXpress, lisanslamayı kavramsal olarak iki ayrı katmana böler:

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

Imports Accusoft.BarcodeXpressSdk

Dim barcodeXpress As New BarcodeXpress()
' Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName"
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
' Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"))

SolutionName ve SolutionKey çifti, SDK'nın kendisini etkinleştirir. Kendi anahtarını ve kendi çözüm anahtarını ayrı argümanlar olarak alan UnlockRuntime çağrısı, üretim dağıtımı yeteneklerini etkinleştirir. Üretim dağıtımında tam, gizlenmemiş barkod değerleri döndürülmesi için her ikisi de geçerli ve mevcut olmalıdır.

Kod incelemesinde, bu model öngörülebilir bir soru üretir: 'UnlockRuntime'yi neden iki farklı anahtarla çağırıyoruz?' Cevap — Accusoft'un SDK lisanslaması ve dağıtım lisanslamasını ayrı ürünler olarak ve ayrı faturalandırma ile ele aldığını bilmek — API'nin kendisinden her zaman açıkça anlaşılmaz. Bu kodu ilk kurulumdan altı ay sonra sürdüren ekipler, hangi anahtarın hangi olduğunu anlamak için genellikle dokümantasyona geri dönmek zorunda kalır.

IsRuntimeUnlocked özelliği, çalışma zamanı katmanının aktif olup olmadığını kontrol etmenizi sağlar:

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

If Not barcodeXpress.Licensing.IsRuntimeUnlocked Then
    ' In this state, barcode values are partially obscured
    ' "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active")
End If

Bu kontrol, ekiplerin değerlendirme modunda çıktılarının sessizce kısmi veriler döndüğünü, bir istisna fırlatmak veya açıkça başarısız olmak yerine fark ettiklerinde eklenen korumadır.

Detayli Özellik Karsilastirmasi

BarcodeXpress Yaklaşımı

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress()

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp"
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")

        ' Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime("RuntimeKey-XXXXXX", Convert.ToInt64("98765432109876"))

        ' Guard against partial-value mode
        If Not _barcodeXpress.Licensing.IsRuntimeUnlocked Then
            Throw New InvalidOperationException("Runtime license not active — barcode values will be obscured")
        End If
    End Sub
End Class

Bu, barkod işlemi başlamadan önce iki ayrı lisans anahtarı sistemini yönetmek için tamamen var olan 15 satırlık bir kurucudur. IsRuntimeUnlocked koruyucu isteğe bağlı değildir — onsuz, hizmet, çalışma zamanı anahtarının eksik veya yanlış yapılandırıldığı herhangi bir ortamda sessizce bozuk değerler döndürecektir.

IronBarcode Yaklaşımı

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

' In Program.vb or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY"

Tam lisanslama kurulumu budur. Ayrı bir çalışma zamanı kilidi açma, çözüm adı yok, iki argümanlı UnlockRuntime çağrısı yok. Docker'da, bu bir başlatma sırasında okunan ortam değişkeni haline gelir. Bir CI/CD hatında, tek bir gizli. Bir konteyner düzenleyicide, bu bir ortama enjekte edilen bir ortam değişkenidir.

BarcodeXpress Yaklaşımı

BarcodeXpress ile okuma, bir sabit ve bir değer alan SetPropertyValue aracılığıyla okuyucunun yapılandırılmasını ve ardından sonuçları almak için Analyze() çağrısının yapılmasını içerir:

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress()
    barcodeXpress.Licensing.SolutionName = "AcmeCorp"
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"))

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath)
    barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.DataMatrixBarcode Or BarcodeType.QRCodeBarcode

    Dim results = barcodeXpress.reader.Analyze()
    Return results.Select(Function(r) r.BarcodeValue)
End Function

cycBxeSetFilename sabiti, işleyecek dosyayı belirtmenin API yoludur. Bu desen — genel bir SetPropertyValue yöntemine sabit bir değer ile birlikte bir değer geçirme — eski COM tabanlı API'lere benzer. Bir belge BarcodeTypes içinde listelenmeyen bir format içeriyorsa, bulunamayacaktır. Belge kaynakları değiştiğinde bu bir bakım yukü haline gelir.

IronBarcode Yaklaşımı

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

Imports IronBarCode

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim results = BarcodeReader.Read(imagePath)
    Return results.Select(Function(r) r.Value)
End Function

IronBarcode tüm desteklenen simgolojiler arasında formatı otomatik olarak tanımlar. Görüntüde bir Kod 128, bir QR kodu ve bir DataMatrix varsa, hiçbir yapılandırma değişikliği olmadan hepsi de sonuç koleksiyonuna geri döner. Okuma davranışı üzerinde daha fazla kontrol icin, BarcodeReaderOptions sinifi hiz, is parcacigi sayisi ve coklu barkod ayarlarini ortaya koyar.

Yerel PDF okuma, ayni metod ile de mevcuttur:

using IronBarCode;

//YerelPDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

using IronBarCode;

//YerelPDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

Imports IronBarCode

'YerelPDF support — no separate library needed
Dim results = BarcodeReader.Read("invoice-batch.pdf")

For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}")
Next

BarcodeXpress PDF'leri yerel olarak okumaz. Oncelikle her sayfayi bir görüntü olarak ayri bir kutuphane kullanarak render etmeniz, sonra bu görüntüleri BarcodeXpress okuyucusuna sunmaniz gerekiyor. Bu, bir bagimlilik ekler, bir donusum adimi ekler ve secilen PDF kutuphanesine bagli olarak ek lisans maliyeti getirir.

BarcodeXpress Yaklaşımı

BarcodeXpress örnek tabanlıdır ve reader nesnesi durumlu bir nesnedir. Paralel işlem, her thread icin bir örnek gerektirir ve her thread baglaminda tüm iki katmanli lisans başlatma tekrar edilir:

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic

Public Function ProcessBatch(imagePaths As IEnumerable(Of String)) As Dictionary(Of String, String)
    Dim results As New Dictionary(Of String, String)()

    For Each path In imagePaths
        _barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, path)
        _barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.QRCodeBarcode

        Dim barcodes = _barcodeXpress.reader.Analyze()
        If barcodes.Length > 0 Then
            results(path) = barcodes(0).BarcodeValue
        End If
    Next

    Return results
End Function

Standart Sürüm, dakikada 40 sayfa sinirini da uygular. 40 PPM'deki 100.000 belgeli bir batch, tamamlanmak icin yaklasik 41 saat surer. Profesyonel Sürüm bu siniri kaldirir, ancak daha yuksek bir geliştirici ucreti ile — zaten satin alinmis olan calisma zamani lisanslarina ek olarak.

IronBarcode Yaklaşımı

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

//IronBarcode— parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

//IronBarcode— parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.Threading.Tasks

'IronBarcode— parallel batch with thread-safe static API
Dim files = Directory.GetFiles("/incoming/scans", "*.png")
Dim allResults = New ConcurrentBag(Of String)()

Parallel.ForEach(files, Sub(file)
    Dim r = BarcodeReader.Read(file)
    For Each barcode In r
        allResults.Add($"{file}: {barcode.Value}")
    Next
End Sub)

IronBarcode'un statik yöntemleri durumsuz olduğundan, onların üzerinde Parallel.ForEach yapmak güvenlidir ve herhangi bir örnek izolasyonu gerektirmez. IronBarcode, herhangi bir fiyat katmaninda throughput siniri koymaz. Okuma performansını ayarlamak için BarcodeReaderOptions sınıfı, ReadingSpeed ve MaxParallelThreads ayarlarını sağlar:

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim results = BarcodeReader.Read("warehouse-scan.png", options)

ReadingSpeed.Balanced varsayılan. Barkodların temiz olduğu yüksek verimli hatlar için ReadingSpeed.Faster veya hasar görmüş veya düşük kontrastlı görüntüler için ReadingSpeed.Detailed kullanın.

40 PPM Duvarinin Otesindeki Olceklendirme

Standart Sürüm'un 40 sayfa dakikada limiti, bir is takimi bir yilin arsivlenmis faturalarinin gunun sonu toplu işlemi kosmaya karar verdiginde cömert gibi gelir. Bu hizda 100.000 belgeli bir batch, tamamlanmak icin yaklasik 41 saat surer. Profesyonel Sürüm'e gecis, zaten satin alinmis calisma zamani lisanslarina ek olarak, daha yuksek geliştirici koltuk maliyeti ile birlikte siniri kaldirir. Satin alma emri imzalandiktan sonra throughput sinirini kesfeden takimlar, toplam kaldirma maliyetinin başlangic tahminlerini asiri sekilde astigini bulurlar.

CI/CD Boruları Lisanslama Karmasigi

Tipik bir CI/CD kurulumu, gecici kapsayicilarda ogeleri calistirir. BarcodeXpress ile, her bir calisma ortami hem SDK anahtari cifti hem de calisma zamani kilidi acma anahtarlarini ayri sir yapmak zorunda kalir. Calisma zamani anahtari eksik ya da konfigüre edilmis ise, yapi basarili olabilir fakat entegrasyon testleri gizlenmis degerler dondurur - test borusunda dikkatlice yazilmis bir test kontrolu olmadan yakalanmasi kolay bir sessiz hatadir.

Izole ve Guvenli Kurulum Gereksinimleri

Bazi ortamlarda - hasta kayitlari isleyen saglik sistemleri, devlet belge işlemleri, finans kurumu arka ofis işlemleri - lisans doğrulamasi dis ağ cagrilari yapamaz. BarcodeXpress'in calisma zamani lisans sistemi, Accusoft'un lisans altyapisini icerir ve sıkı ağ cikis kisitlamalari olan ortamlarda uyum endisesi olabilir. Bu ortamlarda calisan ekipler genellikle lisans doğrulamasinin tamamen yerel oldugu kutuphaneler secmektedir.

Docker ve Konteyner Kurulum

Docker'da BarcodeXpress genellikle ya bilinen bir yolda konteynere bir lisans dosyasi montajini veya bir lisans sunucusu konfiguresini ve konteyneri ona yonlendirmeyi gerektirir. Her iki yaklasim da kurulum karmasikligini arttirir — lisans dosyalari dağıtilmali ve senkronize tutulmali, ve bir lisans sunucusu bakimi gereken ek bir altyapı parcasidir. Mikroservice mimarilerine veya sunucusuz kurulum modellerine gecen takimlar, konfigürasyon dosyasi yaklasimının degismez konteyner görüntülerine temiz bir sekilde aktarilmadigini gorurler.

Degerlendirme Dogrulugui Gereksinimleri

Satin almaya baglamadan once kendi belgelerinin okuma dogrulugunu kontrol etmesi gereken takimlar, BarcodeXpress'in degerlendirme modunu esasen kisitlayici bulurlar. Gerçek dunya belge taramalarina karsi test yapmak — kutuphanenin dusuk kontrastli barkodlari, egik görüntüleri ya da çok barkodlu sayfalari işleyip işlemedigini kontrol etmek — tam kodlanmis degerler gerektirir. Kismi gizlenmis cıktı, kutuphanin bir barkod buldugunu, fakat dogru okuyup okumadigini göstermektedir.

Örnek Yonetimden Statik Cagrılara

BarcodeXpress, herhangi bir işlemden önce bir BarcodeXpress örneğinin oluşturulmasını ve lisanslanmasını gerektirir. IronBarcode'un statik metotlarına örnek gerekmez. Genellikle geçiş yapan ekipler, yapıcısı büyük ölçüde lisanslama şablonu olan bir BarcodeService sınıfına sahiptir — geçişten sonra, o yapıcı tamamen kaldırılabilir veya tek bir lisans anahtarı atamasına indirilebilir.

BarcodeTypes Enumeration Kaldırılması

Her BarcodeXpress okuma işlemi, aranacak sembolojilerin numaralandırılmasını sağlamak için bir BarcodeTypes bayrak ataması gerektirir.IronBarcodevarsayilan olarak tüm desteklenen formatlari oto-tespit eder. Geçiş sırasında, tüm reader.BarcodeTypes = ... atamaları yedeklemeden silinebilir. Arama alanını sınırlamak için bir performans nedeni varsa, BarcodeReaderOptions, gerekli bir varsayılan yerine açık bir tercih olarak format filtrelemeyi destekler.

Sonuc Ozelligi Isim Değişiklikleri

İki özellik yeniden adlandırması tüm sonuç işleme kodunu etkiler: result.BarcodeValue, result.Value haline gelir ve result.BarcodeType, result.Format haline gelir. Cozum capinda bir arama ve değiştirme bunlarin her ikisini de isler.IronBarcodesonuçları ayrıca harici sonuç işleme kodlarına değişiklik yapmadan ek filtreleme için kullanılabilecek, BarcodeXpress karşılığı olmayan result.Confidence ve result.PageNumber ortaya çıkarır.

Docker Lisans Konfigürasyonu

BarcodeXpress Docker kurulumlari genellikle monte edilmiş bir lisans konfigürasyon dosyası kullanir.IronBarcodebir ortam degiskeni kullanir. Geçiş, yapılandırma dosyası için COPY talimatının kaldırılmasını ve tek bir ortam değişkeni atanmasını içerir. Kubernetes'te, lisans anahtari bir montaji acma hacmi yerine pod spec icinde gizli bir referans olur.