리드툴즈 바코드와 IronBarcode: C# 바코드 라이브러리 비교

파일 기반 라이선스 아키텍처

LEADTOOLS 초기화에는 첫 번째 바코드 작업이 실행되기 전에 약 20줄의 코드가 필요합니다. 이 과정은 파일 경로 확인, 만료 검증 및 기능별 잠금 검사를 다룹니다.

// LEADTOOLS: 20줄 이상 before the first barcode operation
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: 20줄 이상 before the first barcode operation
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

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

이 초기화 블록이 성공적으로 실행되어야만 바코드 읽기 또는 쓰기 작업이 정상적으로 작동합니다. .LIC 파일이 없거나 경로가 잘못되었거나 파일 권한이 잘못된 경우, LEADTOOLS는 자동으로 초기화되지 않고 작동을 중지하는 오류와 함께 초기화되지 않습니다.

상세 기능 비교

LEADTOOLS 접근법

LEADTOOLS 라이선스를 사용하려면 파일 시스템에 알려진 경로에 .LIC 파일이 물리적으로 존재하고 RasterSupport.SetLicense에 전달된 개발자 키 문자열이 있어야 합니다. SetLicense을 호출한 후 라이선스가 만료되지 않았으며 각 바코드 기능이 개별적으로 잠금 해제되었는지 확인해야 합니다. 모든 검수를 통과해야만 BarcodeEngine를 생성할 수 있습니다:

// LEADTOOLS: 20줄 이상 before the first barcode operation
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: 20줄 이상 before the first barcode operation
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

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

이 파일 기반 모델은 현대적인 비밀 관리 시스템보다 앞서 존재했습니다. 애플리케이션이 실행되는 모든 환경(개발자 머신, CI 빌드 에이전트, 스테이징 서버, 프로덕션 호스트)에서 .LIC 파일을 프로비저닝해야 합니다.

IronBarcode접근법

IronBarcode의 라이선스 초기화는 단 한 줄로 완료됩니다.

// IronBarcode: done
IronBarCode.License.LicenseKey = "YOUR-KEY";

// IronBarcode: done
IronBarCode.License.LicenseKey = "YOUR-KEY";

해당 키는 환경 변수, 구성 파일 또는 비밀 관리자 등 문자열이 생성될 수 있는 모든 곳에서 가져올 수 있습니다. 찾아야 할 파일도 없고, 만료 확인을 작성할 필요도 없으며, 기능 잠금을 확인할 필요도 없습니다. 라이센스 설정 및 배포 옵션의 경우 환경 변수, appsettings.json, Azure Key Vault 등 모든 패턴을 문서에서 다룹니다.

LEADTOOLS 접근법

리드툴즈 Docker를 배포하려면 .LIC 파일을 컨테이너 이미지에 복사하거나 런타임에 볼륨으로 마운트해야 합니다:

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

WORKDIR /app
COPY publish/ .

# The license file must be physically present in the container
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"]

이러한 접근 방식은 후속적으로 여러 가지 문제점을 야기할 수 있습니다. 라이선스 키를 갱신하거나 취소하려면 이미지 재구축 또는 볼륨 재마운트가 필요합니다. CI/CD 파이프라인은 빌드 시 .LIC 파일을 체크인하거나 base64로 인코딩된 시크릿에서 디코딩해야 합니다. 키-값 문자열 쌍을 위해 설계된 Kubernetes 시크릿은 이제 파일 콘텐츠를 저장해야 합니다. 임시 컨테이너를 실행하는 팀은 새 노드를 생성할 때마다 파일 프로비저닝 문제를 해결해야 합니다.

IronBarcode접근법

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 시크릿, AWS Secrets Manager, Azure Key Vault 및 HashiCorp Vault와 같은 컨테이너 환경에 문자열을 주입할 수 있는 모든 시스템과 기본적으로 호환됩니다. Alpine 및 Debian 기반 이미지를 모두 다루는 Docker 및 Linux 배포 가이드가 있습니다.

LEADTOOLS 접근법

리드툴즈를 읽으려면 이미지를 로드할 RasterCodecs 인스턴스, 스캔할 BarcodeEngine 인스턴스, 찾을 형식을 지정하는 BarcodeSymbology 값의 명시적 배열을 만들어야 합니다. 배열에서 심볼을 제외하면 LEADTOOLS는 해당 유형의 바코드를 감지하지 못합니다.

