근본적인 문제

LEADTOOLS 초기화 순서는 20줄 이상의 코드와 네 가지 검증 단계를 거쳐야 BarcodeEngine을 생성할 수 있습니다. IronBarcode는 전체 시퀀스를 단일 할당으로 대체합니다.

// 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")

1단계: 리드툴즈 포장재를 제거합니다.

프로젝트에서 모든 리드툴즈 패키지를 제거하십시오.

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

PDF 파일에서 바코드를 추출하기 위해 PDF 코덱이 추가된 경우:

dotnet remove package Leadtools.Pdf

dotnet remove package Leadtools.Pdf

Windows Server 배포 환경에서는 마이그레이션이 완료된 후 프로비저닝 스크립트에서 MSVC++ 2017 런타임을 제거할 수 있습니다. IronBarcode는 어떤 플랫폼에서도 네이티브 런타임에 대한 종속성이 없습니다.

2단계: IronBarcode 설치

dotnet add package IronBarcode

dotnet add package IronBarcode

이 단일 패키지에는 모든 이미지 형식 지원, PDF 바코드 추출 기능, 머신러닝 오류 수정 기능, 그리고 50개 이상의 심볼 형식이 모두 포함되어 있습니다. 별도의 코덱 패키지는 필요하지 않습니다.

3단계: 라이선스 초기화

LEADTOOLS 초기화 블록을 한 줄로 보완하세요. 코드베이스에서 RasterSupport.SetLicense에 대한 호출을 모두 찾으세요 — 일반적으로 응용 프로그램 시작 시점에 딱 한 번 있습니다 — 그리고 주변 초기화 순서를 모두 바꾸세요.

// Before: entire 리드툴즈 initialization block (20+ lines)
// After:
using IronBarCode;

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

// Before: entire 리드툴즈 initialization block (20+ lines)
// After:
using IronBarCode;

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

Imports IronBarCode

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

라이선스 키는 환경 변수, appsettings.json, Azure Key Vault, AWS Secrets Manager 또는 Kubernetes 비밀과 같은 문자열 저장 가능 구성 메커니즘에서 얻을 수 있습니다. 환경 기반 라이선스 구성, Docker 배포 패턴 및 지원되는 모든 구성 방식에 대한 자세한 내용은 라이선스 키 설정 문서를 참조하십시오.

이미지에서 바코드 읽기

LEADTOOLS는 이미지 로딩과 바코드 스캔을 두 개의 별개의 객체 레이어로 분리합니다. RasterCodecs 인스턴스가 이미지 파일을 RasterImage에 로드하고, BarcodeEngine 인스턴스가 이를 스캔합니다. 호출자는 또한 명시적인 BarcodeSymbology 값 배열을 제공해야 합니다; 배열에 나열되지 않은 형식은 감지되지 않습니다.

LEADTOOLS 접근 방식:

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 접근 방식:

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 파일 경로를 직접 받아 이미지를 내부적으로 로드하고, 호출자가 예상되는 형식을 열거할 필요 없이 50개 이상의 지원되는 심볼 체계에서 형식을 자동으로 감지합니다. 고급 구성(읽기 속도 조정, 다중 바코드 감지 및 저품질 이미지 처리)에 대해서는 이미지에서 바코드 읽기 가이드를 참조하십시오.

코드 128 바코드 생성

LEADTOOLS 생성을 위해서는 BarcodeData 객체를 구성하고, 명시적인 메모리 플래그, 픽셀 깊이 및 바이트 순서로 빈 RasterImage을 할당하고, 이미지를 배경 색으로 채운 다음, 바코드를 그 위에 작성하고, RasterCodecs로 저장해야 합니다. IronBarcode는 단일 플루언트 메서드 체인을 통해 이러한 모든 단계를 수행합니다.

LEADTOOLS 접근 방식:

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 접근 방식:

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")

크기 조정, 스타일 지정, 여백 제어 및 지원되는 출력 형식에 대한 자세한 내용은 바코드 이미지 만들기 문서를 참조하세요.

