상태 유지형 리더 아키텍처

ZXing.Net의 BarcodeReader는 각 스레드 또는 병렬 작업에 대해 새로운 인스턴스를 필요로 합니다. 다음 패턴은 동시 처리를 위한 최소한의 올바른 설정입니다.

// ZXing.Net: a new reader instance is created per iteration
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

// ZXing.Net: a new reader instance is created per iteration
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

Imports System.Collections.Concurrent
Imports System.Drawing
Imports ZXing

Parallel.ForEach(imagePaths, Sub(path)
    Dim reader = New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    }

    Using bitmap As New Bitmap(path)
        Dim result = reader.Decode(bitmap)

        If result IsNot Nothing Then
            results(path) = result.Text
        End If
    End Using
End Sub)

ThreadLocal<BarcodeReader> 패턴은 각 호출당 할당을 줄이기 위해 스레드별 하나의 인스턴스를 재사용하지만, 해제 복잡성이 추가됩니다. 어느 쪽이든, ZXing.Net에서 스레드 안전성은 호출자의 책임입니다.

상세 기능 비교

ZXing .NET 접근 방식

ZXing.Net의 BarcodeReader는 상태 저장 객체입니다. Decode가 호출되면, 내부 상태가 기록됩니다. 두 스레드가 동일한 인스턴스를 공유하는 경우 쓰기 경쟁이 발생합니다. 결과는 비결정적입니다. 다른 이미지의 결과가 나오거나, 바코드가 있는 위치에 null이 반환되거나, 예외가 발생할 수 있습니다. 올바른 접근 방식은 스레드당 하나의 리더를 생성하는 것입니다. 즉, 모든 병렬 또는 비동기 경로가 리더를 할당하고, 구성하고, 한 번 사용한 후 폐기하는 것입니다.

// ZXing.Net: one reader instance per parallel operation
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

// ZXing.Net: one reader instance per parallel operation
Parallel.ForEach(imagePaths, path =>
{
    var reader = new BarcodeReader();
    reader.Options.PossibleFormats = new List<BarcodeFormat>
    {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    };

    using var bitmap = new Bitmap(path);
    var result = reader.Decode(bitmap);

    if (result != null)
        results[path] = result.Text;
});

Imports System.Collections.Concurrent
Imports System.Drawing
Imports ZXing

Parallel.ForEach(imagePaths, Sub(path)
    Dim reader As New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.EAN_13
    }

    Using bitmap As New Bitmap(path)
        Dim result = reader.Decode(bitmap)

        If result IsNot Nothing Then
            results(path) = result.Text
        End If
    End Using
End Sub)

ThreadLocal<BarcodeReader> 패턴은 각 호출당 할당을 줄이기 위해 스레드별 하나의 리더를 재사용하지만, 여전히 각 인스턴스에서 형식 구성이 필요하며 해제 복잡성이 추가됩니다.

IronBarcode 접근법

IronBarcode의 BarcodeReader.Read는 상태 없는 정적 메소드입니다. 공유해야 할 인스턴스도 없고, 격리해야 할 인스턴스도 없으며, 보호해야 할 구성 상태도 없습니다. 동일한 호출은 여러 개의 동시 스레드에서 안전하게 실행될 수 있습니다.

// IronBarcode: static method — no instance management
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

Parallel.ForEach(imagePaths, path =>
{
    var result = BarcodeReader.Read(path, options).FirstOrDefault();
    if (result != null)
        results[path] = result.Value;
});

// IronBarcode: static method — no instance management
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

Parallel.ForEach(imagePaths, path =>
{
    var result = BarcodeReader.Read(path, options).FirstOrDefault();
    if (result != null)
        results[path] = result.Value;
});

Imports IronBarcode

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

Parallel.ForEach(imagePaths, Sub(path)
    Dim result = BarcodeReader.Read(path, options).FirstOrDefault()
    If result IsNot Nothing Then
        results(path) = result.Value
    End If
End Sub)

IronBarcode의 비동기 및 멀티스레드 바코드 판독 관련 문서는 내부 스레드 풀링 모델을 설명합니다. MaxParallelThreads 속성은 외부 조율 없이 병렬 처리 정도를 제어합니다.

ZXing .NET 접근 방식

ZXing.Net는 각 디코드 전에 reader.Options.PossibleFormats를 채우도록 요구합니다. 목록에 없는 바코드 형식은 감지되지 않으며, 오류나 경고도 표시되지 않고 부분적인 결과도 나오지 않습니다.

