Accusoft 바코드익스프레스와 IronBarcode: C# 바코드 라이브러리 비교

투키 시스템 설명

BarcodeXpress는 라이선스를 개념적으로 분리된 두 가지 계층으로 나눕니다.

// 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 및 SolutionKey 쌍은 SDK 자체를 활성화합니다. 자체 키와 자체 솔루션 키를 별도의 인수로 사용하는 UnlockRuntime 호출은 프로덕션 배포 기능을 활성화합니다. 실제 운영 환경에서 바코드 값이 완전하고 가려지지 않게 반환되려면 두 가지 모두 존재하고 유효해야 합니다.

코드 리뷰에서 이러한 패턴은 예측 가능한 질문을 만들어냅니다: "왜 두 개의 다른 키를 사용하여 UnlockRuntime를 호출하는가?" Accusoft는 SDK 라이선싱과 배포 라이선싱을 별도의 과금이 적용되는 별도의 제품으로 취급한다는 대답은 API 자체에서 항상 명확하게 드러나지 않습니다. 초기 설정 후 6개월이 지난 시점에도 이 코드를 유지 관리하는 팀은 어떤 키가 어떤 용도인지 이해하기 위해 문서를 참조해야 하는 경우가 많습니다.

IsRuntimeUnlocked 속성을 사용하면 런타임 계층이 활성화되어 있는지 확인할 수 있습니다:

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

이 검사는 평가 모드 출력에서 ​​예외를 발생시키거나 명확하게 실패를 알리는 대신 부분적인 데이터를 조용히 반환하는 것을 발견했을 때 팀이 추가하는 안전장치입니다.

상세 기능 비교

BarcodeXpress 접근 방식

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

이 코드는 바코드 작업이 시작되기 전에 두 개의 서로 다른 라이선스 키 시스템을 관리하기 위해 만들어진 15줄짜리 생성자입니다. 코드 50523--@@ 가드는 선택 사항이 아니며, 이 가드가 없으면 런타임 키가 누락되거나 잘못 구성된 모든 환경에서 서비스가 성능 저하된 값을 자동으로 반환합니다.

IronBarcode접근법

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"

이것이 완전한 라이선스 설정입니다. 별도의 런타임 잠금 해제, 솔루션 이름, 두 개의 인수 UnlockRuntime 호출이 필요하지 않습니다. Docker에서는 이 값이 시작 시 읽히는 환경 변수가 됩니다. CI/CD 파이프라인에서는 하나의 비밀 값으로 사용됩니다. 컨테이너 오케스트레이터에서 이는 파드에 주입되는 하나의 환경 변수입니다.

BarcodeXpress 접근 방식

바코드익스프레스로 판독하려면 상수와 값을 취하는 SetPropertyValue를 통해 리더기를 구성한 다음 Analyze()를 호출하여 결과를 검색해야 합니다:

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 상수는 처리할 파일을 지정하는 API의 방식입니다. 상수 식별자와 값을 일반 SetPropertyValue 메서드에 전달하는 이 패턴은 구형 COM 기반 API를 연상시킵니다. 문서에 BarcodeTypes에 나열되지 않은 형식이 포함되어 있으면 해당 문서를 찾을 수 없습니다. 이는 문서 소스가 변경될 때 유지 관리 부담으로 작용합니다.

IronBarcode접근법

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 지원되는 모든 심볼 체계에서 형식을 자동으로 감지합니다. 이미지에 Code 128, QR 코드 및 DataMatrix가 모두 포함된 경우, 구성 변경 없이 세 가지 모두 결과 모음에 표시됩니다. 읽기 동작을 더욱 세밀하게 제어하기 위해 BarcodeReaderOptions 클래스는 속도, 스레드 수 및 다중 바코드 설정을 제공합니다.

PDF 원본 파일 읽기도 동일한 방법으로 가능합니다.

using IronBarCode;

// 내부 지원 PDF 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;