// LEADTOOLS: codec, engine, explicit symbology list
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load(imagePath);
var engine = new BarcodeEngine();

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

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

return barcodes.Select(b => b.Value).ToArray();

// LEADTOOLS: codec, engine, explicit symbology list
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load(imagePath);
var engine = new BarcodeEngine();

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

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

return barcodes.Select(b => b.Value).ToArray();

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim barcodes As IEnumerable(Of BarcodeData)
Using codecs As New RasterCodecs()
    Using image As RasterImage = codecs.Load(imagePath)
        Dim engine As New BarcodeEngine()

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

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

Return barcodes.Select(Function(b) b.Value).ToArray()

IronBarcode접근법

IronBarcode 지원되는 50개 이상의 심볼 체계에서 형식을 자동으로 감지합니다. 파일 경로가 직접 전달됩니다. 이미지 로딩 레이어나 심볼 배열은 필요하지 않습니다.

// IronBarcode: auto-detect, no object setup
using IronBarCode;

var results = BarcodeReader.Read(imagePath);
return results.Select(r => r.Value).ToArray();

// IronBarcode: auto-detect, no object setup
using IronBarCode;

var results = BarcodeReader.Read(imagePath);
return results.Select(r => r.Value).ToArray();

Imports IronBarCode

Dim results = BarcodeReader.Read(imagePath)
Return results.Select(Function(r) r.Value).ToArray()

바코드 읽기 옵션, 속도와 정확도 조정, 까다로운 이미지 처리 등에 대한 자세한 내용은 이미지에서 바코드 읽기 가이드를 참조하세요. 이 가이드에서는 API의 모든 기능을 다룹니다.

LEADTOOLS 접근법

리드툴즈 바코드 생성은 기호, 값, 경계가 있는 BarcodeData 객체를 생성한 다음 명시적인 픽셀 크기, 비트 깊이, 바이트 순서, 보기 원근법을 사용하여 빈 RasterImage를 생성하고 FillCommand를 사용하여 흰색 배경으로 채운 다음 engine.Writer.WriteBarcode()를 호출하고 RasterCodecs로 저장해야 합니다. 즉, 여러 객체 유형에 걸쳐 다섯 가지의 서로 다른 작업이 수행됩니다.

// LEADTOOLS: 5 operations, 25세 이상 lines
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData(BarcodeSymbology.Code128)
{
    Value = data,
    Bounds = new LeadRect(0, 0, 400, 100)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 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, outputPath, RasterImageFormat.Png, 0);

// LEADTOOLS: 5 operations, 25세 이상 lines
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData(BarcodeSymbology.Code128)
{
    Value = data,
    Bounds = new LeadRect(0, 0, 400, 100)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 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, outputPath, RasterImageFormat.Png, 0);

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim engine As New BarcodeEngine()

Dim barcodeData As New BarcodeData(BarcodeSymbology.Code128) With {
    .Value = data,
    .Bounds = New LeadRect(0, 0, 400, 100)
}

Using image As New RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 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, outputPath, RasterImageFormat.Png, 0)
    End Using
End Using

IronBarcode접근법

IronBarcode 이미지 생성, 배경 채우기 및 인코딩을 내부적으로 처리합니다.

// IronBarcode: one method chain
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

// IronBarcode: one method chain
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

Imports IronBarcode

BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng(outputPath)

바코드 이미지를 생성 할 때,IronBarcodeAPI는 일련의 명령형 설정 객체가 아닌 유연한 체인을 통해 스타일링, 여백, 회전 및 형식 변환을 제공합니다.

컨테이너 및 클라우드 배포

Docker, Kubernetes 또는 서버리스 환경으로 워크로드를 마이그레이션하는 팀은 파일 기반 라이선스 모델을 구체적인 운영 문제로 직면하게 됩니다. 모든 새 컨테이너 인스턴스, 모든 새 클라우드 리전, 모든 새 환경에는 애플리케이션이 시작되기 전에 .LIC 파일이 프로비저닝되어 있고 액세스할 수 있어야 합니다. 문자열 값의 비밀 정보를 관리하도록 설계된 비밀 정보 관리 시스템은 파일 기반 아티팩트를 깔끔하게 처리하지 못합니다. 환경 변수 주입을 구성 기준으로 사용하는 팀은 LEADTOOLS를 사용하려면 일반적인 비밀 키 워크플로 외부에 별도의 프로비저닝 단계가 필요하다는 것을 알게 됩니다. 배포량이 증가함에 따라(자동 확장, 블루-그린 배포, 다중 지역 복제 등) 파일 프로비저닝의 운영 비용도 함께 증가합니다.