// ZXing.Net: PossibleFormats list controls which symbologies are decoded
var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
};
reader.Options.TryHarder = true;

using var bitmap = new Bitmap(imagePath);
var results = reader.DecodeMultiple(bitmap);

// ZXing.Net: PossibleFormats list controls which symbologies are decoded
var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
};
reader.Options.TryHarder = true;

using var bitmap = new Bitmap(imagePath);
var results = reader.DecodeMultiple(bitmap);

Imports ZXing
Imports ZXing.Common

' ZXing.Net: PossibleFormats list controls which symbologies are decoded
Dim reader As New BarcodeReader()
reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.EAN_8,
    BarcodeFormat.UPC_A,
    BarcodeFormat.DATA_MATRIX,
    BarcodeFormat.PDF_417
}
reader.Options.TryHarder = True

Using bitmap As New Bitmap(imagePath)
    Dim results = reader.DecodeMultiple(bitmap)
End Using

누락을 방지하기 위해 모든 형식을 나열하면 성능이 저하됩니다. 예상되는 형식만 나열하면 외부 소스에서 이미지가 들어올 때 누락되는 오류가 발생할 위험이 있습니다. ZXing .NET 에는 목록에 없는 형식의 바코드를 발견했다는 사실을 보고하는 메커니즘이 없습니다.

IronBarcode 접근법

IronBarcode 지원되는 50개 이상의 형식을 자동으로 감지합니다. 형식 목록은 필요하지 않으며 허용되지도 않습니다.

// IronBarcode: automatic detection across all supported formats
var results = BarcodeReader.Read(imagePath);
foreach (var barcode in results)
{
    Console.WriteLine($"{barcode.Value} ({barcode.Format})");
}

// IronBarcode: automatic detection across all supported formats
var results = BarcodeReader.Read(imagePath);
foreach (var barcode in results)
{
    Console.WriteLine($"{barcode.Value} ({barcode.Format})");
}

Imports IronBarcode

' IronBarcode: automatic detection across all supported formats
Dim results = BarcodeReader.Read(imagePath)
For Each barcode In results
    Console.WriteLine($"{barcode.Value} ({barcode.Format})")
Next

읽기 속도와 검출 철저함을 맞추는 애플리케이션에 대해, IronBarcode는 ReadingSpeed 열거형 — Faster, Balanced, Detailed, ExtremeDetail —을 제공하며, 형식 열거를 요구하지 않습니다. 속도 튜닝은 엔진이 각 이미지를 처리하는 방식에 영향을 미치지만, 어떤 이미지 형식을 고려할지는 영향을 주지 않습니다.

ZXing .NET 접근 방식

PDF 파일에 바코드가 포함된 경우, ZXing .NET 은 외부 PDF 렌더링 라이브러리가 필요합니다. 가장 일반적인 해결 방법은 PdfiumViewer를 사용하는 것인데, 이 방법은 약 20MB의 네이티브 바이너리와 호출자가 구현하고 유지 관리해야 하는 페이지 렌더링 루프를 추가합니다.

// ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
using var pdfDocument = PdfDocument.Load(pdfPath);

var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.PDF_417
};

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    string tempPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png");
    try
    {
        using var pageImage = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi);
        pageImage.Save(tempPath, ImageFormat.Png);

        using var bitmap = new Bitmap(tempPath);
        var decoded = reader.DecodeMultiple(bitmap);
        if (decoded != null)
            results.AddRange(decoded.Select(d => d.Text));
    }
    finally
    {
        File.Delete(tempPath);
    }
}

// ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
using var pdfDocument = PdfDocument.Load(pdfPath);

var reader = new BarcodeReader();
reader.Options.PossibleFormats = new List<BarcodeFormat>
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.PDF_417
};

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    string tempPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png");
    try
    {
        using var pageImage = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi);
        pageImage.Save(tempPath, ImageFormat.Png);

        using var bitmap = new Bitmap(tempPath);
        var decoded = reader.DecodeMultiple(bitmap);
        if (decoded != null)
            results.AddRange(decoded.Select(d => d.Text));
    }
    finally
    {
        File.Delete(tempPath);
    }
}

Imports System.IO
Imports System.Drawing
Imports PdfiumViewer
Imports ZXing
Imports ZXing.Common

