Temel Sorun

LEADTOOLS başlatma dizisi bir BarcodeEngine oluşturulmadan önce 20+ satır ve dört doğrulama adımı gerektirir. IronBarcode, tüm diziyi tek bir atama ile değiştirir:

// LEADTOOLS: file path, expiry check, three feature lock checks, engine creation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

// LEADTOOLS: file path, expiry check, three feature lock checks, engine creation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

Imports Leadtools
Imports Leadtools.Barcode

' LEADTOOLS: file path, expiry check, three feature lock checks, engine creation
RasterSupport.SetLicense("C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC", "your-developer-key-here")

If RasterSupport.KernelExpired Then
    Throw New InvalidOperationException("LEADTOOLS license has expired")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) Then
    Throw New InvalidOperationException("2D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) Then
    Throw New InvalidOperationException("Barcode writing is locked")
End If

Dim engine As New BarcodeEngine()

// IronBarcode: one line, no file required
using IronBarCode;

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

// IronBarcode: one line, no file required
using IronBarCode;

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

Imports IronBarCode

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

Adım 1:LEADTOOLSPaketlerini Kaldırın

Projeden tümLEADTOOLSpaketlerini kaldırın:

dotnet remove package Leadtools.Barcode
dotnet remove package Leadtools
dotnet remove package Leadtools.Codecs
dotnet remove package Leadtools.Codecs.Png
dotnet remove package Leadtools.Codecs.Jpeg

dotnet remove package Leadtools.Barcode
dotnet remove package Leadtools
dotnet remove package Leadtools.Codecs
dotnet remove package Leadtools.Codecs.Png
dotnet remove package Leadtools.Codecs.Jpeg

Barkod çıkarımı için PDF codec eklendiyse:

dotnet remove package Leadtools.Pdf

dotnet remove package Leadtools.Pdf

Windows Server dağıtımlarında, geçiş tamamlandıktan sonra MSVC++ 2017 Runtime sağlama betiklerinden kaldırılabilir.IronBarcode herhangi bir platformda yerel çalışma zamanı bağımlılığı gerektirmez.

2. Adım: IronBarcode'u Kurun

dotnet add package IronBarcode

dotnet add package IronBarcode

Bu tek paket, tüm görüntü formatı desteği, yerel PDF barkod çıkarımı, ML hata düzeltmesi ve desteklenen50+semboji içerir. Ek codec paketleri gerekli değildir.

3. Adım: Lisansı Başlatma

LEADTOOLS başlatma bloğunu tek bir satırla değiştirin. Kod tabanında RasterSupport.SetLicense'e yapılan her çağrıyı bulun — tipik olarak uygulama başlangıcında tam olarak bir tane olacaktır — ve çevresindeki tüm başlatma dizisini değiştirin:

// Before: entireLEADTOOLSinitialization block (20+ lines)
// After:
using IronBarCode;

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

// Before: entireLEADTOOLSinitialization block (20+ lines)
// After:
using IronBarCode;

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

Imports IronBarCode

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

Lisans anahtarı, herhangi bir dizgi yeteneğine sahip yapılandırma mekanizmasından elde edilebilir: bir ortam değişkeni, appsettings.json, Azure Key Vault, AWS Secrets Manager veya bir Kubernetes sırrı. Ortam tabanlı lisans yapılandırması, Docker dağıtım desenleri ve desteklenen tüm yapılandırma yaklaşımları için, lisans anahtar kurulumu dokümantasyonuna bakın.

Görüntülerden Barcode Okuma

LEADTOOLS, görüntü yüklemeyi barkod taramadan iki ayrı obje katmanına ayırır. Bir RasterCodecs örneği görüntü dosyasını RasterImage içine yükler ve bir BarcodeEngine örneği onu tarar. Arayan kişi ayrıca BarcodeSymbology değerlerinin açık bir dizisini sağlamak zorundadır. dizide listelenmeyen formatlar algılanmayacaktır.

LEADTOOLS Yaklaşımı:

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load("scan.png");

var engine = new BarcodeEngine();

var symbologies = new[]
{
    BarcodeSymbology.Code128,
    BarcodeSymbology.Code39,
    BarcodeSymbology.QR,
    BarcodeSymbology.DataMatrix,
    BarcodeSymbology.EAN13,
    BarcodeSymbology.UPCA
};

var barcodes = engine.Reader.ReadBarcodes(
    image,
    LogicalRectangle.Empty,
    0,
    symbologies);

foreach (var barcode in barcodes)
    Console.WriteLine($"{barcode.Symbology}: {barcode.Value}");

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load("scan.png");

var engine = new BarcodeEngine();

var symbologies = new[]
{
    BarcodeSymbology.Code128,
    BarcodeSymbology.Code39,
    BarcodeSymbology.QR,
    BarcodeSymbology.DataMatrix,
    BarcodeSymbology.EAN13,
    BarcodeSymbology.UPCA
};

var barcodes = engine.Reader.ReadBarcodes(
    image,
    LogicalRectangle.Empty,
    0,
    symbologies);

foreach (var barcode in barcodes)
    Console.WriteLine($"{barcode.Symbology}: {barcode.Value}");

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim codecs As New RasterCodecs()
Using codecs
    Dim image = codecs.Load("scan.png")
    Using image
        Dim engine As New BarcodeEngine()

        Dim symbologies = New BarcodeSymbology() {
            BarcodeSymbology.Code128,
            BarcodeSymbology.Code39,
            BarcodeSymbology.QR,
            BarcodeSymbology.DataMatrix,
            BarcodeSymbology.EAN13,
            BarcodeSymbology.UPCA
        }

        Dim barcodes = engine.Reader.ReadBarcodes(
            image,
            LogicalRectangle.Empty,
            0,
            symbologies)

        For Each barcode In barcodes
            Console.WriteLine($"{barcode.Symbology}: {barcode.Value}")
        Next
    End Using
End Using

IronBarcode Yaklaşımı:

using IronBarCode;

var results = BarcodeReader.Read("scan.png");

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

using IronBarCode;

var results = BarcodeReader.Read("scan.png");

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

Imports IronBarCode

Dim results = BarcodeReader.Read("scan.png")

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

IronBarcode, dosya yolunu doğrudan kabul eder, görüntüyü dahili olarak yükler ve çağrı yapanın beklenen türleri belirlemesini gerektirmeden, desteklenen tüm50+sembolojilerde formatları otomatik algılar. Gelişmiş yapılandırma için — okuma hızını ayarlama, çoklu barkod algılama ve düşük kaliteli görüntü işleme — görüntülerden barkod okuma kılavuzuna bakın.

Bir Code 128 Barkodu Oluşturma

LEADTOOLS üretimi bir BarcodeData nesnesi oluşturmayı, belirli bellek bayrakları, piksel derinliği ve bayt sırasıyla boş bir RasterImage ayırmayı, görüntüyü bir arka plan rengiyle doldurmayı, barkodu ona yazmayı ve ardından RasterCodecs ile kaydetmeyi gerektirir. IronBarcode, bu adımların tümünü tek bir akıcı yöntem zinciriyle gerçekleştirir.

LEADTOOLS Yaklaşımı:

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData()
{
    Symbology = BarcodeSymbology.Code128,
    Value = "ITEM-98765",
    Bounds = new LeadRect(0, 0, 500, 120)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    500, 120, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, barcodeData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, "item-barcode.png", RasterImageFormat.Png, 0);

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData()
{
    Symbology = BarcodeSymbology.Code128,
    Value = "ITEM-98765",
    Bounds = new LeadRect(0, 0, 500, 120)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    500, 120, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, barcodeData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, "item-barcode.png", RasterImageFormat.Png, 0);

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim engine As New BarcodeEngine()

Dim barcodeData As New BarcodeData() With {
    .Symbology = BarcodeSymbology.Code128,
    .Value = "ITEM-98765",
    .Bounds = New LeadRect(0, 0, 500, 120)
}

Using image As New RasterImage(
    RasterMemoryFlags.Conventional,
    500, 120, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    Nothing, IntPtr.Zero, 0)

    Dim fillCommand As New FillCommand(RasterColor.White)
    fillCommand.Run(image)
    engine.Writer.WriteBarcode(image, barcodeData, Nothing)

    Using codecs As New RasterCodecs()
        codecs.Save(image, "item-barcode.png", RasterImageFormat.Png, 0)
    End Using
End Using

IronBarcode Yaklaşımı:

using IronBarCode;

BarcodeWriter.CreateBarcode("ITEM-98765", BarcodeEncoding.Code128)
    .ResizeTo(500, 120)
    .SaveAsPng("item-barcode.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("ITEM-98765", BarcodeEncoding.Code128)
    .ResizeTo(500, 120)
    .SaveAsPng("item-barcode.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("ITEM-98765", BarcodeEncoding.Code128) _
    .ResizeTo(500, 120) _
    .SaveAsPng("item-barcode.png")

Boyutlandırma, stil ayarlama, kenar boşluğu kontrolü ve desteklenen çıktı formatlarıyla ilgili tam bir geçiş için barkod görüntüleri oluşturma kılavuzuna başvurun.

Logo Markası ile QR Kodu Oluşturma

LEADTOOLS QR kodu oluşturma, diğer barkod türleri gibi aynı çok adımlı RasterImage oluşturma modelini izler. IronBarcode, bir QR kodunun merkezine logo yerleştirmek için özel bir AddBrandLogo yöntemi ile QRCodeWriter sağlar.

LEADTOOLS Yaklaşımı:

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var qrData = new BarcodeData()
{
    Symbology = BarcodeSymbology.QR,
    Value = "https://example.com/product/12345",
    Bounds = new LeadRect(0, 0, 400, 400)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 400, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, qrData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, "product-qr.png", RasterImageFormat.Png, 0);

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var qrData = new BarcodeData()
{
    Symbology = BarcodeSymbology.QR,
    Value = "https://example.com/product/12345",
    Bounds = new LeadRect(0, 0, 400, 400)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 400, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, qrData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, "product-qr.png", RasterImageFormat.Png, 0);

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim engine As New BarcodeEngine()

Dim qrData As New BarcodeData() With {
    .Symbology = BarcodeSymbology.QR,
    .Value = "https://example.com/product/12345",
    .Bounds = New LeadRect(0, 0, 400, 400)
}

Using image As New RasterImage(
    RasterMemoryFlags.Conventional,
    400, 400, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    Nothing, IntPtr.Zero, 0)

    Dim fillCommand As New FillCommand(RasterColor.White)
    fillCommand.Run(image)
    engine.Writer.WriteBarcode(image, qrData, Nothing)

    Using codecs As New RasterCodecs()
        codecs.Save(image, "product-qr.png", RasterImageFormat.Png, 0)
    End Using
End Using

IronBarcode Yaklaşımı:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/12345", 400, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("brand-logo.png")
    .SaveAsPng("product-qr.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/12345", 400, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("brand-logo.png")
    .SaveAsPng("product-qr.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com/product/12345", 400, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .AddBrandLogo("brand-logo.png") _
    .SaveAsPng("product-qr.png")

PDF Belgelerinden Barkod Çıkarma

LEADTOOLS PDF barkod çıkarma, ayrı bir Leadtools.Pdf paketi, açık PDF yükleme yapılandırması, manuel bir sayfa sayısı sorgusu ve her sayfa üzerinde bir döngü gerektirir. Her sayfa tarama öncesi bireysel olarak bir RasterImage olarak yüklenmelidir. IronBarcode, temel paket içinde PDF desteği sunar ve sayfa yinelemesini dahili olarak ele alır.

LEADTOOLS Yaklaşımı:

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

// Requires: dotnet add package Leadtools.Pdf
using var codecs = new RasterCodecs();
codecs.Options.Pdf.Load.Resolution = 300;
codecs.Options.Pdf.Load.DisplayDepth = 24;

var engine = new BarcodeEngine();
var results = new List<string>();
int pageCount = codecs.GetTotalPages("shipment.pdf");

for (int page = 1; page <= pageCount; page++)
{
    using var image = codecs.Load(
        "shipment.pdf", 0,
        CodecsLoadByteOrder.BgrOrGray,
        page, page);

    var barcodes = engine.Reader.ReadBarcodes(
        image, LogicalRectangle.Empty, 0, null);

    foreach (var barcode in barcodes)
        results.Add($"Page {page}: {barcode.Value}");
}

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

// Requires: dotnet add package Leadtools.Pdf
using var codecs = new RasterCodecs();
codecs.Options.Pdf.Load.Resolution = 300;
codecs.Options.Pdf.Load.DisplayDepth = 24;

var engine = new BarcodeEngine();
var results = new List<string>();
int pageCount = codecs.GetTotalPages("shipment.pdf");

for (int page = 1; page <= pageCount; page++)
{
    using var image = codecs.Load(
        "shipment.pdf", 0,
        CodecsLoadByteOrder.BgrOrGray,
        page, page);

    var barcodes = engine.Reader.ReadBarcodes(
        image, LogicalRectangle.Empty, 0, null);

    foreach (var barcode in barcodes)
        results.Add($"Page {page}: {barcode.Value}");
}

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

' Requires: dotnet add package Leadtools.Pdf
Using codecs As New RasterCodecs()
    codecs.Options.Pdf.Load.Resolution = 300
    codecs.Options.Pdf.Load.DisplayDepth = 24

    Dim engine As New BarcodeEngine()
    Dim results As New List(Of String)()
    Dim pageCount As Integer = codecs.GetTotalPages("shipment.pdf")

    For page As Integer = 1 To pageCount
        Using image = codecs.Load("shipment.pdf", 0, CodecsLoadByteOrder.BgrOrGray, page, page)
            Dim barcodes = engine.Reader.ReadBarcodes(image, LogicalRectangle.Empty, 0, Nothing)

            For Each barcode In barcodes
                results.Add($"Page {page}: {barcode.Value}")
            Next
        End Using
    Next
End Using

IronBarcode Yaklaşımı:

using IronBarCode;

var results = BarcodeReader.Read("shipment.pdf");

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

using IronBarCode;

var results = BarcodeReader.Read("shipment.pdf");

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

Imports IronBarCode

Dim results = BarcodeReader.Read("shipment.pdf")

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

Docker Dağıtımı

LEADTOOLS Docker dağıtımını tanımlayan dosya yönetimi gereksinimi, IronBarcode'a geçiş yapıldığında tamamen ortadan kalkar.

LEADTOOLS Yaklaşımı:

FROM mcr.microsoft.com/dotnet/aspnet:8.0

WORKDIR /app
COPY publish/ .

# License file must be physically present in the container image
COPY LEADTOOLS.LIC /app/license/LEADTOOLS.LIC

ENV LEADTOOLS_LICENSE_PATH=/app/license/LEADTOOLS.LIC
ENV LEADTOOLS_DEVELOPER_KEY=your-developer-key

ENTRYPOINT ["dotnet", "YourApp.dll"]

IronBarcode Yaklaşımı:

FROM mcr.microsoft.com/dotnet/aspnet:8.0

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

ENTRYPOINT ["dotnet", "YourApp.dll"]

Lisans anahtarı, Docker sırları, Kubernetes sırları veya herhangi bir ortam değişkeni mekanizması aracılığıyla konteyner çalışma zamanında enjekte edilir. Herhangi bir dosya sağlama adımı gerekli değildir. Docker ve Linux dağıtım kılavuzu, Alpine ve Debian tabanlı görüntüler, çok aşamalı derlemeler ve Kubernetes dağıtım desenlerini kapsar.

Sorun 1: .LIC Dosyası Referansları CI/CD'de

LEADTOOLS:LEADTOOLSuygulamalarını derleyen veya dağıtan CI/CD boru hatları, .LIC dosyasını sağlamalıdır — kaynak kontrole ekleyerek, bir base64 sırrından kod çözerek veya bir hacim eseri olarak monte ederek. Uygulamayı çalıştıran her bir hat aşaması dosyaya erişilebilir olmalıdır.

Çözüm: Tüm .LIC dosya işlemlerini boru hattından çıkartın. Bir dizgi sırrı ile değiştirin:

# Example: GitHub Actions environment variable
env:
  IRONBARCODE_LICENSE: ${{secrets.IRONBARCODE_LICENSE}}

# Example: GitHub Actions environment variable
env:
  IRONBARCODE_LICENSE: ${{secrets.IRONBARCODE_LICENSE}}

Dize değeri, CI/CD sır deposunda diğer dize değerli kimlik bilgileriyle birlikte depolanır. Herhangi bir dosya çözümleme, yapıt sağlama veya hacim yapılandırması gerekli değildir.

Sorun 2: Windows'ta MSVC++ Çalışma Zamanı Bağımlılığı

LEADTOOLS: Windows Server dağıtımları, ana bilgisayarda MSVC++ 2017 Runtime kurulumunu gerektirir.LEADTOOLSdağıtımları için kullanılan sağlama betikleri, konteyner tabanlı görüntüler ve Windows AMI'leri genellikle bu çalışma zamanını yüklemek için bir adım içermektedir.

Çözüm: Tüm Windows sağlama betiklerinden ve konteyner görüntülerinden MSVC++ 2017 Runtime kurulum adımını kaldırın. IronBarcode'un yerel çalışma zamanı bağımlılığı yoktur. dotnet/aspnet taban görüntüsü, ek çalışma zamanında paketlere gerek olmadan yeterlidir.

Sorun 3: RasterSupportType Özellik Kilidi Kontrolleri

LEADTOOLS: Başlatma dizisi, her barkod özelliği için Barcodes1D, Barcodes2D ve BarcodeWrite gibi RasterSupport.IsLocked() kontrollerini içerir. Bu kontroller, lisans dosyasının her gerektiğinde kapsayıcılığı doğrulamak içinLEADTOOLSmimarisi tarafından zorunlu savunma kodudur.

Çözüm: Tüm RasterSupport.IsLocked() çağrılarını kaldırın. IronBarcode, tüm okuma ve yazma kabiliyetlerini tek bir lisans içinde içerir. Herhangi bir özellik kilidi durumu bulunmamaktadır ve herhangi bir özellik doğrulama adımı gerekmez:

// Remove these lines entirely:
// if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite)) ...

// Remove these lines entirely:
// if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite)) ...

' Remove these lines entirely:
' If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) ...
' If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) ...
' If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) ...

Sorun 4: BarcodeSymbology Dizisi Kaldırma

LEADTOOLS: engine.Reader.ReadBarcodes()'e yapılan her çağrı açık bir BarcodeSymbology[] parametresi gerektirir. Semboji dizisinde listelenmeyen barkodlar algılanmayacaktır, bu da yeni bir barkod türü bir giriş belgesinde tanıtıldığında sessiz başarısız okumayla sonuçlanabilir.

Çözüm: Semboji dizisini kaldırın. BarcodeReader.Read(), desteklenen tüm formatları otomatik olarak algılar. Bilinen bir format seti için performans ayarlaması gerekiyorsa, BarcodeReaderOptions, kapsamlı bir listeleme gerektirmeden isteğe bağlı ipuçları sunar:

// Optional: hint the reader for performance in format-known scenarios
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};
var results = BarcodeReader.Read("scan.png", options);

// Optional: hint the reader for performance in format-known scenarios
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};
var results = BarcodeReader.Read("scan.png", options);

Imports System

' Optional: hint the reader for performance in format-known scenarios
Dim options As New BarcodeReaderOptions With {
    .ExpectBarcodeTypes = BarcodeEncoding.Code128 Or BarcodeEncoding.QRCode
}
Dim results = BarcodeReader.Read("scan.png", options)

Geçiş Öncesi Görevler

Herhangi bir değişiklik yapmadan önce tümLEADTOOLSkullanımını kod tabanında denetleyin:

grep -r "using Leadtools" --include="*.cs" .
grep -r "RasterSupport\|BarcodeEngine\|RasterCodecs" --include="*.cs" .
grep -r "BarcodeSymbology\|BarcodeData\|RasterImage" --include="*.cs" .
grep -r "LEADTOOLS.LIC\|SetLicense\|KernelExpired" --include="*.cs" .
grep -r "COPY LEADTOOLS.LIC\|LEADTOOLS_LICENSE_PATH" --include="*.dockerfile" --include="Dockerfile" .

grep -r "using Leadtools" --include="*.cs" .
grep -r "RasterSupport\|BarcodeEngine\|RasterCodecs" --include="*.cs" .
grep -r "BarcodeSymbology\|BarcodeData\|RasterImage" --include="*.cs" .
grep -r "LEADTOOLS.LIC\|SetLicense\|KernelExpired" --include="*.cs" .
grep -r "COPY LEADTOOLS.LIC\|LEADTOOLS_LICENSE_PATH" --include="*.dockerfile" --include="Dockerfile" .

Başlatma bloklarının, okuma çağrı noktalarının, yazma çağrı noktalarının ve Dockerfile referanslarının sayısını ve konumunu belgelemeden kod değişikliklerine başlamayın.

Kod Güncelleme Görevleri

1. Tüm beşLEADTOOLSNuGet paketini (ve varsa PDF codec'ini) kaldırın
2. IronBarcode'i dotnet add package IronBarcode aracılığıyla yükleyin
3. Tüm using Leadtools.* ad alanı içe aktarımlarını using IronBarCode ile değiştirin
4. Tüm RasterSupport.SetLicense başlatma bloğunu IronBarCode.License.LicenseKey = "key" ile değiştirin
5. Tüm RasterSupport.KernelExpired kontrollerini kaldırın
6. Tüm RasterSupport.IsLocked(RasterSupportType.*) kontrollerini kaldırın
7. Tüm new BarcodeEngine() örneklemelerini kaldırın
8. Barkod kod yollarındaki tüm new RasterCodecs() örneklemelerini kaldırın
9. codecs.Load(path) + engine.Reader.ReadBarcodes(image, ...)'yi BarcodeReader.Read(path) ile değiştirin
10. new BarcodeData(...) + new RasterImage(...) + FillCommand + WriteBarcode + codecs.Save()'yi BarcodeWriter.CreateBarcode(...).SaveAsPng(path) ile değiştirin
11. BarcodeSymbology.* numaralandırma referanslarını BarcodeEncoding.* ile değiştirin (not: QR, QRCode olur)
12. Tüm Dockerfile'lardan COPY LEADTOOLS.LIC satırlarını kaldırın
13. Dockerfile'lardan ve dağıtım yapılandırmasından LEADTOOLS_LICENSE_PATH ve LEADTOOLS_DEVELOPER_KEY ortam değişkeni beyanlarını kaldırın
14. Dockerfile'lara ve sır yapılandırmasına IRONBARCODE_LICENSE ortam değişkeni ekleyin
15. Windows sağlama betiklerinden MSVC++ 2017 Runtime kurulumunu kaldırın

Geçiş Sonrası Testler

• Tüm daha önce BarcodeSymbology[] dizisi tarafından kapsanan semboloji türlerinde barkod okuma işlemlerinin beklenen değerler döndüğünü doğrulayın
• Kod 128, QR kodu ve diğer üretilen barkod türlerinin geçerli, taranabilir çıktılar ürettiğini doğrulayın
• Leadtools.Pdf olmadan PDF barkod çıkarımının doğru çalıştığını doğrulayın
• Herhangi bir .LIC dosyası monte edilmeden kapsayıcı görüntüsünü oluşturun ve başlatın ve uygulamanın doğru şekilde başlatıldığını doğrulayın
• .LIC dosya sağlama adımı olmadan CI/CD boru hattını çalıştırın ve tüm aşamaların başarıyla tamamlandığını doğrulayın
• Yayımlanmış çıktı boyutunun ve konteyner görüntüsü çekme süresinin iyileştiğini doğrulayın