SDK 용량 및 종속성 관리

바코드 읽기 또는 생성이 서비스의 주요 또는 유일한 요구 사항인 경우, 5개의 패키지로 구성된 LEADTOOLS 설치와 MSVC++ 2017 런타임 종속성은 컨테이너 이미지 크기, 서버리스 함수의 콜드 스타트 ​​지연 시간, CI/CD 파이프라인의 빌드 시간에 영향을 미치는 오버헤드를 발생시킵니다. 경량 마이크로서비스나 람다 스타일 함수를 구축하는 팀은 바코드 관련 요구 사항을 해결하기 위해 전체 이미지 처리 SDK를 가져오면 코드 검토 및 아키텍처 검토에서 정당화하기 어려운 의존성 문제가 발생한다는 것을 알게 됩니다. 향후 플랫폼 업그레이드로 인해 네이티브 런타임 종속성 변경 사항을 테스트해야 하는 경우, 해당 작업은 서비스를 유지 관리하는 팀의 책임입니다.

가격 투명성

개발 시작 전에 프로젝트 예산을 책정해야 하는 개발팀은 LEADTOOLS에서 공개한 가격 정보만으로는 전체 비용을 파악할 수 없습니다. 개발 라이선스는 개발자 1인당 연간 1,295달러~1,469달러로 책정되어 있지만, 서버 애플리케이션용 프로덕션 배포 라이선스는 영업 담당자를 통해 별도로 견적을 받아야 합니다. 5명의 개발자로 구성된 팀이 3개의 운영 서버에 배포하려면 LEADTOOLS가 예산에 맞는지 확인하기 전에 맞춤 견적을 받아야 합니다. 공개된 가격을 기준으로 구매 결정을 내리는 것을 선호하는 팀, 즉 옵션을 비교하고, 내부 승인을 얻거나, 다년간의 예산을 계획하는 팀의 경우, 이 모델을 사용하려면 평가를 완료하기 전에 영업 담당자와 상담해야 합니다.

바코드 전용 요구 사항

OCR, DICOM 이미지 처리, 문서 주석 또는 LEADTOOLS Suite 의 다른 기능을 필요로 하지 않고 바코드를 읽거나 생성해야 하는 애플리케이션은 실제 요구 사항보다 더 광범위한 플랫폼에 비용을 지불하고 있는 셈입니다. LEADTOOLS의 통합 가치, 즉 OCR, 바코드 및 문서 처리 모듈 간의 데이터 전달 기능은 분명하지만, 해당 Suite 의 여러 기능을 동시에 사용할 때만 그 효과가 발휘됩니다. 웹 API에서 바코드를 스캔하거나 문서 처리 파이프라인에서 바코드를 생성하는 것과 같이 요구 사항이 제한적인 경우, 포괄적인 이미지 처리 플랫폼의 부담 없이 특정 기능에 특화된 바코드 라이브러리를 사용하여 해당 요구 사항을 직접적으로 충족할 수 있습니다.

라이선스 초기화 교체

전체 LEADTOOLS 초기화 블록(파일 경로, 만료 확인 및 기능별 잠금 검증)이 단 한 줄로 대체됩니다.IronBarcode라이선스 키는 문자열을 저장하는 모든 비밀 관리 시스템에 저장할 수 있습니다.

// Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

// Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

' Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

Docker 환경 변수 패턴

Docker파일의 COPY LEADTOOLS.LIC 줄은 완전히 제거됩니다. 라이선스는 런타임 시 환경 변수를 통해 제공되며, 모든 표준 비밀 키 주입 메커니즘과 호환됩니다.

# Remove: COPY LEADTOOLS.LIC /app/license/LEADTOOLS.LIC
# Remove: ENV LEADTOOLS_LICENSE_PATH=/app/license/LEADTOOLS.LIC
# Add:
ENV IRONBARCODE_LICENSE=your-license-key

패키지 제거

기존의 5가지 LEADTOOLS 패키지와 선택 사항인 PDF 코덱이 제거되고 단일 패키지로 대체되었습니다.

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
# If added:
dotnet remove package Leadtools.Codecs.Pdf

dotnet add package IronBarcode

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
# If added:
dotnet remove package Leadtools.Codecs.Pdf

dotnet add package IronBarcode