' ZXing.Net: PDF input is handled by PdfiumViewer with a per-page render loop
Using pdfDocument As PdfDocument = PdfDocument.Load(pdfPath)

    Dim reader As New BarcodeReader()
    reader.Options.PossibleFormats = New List(Of BarcodeFormat) From {
        BarcodeFormat.QR_CODE,
        BarcodeFormat.CODE_128,
        BarcodeFormat.PDF_417
    }

    For i As Integer = 0 To pdfDocument.PageCount - 1
        Dim tempPath As String = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png")
        Try
            Using pageImage As Image = pdfDocument.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi)
                pageImage.Save(tempPath, Imaging.ImageFormat.Png)

                Using bitmap As New Bitmap(tempPath)
                    Dim decoded = reader.DecodeMultiple(bitmap)
                    If decoded IsNot Nothing Then
                        results.AddRange(decoded.Select(Function(d) d.Text))
                    End If
                End Using
            End Using
        Finally
            File.Delete(tempPath)
        End Try
    Next
End Using

이 패턴에는 실제 오류 모드가 있습니다. DPI 구성 오류로 인해 오류 메시지가 표시되지 않고, 보안 환경에서 임시 파일 권한이 제대로 작동하지 않으며, PdfiumViewer 네이티브 라이브러리는 별도의 배포 관리가 필요하고, 추가 구성 없이는 Linux에서 설치가 제대로 작동하지 않습니다.

IronBarcode 접근법

IronBarcode 외부 프로그램 없이 모든 페이지, 모든 형식의 PDF에서 바코드를 직접 읽어냅니다 . 같은 BarcodeReader.Read 호출이 PDF 경로를 직접 받습니다:

// IronBarcode: one call processes every page of the PDF
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}");

// IronBarcode: one call processes every page of the PDF
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}");

Imports IronBarcode

' IronBarcode: one call processes every page of the PDF
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}")
Next

페이지 열거, DPI 구성, 임시 파일, 애플리케이션과 함께 배포해야 할 별도의 라이브러리가 필요 없습니다.

ZXing .NET 접근 방식

핵심 ZXing.Net 패키지는 디코딩 로직을 제공하지만 이미지 로딩은 제공하지 않습니다. 호출자는 배포 대상에 따라 바인딩을 선택해야 합니다.

실질적인 결과는 System.Drawing.Bitmap을 사용하는 윈도우 코드가 리눅스에서 컴파일되거나 실행되지 않는다는 것입니다. 컨테이너화를 위해서는 바인딩 패키지를 변경하고 이미지 로딩 코드를 다시 작성해야 합니다.

// Windows binding path — uses System.Drawing
using ZXing.Windows.Compatibility;
using System.Drawing;

var reader = new BarcodeReader();
using var bitmap = new Bitmap(imagePath);
var result = reader.Decode(bitmap);

// Windows binding path — uses System.Drawing
using ZXing.Windows.Compatibility;
using System.Drawing;

var reader = new BarcodeReader();
using var bitmap = new Bitmap(imagePath);
var result = reader.Decode(bitmap);

Imports ZXing.Windows.Compatibility
Imports System.Drawing

Dim reader As New BarcodeReader()
Using bitmap As New Bitmap(imagePath)
    Dim result = reader.Decode(bitmap)
End Using

// Cross-platform path — different package, different API
using ZXing.ImageSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

var reader = new BarcodeReader<Rgba32>();
using var image = Image.Load<Rgba32>(imagePath);
var result = reader.Decode(image);

// Cross-platform path — different package, different API
using ZXing.ImageSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

var reader = new BarcodeReader<Rgba32>();
using var image = Image.Load<Rgba32>(imagePath);
var result = reader.Decode(image);

Imports ZXing.ImageSharp
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats

Dim reader As New BarcodeReader(Of Rgba32)()
Using image As Image(Of Rgba32) = Image.Load(Of Rgba32)(imagePath)
    Dim result = reader.Decode(image)
End Using

리눅스 호스트에서 윈도우 바인딩을 사용할 때도 Docker 이미지에 libgdiplus가 필요하며, 이는 컨테이너에 약 50MB를 추가합니다.

IronBarcode 접근법

IronBarcode 모든 플랫폼용 패키지를 하나로 묶어서 배송합니다. 같은 BarcodeReader.Read(path) 호출이 윈도우, 리눅스, macOS, Docker 컨테이너 내에서 동일하게 컴파일 및 실행됩니다. 별도의 패키지 바인딩, 플랫폼 조건부 설정, 추가 시스템 종속성이 필요하지 않습니다. .NET 애플리케이션을 컨테이너화하는 팀을 위해 IronBarcode Docker 및 Linux 설정 가이드에서는 단일 패키지 배포 패턴을 자세히 다룹니다.