// 내부 지원 PDF 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

' 내부 지원 PDF 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 파일을 기본적으로 읽지 않습니다. 먼저 별도의 라이브러리를 사용하여 각 페이지를 이미지로 렌더링한 다음, 해당 이미지를 BarcodeXpress 리더기에 전달해야 합니다. 이는 종속성을 추가하고, 변환 단계를 추가하며, 선택한 PDF 라이브러리에 따라 추가 라이선스 비용을 발생시킵니다.

BarcodeXpress 접근 방식

BarcodeXpress는 인스턴스 기반이며 reader 객체는 상태 저장형입니다. 병렬 처리를 위해서는 스레드당 하나의 인스턴스가 필요하며, 각 스레드 컨텍스트에서 2계층 라이선스 초기화가 반복됩니다.

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

표준판은 또한 분당 40페이지라는 속도 제한을 적용합니다. 10만 건의 문서를 분당 40건의 속도로 처리하는 데는 대략 41시간이 소요됩니다. Professional 에디션은 이러한 제한을 없애지만, 개발자당 비용이 더 높으며, 이미 구매한 런타임 라이선스 비용도 추가됩니다.

IronBarcode접근법

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의 정적 메서드는 상태 저장소가 없으므로 인스턴스 격리 없이 Parallel.ForEach를 통해 안전하게 사용할 수 있습니다.IronBarcode어떤 가격대에서도 처리량 제한을 두지 않습니다. 읽기 성능 조정을 위해 BarcodeReaderOptions 클래스는 ReadingSpeed 및 MaxParallelThreads 설정을 제공합니다:

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가 기본값입니다. 바코드가 깨끗한 고처리량 파이프라인의 경우 ReadingSpeed.Faster를 사용하고, 손상되었거나 대비가 낮은 이미지의 경우 ReadingSpeed.Detailed를 사용합니다.

40 PPM 장벽을 넘어 확장하기

표준 버전의 분당 40페이지 처리 속도 제한은 넉넉해 보이지만, 비즈니스 팀에서 1년 치 보관된 송장을 일괄 처리하기 시작하면 그 제한이 얼마나 심각한지 깨닫게 됩니다. 그 속도로 10만 건의 문서를 처리하는 데는 대략 41시간이 걸립니다. Professional 에디션으로 업그레이드하면 사용량 제한은 사라지지만, 개발자당 사용권 가격이 인상되며, 이미 구매한 런타임 라이선스 비용도 추가로 발생합니다. 구매 계약서에 서명한 후에 처리량 한계를 발견한 팀은 해당 한계를 제거하는 데 드는 총비용이 초기 예상치를 훨씬 초과하는 경우가 많습니다.

CI/CD 파이프라인 라이선스 복잡성

일반적인 CI/CD 설정에서는 임시 컨테이너에서 빌드를 실행합니다. BarcodeXpress를 사용하려면 모든 빌드 환경에 SDK 키 쌍과 런타임 잠금 해제 키가 모두 필요하며, 이 두 키는 별도의 비밀 키로 관리됩니다. 런타임 키가 없거나 잘못 구성된 경우 빌드는 성공할 수 있지만 통합 테스트에서 모호한 값이 반환될 수 있습니다. 이는 테스트 파이프라인에서 테스트 어설션을 실제 바코드 콘텐츠에 맞춰 신중하게 작성하지 않으면 쉽게 간과할 수 있는 오류 모드입니다.

에어갭 및 보안 배포 요구 사항

환자 기록을 처리하는 의료 시스템, 정부 문서 워크플로, 금융 기관 백오피스 처리와 같은 일부 환경에서는 외부 네트워크 통화를 할 때 라이선스 유효성 검사가 불가능합니다. BarcodeXpress의 런타임 라이선스 시스템은 Accusoft의 라이선스 인프라를 사용하므로 네트워크 송출 제한이 엄격한 환경에서는 규정 준수 문제가 발생할 수 있습니다. 그러한 환경에서 작업하는 팀은 라이선스 유효성 검사가 전적으로 로컬에서 이루어지는 라이브러리를 선택하는 경우가 많습니다.