로고 브랜딩이 포함된 QR 코드 생성

LEADTOOLS QR 코드 생성은 다른 바코드 유형과 동일한 다단계 RasterImage 구성 패턴을 따릅니다. IronBarcode는 QR 코드의 중앙에 로고를 삽입하기 위한 전용 AddBrandLogo 메소드를 함께 QRCodeWriter를 제공합니다.

LEADTOOLS 접근 방식:

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 접근 방식:

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 문서에서 바코드 추출하기

LEADTOOLS PDF 바코드 추출은 별도의 Leadtools.Pdf 패키지, 명시적인 PDF 로딩 구성, 수동 페이지 수 쿼리 및 각 페이지 반복을 필요로 합니다. 각 페이지는 스캔 전에 RasterImage로 개별적으로 로드되어야 합니다. IronBarcode는 기본 패키지에 PDF 지원 기능을 포함하고 있으며 페이지 반복 처리를 내부적으로 수행합니다.

LEADTOOLS 접근 방식:

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 접근 방식:

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 배포

LEADTOOLS Docker 배포를 정의하는 파일 관리 요구 사항은 IronBarcode로 마이그레이션하면 완전히 사라집니다.

LEADTOOLS 접근 방식:

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 접근 방식:

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

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

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

라이선스 키는 Docker 시크릿, Kubernetes 시크릿 또는 기타 환경 변수 메커니즘을 통해 컨테이너 런타임에 주입됩니다. 파일 프로비저닝 단계는 필요하지 않습니다. Docker 및 Linux 배포 가이드는 Alpine 및 Debian 기본 이미지, 다단계 빌드, Kubernetes 배포 패턴을 다룹니다.

문제 1: CI/CD 환경에서 .LIC 파일 참조

LEADTOOLS: 리드툴즈 응용 프로그램을 구축하거나 배포하는 CI/CD 파이프라인은 .LIC 파일을 준비해야 합니다 — 소스 제어에 체크인하거나, base64 비밀에서 디코딩하거나, 볼륨 인공물로 마운트하여 가능합니다. 애플리케이션을 실행하는 각 파이프라인 단계는 해당 파일에 접근할 수 있어야 합니다.

해결책: 파이프라인에서 모든 .LIC 파일 처리를 제거하세요. 문자열 비밀로 대체하세요:

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

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

해당 문자열 값은 다른 문자열 값 자격 증명과 함께 CI/CD 비밀 저장소에 저장됩니다. 파일 디코딩, 아티팩트 프로비저닝, 볼륨 구성이 필요하지 않습니다.

문제 2: Windows에서 MSVC++ 런타임 종속성 문제

LEADTOOLS: Windows Server 배포에는 호스트에 MSVC++ 2017 런타임이 설치되어 있어야 합니다. 리드툴즈 배포에 사용되는 프로비저닝 스크립트, 컨테이너 기반 이미지 및 Windows AMI에는 일반적으로 이 런타임을 설치하는 단계가 포함되어 있습니다.

해결 방법: 모든 Windows 프로비저닝 스크립트 및 컨테이너 이미지에서 MSVC++ 2017 런타임 설치 단계를 제거하십시오. IronBarcode는 네이티브 런타임에 대한 종속성이 없습니다. dotnet/aspnet 기본 이미지로 추가 런타임 패키지가 필요 없습니다.

문제 3: RasterSupportType 기능 잠금 검사

LEADTOOLS: 초기화 순서에는 RasterSupport.IsLocked()가 각 바코드 기능 - Barcodes1D, Barcodes2D, 및 BarcodeWrite에 대해 포함됩니다. 이러한 검사는 리드툴즈 아키텍처에서 라이선스 파일이 필요한 모든 기능을 포함하는지 확인하기 위해 요구되는 방어 코드입니다.

해결책: 모든 RasterSupport.IsLocked() 호출을 제거하세요. IronBarcode는 단일 라이선스에 모든 읽기 및 쓰기 기능을 포함합니다. 기능별 잠금 상태가 없으며 기능 검증 단계도 필요하지 않습니다.