ZXing .NET 접근 방식

ZXing.Net의 BarcodeWriter 클래스는 작성자 객체를 생성하고, 인코딩 옵션을 수락하며 Write를 호출하고, 호출자가 System.Drawing.Imaging을 사용하여 수동으로 저장해야 하는 Bitmap를 반환합니다:

// ZXing.Net: create writer, set options, call Write, save Bitmap
using ZXing;
using ZXing.Common;
using ZXing.Windows.Compatibility;
using System.Drawing.Imaging;

var writer = new BarcodeWriter
{
    Format = BarcodeFormat.CODE_128,
    Options = new EncodingOptions
    {
        Width = 300,
        Height = 100,
        Margin = 10
    }
};

using var bitmap = writer.Write("PRODUCT-001");
bitmap.Save("output.png", ImageFormat.Png);

// ZXing.Net: create writer, set options, call Write, save Bitmap
using ZXing;
using ZXing.Common;
using ZXing.Windows.Compatibility;
using System.Drawing.Imaging;

var writer = new BarcodeWriter
{
    Format = BarcodeFormat.CODE_128,
    Options = new EncodingOptions
    {
        Width = 300,
        Height = 100,
        Margin = 10
    }
};

using var bitmap = writer.Write("PRODUCT-001");
bitmap.Save("output.png", ImageFormat.Png);

Imports ZXing
Imports ZXing.Common
Imports ZXing.Windows.Compatibility
Imports System.Drawing.Imaging

Dim writer As New BarcodeWriter With {
    .Format = BarcodeFormat.CODE_128,
    .Options = New EncodingOptions With {
        .Width = 300,
        .Height = 100,
        .Margin = 10
    }
}

Using bitmap = writer.Write("PRODUCT-001")
    bitmap.Save("output.png", ImageFormat.Png)
End Using

PNG 또는 JPEG가 아닌 형식으로 저장, PDF에 저장, 또는 HTTP 응답을 위한 이진 출력 생성 모두 호출자가 구현해야 하는 추가 System.Drawing이 필요합니다.

IronBarcode 접근법

IronBarcode의 BarcodeWriter.CreateBarcode는 유창한 체인을 통해 빌트인 출력 메소드를 제공하는 GeneratedBarcode 객체를 반환합니다:

// IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .SaveAsPng("output.png");

// IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .SaveAsPng("output.png");

Imports IronBarCode