Docker 및 컨테이너 배포

Docker에서 BarcodeXpress를 사용하려면 일반적으로 라이선스 파일을 컨테이너의 알려진 경로에 마운트하거나 라이선스 서버를 구성하고 컨테이너가 해당 서버를 가리키도록 설정해야 합니다. 두 접근 방식 모두 배포 복잡성을 증가시킵니다. 라이선스 파일을 배포하고 동기화해야 하며, 라이선스 서버는 유지 관리해야 할 추가 인프라 요소입니다. 마이크로서비스 아키텍처나 서버리스 배포 패턴으로 전환하는 팀들은 구성 파일 방식이 변경 불가능한 컨테이너 이미지로 깔끔하게 변환되지 않는다는 것을 알게 됩니다.

평가 정확도 요구 사항

구매를 결정하기 전에 자체 문서에서 판독 정확도를 검증해야 하는 팀은 BarcodeXpress의 평가 모드가 근본적으로 제한적이라고 생각합니다. 실제 문서 스캔 데이터를 사용하여 테스트하려면(라이브러리가 저대비 바코드, 기울어진 이미지 또는 여러 바코드가 있는 페이지를 처리하는지 확인하기 위해) 디코딩된 모든 값이 필요합니다. 일부 가려진 출력 내용은 라이브러리가 바코드를 발견했다는 사실만 보여줄 뿐, 바코드를 정확하게 읽었는지 여부는 알려주지 않습니다.

인스턴스 관리에서 정적 호출로

BarcodeXpress를 사용하려면 작업 전에 BarcodeXpress 인스턴스를 생성하고 라이선스를 받아야 합니다. IronBarcode의 정적 메서드는 인스턴스를 필요로 하지 않습니다. 마이그레이션하는 팀에는 일반적으로 생성자가 대부분 라이선스 상용구인 BarcodeService 클래스가 있으며, 마이그레이션 후에는 해당 생성자를 완전히 제거하거나 단일 라이선스 키 할당으로 줄일 수 있습니다.

BarcodeTypes 열거형 제거

모든 BarcodeXpress 판독 작업에는 검색할 기호를 열거하기 위해 BarcodeTypes 플래그 할당이 필요합니다.IronBarcode기본적으로 지원되는 모든 형식을 자동으로 감지합니다. 마이그레이션하는 동안 모든 reader.BarcodeTypes = ...과제는 교체 없이 삭제할 수 있습니다. 검색 공간을 제한해야 하는 성능상의 이유가 있는 경우 BarcodeReaderOptions에서는 형식 필터링을 필수 기본값이 아닌 명시적 옵트인(선택 사항)으로 지원합니다.

결과 속성 이름 변경

두 가지 속성 이름 변경은 모든 결과 처리 코드에 영향을 미칩니다: result.BarcodeValue는 result.Value로, result.BarcodeType는 result.Format로 바뀝니다. 솔루션 전체에 적용되는 검색 및 바꾸기 기능은 두 가지 모두를 처리합니다.IronBarcode결과에는 result.Confidence 및 result.PageNumber도 노출되는데, 이는 BarcodeXpress와 동등한 기능이 없으며 기존 결과 처리에 대한 코드 변경 없이 추가 필터링에 사용할 수 있습니다.

Docker 라이선스 구성

BarcodeXpress Docker 배포는 일반적으로 마운트된 라이선스 구성 파일을 사용합니다.IronBarcode환경 변수를 사용합니다. 마이그레이션에는 구성 파일에 대한 COPY 명령어를 제거하고 단일 환경 변수 할당을 추가하는 작업이 포함됩니다. 쿠버네티스에서 라이선스 키는 마운트된 볼륨이 아니라 파드 스펙의 비밀 참조가 됩니다.