// 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) ...

문제 4: 바코드 심볼 배열 제거

LEADTOOLS: engine.Reader.ReadBarcodes()에 대한 모든 호출은 명시적인 BarcodeSymbology[] 매개변수를 필요로 합니다. 배열에 나열되지 않은 심볼을 사용하는 바코드는 감지되지 않으므로 입력 문서에 새로운 바코드 유형이 도입될 때 감지되지 않는 오류가 발생할 수 있습니다.

해결 방법: 심볼 배열을 제거합니다. BarcodeReader.Read()는 지원되는 모든 형식을 자동으로 감지합니다. 알려진 형식 세트를 위한 성능 조정이 필요하면 BarcodeReaderOptions는 철저한 열거 없이 선택적 힌트를 제공합니다:

// 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)

이동 전 작업

변경 작업을 수행하기 전에 코드베이스 내의 모든 리드툴즈 사용 부분을 감사하십시오.

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" .

코드 변경을 시작하기 전에 초기화 블록의 개수와 위치, 읽기 호출 위치, 쓰기 호출 위치 및 Dockerfile 참조를 문서화하십시오.

코드 업데이트 작업

1. 리드툴즈 NuGet 패키지 5개를 모두 제거합니다(PDF 코덱이 있는 경우 함께 제거).
2. dotnet add package IronBarcode를 통해 IronBarcode를 설치하세요
3. 모든 using Leadtools.* 네임스페이스 가져오기를 using IronBarCode로 바꾸세요
4. 전체 RasterSupport.SetLicense 초기화 블록을 IronBarCode.License.LicenseKey = "key"로 바꾸세요
5. 모든 RasterSupport.KernelExpired 체크를 제거하세요
6. 모든 RasterSupport.IsLocked(RasterSupportType.*) 체크를 제거하세요
7. 모든 new BarcodeEngine() 인스턴스화를 제거하세요
8. 바코드 코드 경로에서 모든 new RasterCodecs() 인스턴스화를 제거하세요
9. codecs.Load(path) + engine.Reader.ReadBarcodes(image, ...)을 BarcodeReader.Read(path)로 대체하세요
10. new BarcodeData(...) + new RasterImage(...) + FillCommand + WriteBarcode + codecs.Save()을 BarcodeWriter.CreateBarcode(...).SaveAsPng(path)로 대체하세요
11. BarcodeSymbology.* 열거형 참조를 BarcodeEncoding.*로 대체하세요 (참고: QR는 QRCode로 바뀝니다)
12. 모든 Dockerfile에서 COPY LEADTOOLS.LIC 라인을 제거하세요
13. Dockerfile 및 배포 설정에서 LEADTOOLS_LICENSE_PATH 및 LEADTOOLS_DEVELOPER_KEY 환경 변수 선언을 제거하세요
14. Dockerfile과 비밀 구성에 IRONBARCODE_LICENSE 환경 변수를 추가하세요
15. Windows 프로비저닝 스크립트에서 MSVC++ 2017 런타임 설치를 제거합니다.

마이그레이션 후 테스트

• 모든 바코드 읽기 작업이 이전에 BarcodeSymbology[] 배열로 포함된 모든 심볼 분류 유형에 대한 예상 값을 반환하는지 확인하세요
• Code 128, QR 코드 및 기타 생성된 바코드 유형이 유효하고 스캔 가능한 출력을 생성하는지 확인합니다.
• Leadtools.Pdf 없이 PDF 바코드 추출이 올바르게 작동하는지 확인하세요
• .LIC 파일을 마운트하지 않고 컨테이너 이미지를 빌드하고 시작하여 응용 프로그램이 올바르게 초기화되는지 확인하세요
• .LIC 파일 준비 단계 없이 CI/CD 파이프라인을 실행하고 모든 단계가 성공적으로 완료되는지 확인하세요
• 게시된 출력 크기와 컨테이너 이미지 다운로드 시간이 개선되었는지 확인합니다.