' IronBarcode: create and save in one fluent chain
BarcodeWriter.CreateBarcode("PRODUCT-001", BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .SaveAsPng("output.png")

GeneratedBarcode 객체는 또한 .ToPngBinaryData(), .ToJpegBinaryData(), .ToStream(), 및 .SaveAsPdf()를 공개하며 — 이는 ZXing.Net이 System.Drawing를 사용하여 직접 구현해야 하는 출력 대상입니다.

동시 처리 및 고처리량 처리

단일 스레드 콘솔 애플리케이션에서는 정상적으로 작동하는 ZXing .NET 통합 기능이 동일한 코드를 동시 요청을 처리하는 ASP.NET Core 컨트롤러나 병렬로 배치를 처리하는 백그라운드 작업으로 옮기면 비결정적인 동작을 보일 수 있습니다. ZXing .NET 에서 요구하는 스레드별 인스턴스 패턴은 모든 요청 또는 병렬 작업이 구성된 디코더 세트가 포함된 전체 리더 객체를 할당하고, 한 번 사용한 후 폐기한다는 것을 의미합니다. 요청량이 증가함에 따라 이러한 할당 압력은 측정 가능해집니다. 이러한 단계에 도달하는 팀, 특히 물류, 창고 관리 또는 문서 처리 분야에서 높은 처리량의 스캔 파이프라인을 운영하는 팀은 모든 호출자에게 이러한 오버헤드를 부과하지 않는 스레딩 모델을 가진 라이브러리를 찾는 경우가 많습니다.

혼합 형식 문서 스캔

타사로부터 문서를 받는 애플리케이션은 형식 목록을 구성할 때 예상하지 못했던 바코드 형식을 자주 접하게 됩니다. Code 128용으로 구축된 배송 연동 시스템은 QR 코드를 사용하여 파트너로부터 배송 정보를 수신합니다. PDF 417에 맞춰 구성된 의료 기록 시스템이 새로운 장비 공급업체의 Data Matrix 심볼을 사용하게 되었습니다. ZXing .NET 에서는 이러한 각 경우에 디코딩 오류가 아닌 null 값이 조용히 반환되므로, 하위 처리 과정에서 오류가 발생할 때까지 해당 오류가 드러나지 않을 수 있습니다. 특히 바코드 누락이 비즈니스에 영향을 미치는 상황에서, 형식 오류로 인해 곤란을 겪었던 팀들은 형식 ​​목록 유지 관리 비용과 형식을 자동으로 감지하는 라이브러리 도입 비용을 비교 검토하기 시작합니다.

PDF 바코드 추출

많은 업무 관련 문서들이 PDF 형식으로 도착합니다. 예를 들어 송장, 선적 서류, 환자 기록, 규정 준수 인증서 등이 있습니다. ZXing .NET 은 이러한 파일을 직접 읽을 수 없습니다. PDF에서 바코드를 추출해야 하는 팀은 ZXing .NET 기반의 렌더링 파이프라인을 구축하고 유지 관리하게 됩니다. 여기에는 PDF 라이브러리 선택, 네이티브 종속성 관리, 페이지 렌더링 루프 구현, DPI 구성 처리, 임시 파일 정리 로직 작성 등이 포함됩니다. 해당 인프라 코드는 바코드 로직이 아닙니다. 이 라이브러리는 ZXing .NET 에서 지원하는 비트맵 이미지와 실제 비즈니스 문서의 형식(PDF) 간의 격차를 해소하기 위해 존재합니다. 특히 PDF 라이브러리 자체에 라이선스, 배포 및 플랫폼 관련 고려 사항이 있는 경우, 이러한 연결을 유지 관리해야 하는 팀은 전체 입력 표면을 처리하는 단일 라이브러리를 선호하는 경우가 많습니다.

결합 복잡성 감소

Windows에서 시작하여 나중에 Linux 또는 Docker에 배포하는 프로젝트는 ZXing.Net의 바인딩 파편화 문제를 직접적으로 겪게 됩니다. Windows 바인딩 패키지는 크로스 플랫폼 ImageSharp 바인딩과 다른 API를 사용하며, 둘 사이를 전환하려면 NuGet 참조와 이미지 로딩 코드를 모두 변경해야 합니다. .NET 애플리케이션을 컨테이너화하는 것이 일반적인 팀이나 개발자 컴퓨터(Windows 또는 macOS)와 프로덕션 서버(Linux)에서 동일한 코드베이스를 실행하는 팀은 이미지 로딩을 위한 두 가지 코드 경로를 유지 관리하는 것이 스캔 계층의 향후 변경 사항에 마찰을 일으킨다는 사실을 알게 됩니다.

바코드 리더 인스턴스화 제거

코드베이스의 모든 new BarcodeReader() 호출이 마이그레이션 동안 제거됩니다. 리더 생성, 형식 구성, 이미지 로딩, 디코딩 호출 등 인스턴스화 패턴은 단일 정적 메서드 호출로 통합됩니다. using IronBarCode;로 대체된 파일과, ZXing, ZXing.Common, ZXing.Windows.Compatibility, ZXing.ImageSharp, SixLabors.ImageSharp 네임스페이스를 가져오는 파일이 제거되고 단일 using IronBarCode;로 대체됩니다.

PossibleFormats 구성 제거

reader.Options.PossibleFormats 할당 블록이 각 호출 위치에서 삭제됩니다. IronBarcode는 자동 형식 감지를 수행하며 형식 제한 목록을 허용하지 않습니다. TryHarder 플래그는 BarcodeReaderOptions의 ReadingSpeed 속성으로 대체되며, 이는 형식 범위를 좁히지 않고 검출 노력을 제어합니다.

바인딩 패키지 정리

마이그레이션은 ZXing.Net, ZXing.Net.Bindings.Windows.Compatibility, 모든 ZXing.Net.Bindings.ImageSharp 변형 (.V2 / .V3), 그리고 PDF 읽기를 지원하기 위해 추가된 모든 PdfiumViewer 패키지를 제거합니다. 리눅스에서 윈도우 바인딩을 통해 System.Drawing를 지원하려고 Docker파일에 추가된 libgdiplus가 있는 경우, 해당 줄도 제거됩니다.IronBarcode Docker 이미지에 플랫폼별 종속성이 필요하지 않습니다.