바코드 라이브러리 vs IronBarcode: C# 바코드 라이브러리 비교

바코드립 코어 생성 패턴

표준 바코드립 생성 워크플로에는 인스턴스를 생성하고 속성을 구성한 다음 Encode()를 호출해야 합니다:

@@--코드-50851--@@`csharp // BarcodeLib using BarcodeLib; using System.Drawing; using System.Drawing.Imaging;

var b = new Barcode(); b.IncludeLabel = true; b.Width = 300; b.Height = 100; Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345"); img.Save("barcode.png", ImageFormat.Png); @@--코드-50851--@@`

이것이 전체 생성 워크플로입니다. 속성 설정자 패턴은 Encode() 호출 이전의 인스턴스에서 모든 구성이 이루어지고 반환 값은 System.Drawing.Image로 별도로 저장하거나 바이트로 변환해야 하는 디자인입니다.

상세 기능 비교

바코드립 접근 방식

BarcodeLib를 사용하려면 Encode()를 호출하기 전에 인스턴스를 구성하고 속성을 설정해야 합니다. 출력은 System.Drawing.Image 개체입니다:

@@--코드-50851--@@`csharp using BarcodeLib; using System.Drawing; using System.Drawing.Imaging;

public byte[] GenerateCode128(string data) { var b = new Barcode(); b.IncludeLabel = true; b.Width = 300; b.Height = 100; Image img = b.Encode(TYPE.CODE128, data);

using var ms = new MemoryStream();
img.Save(ms, ImageFormat.Png);
return ms.ToArray();

} @@--코드-50851--@@`

코드 50834--@@ 반환 유형은 바이트 배열 출력에 @@--코드 50835--@@ 중개자가 필요하다는 의미입니다. IncludeLabel 속성은 부울 토글입니다. BarcodeLib은 인코딩된 데이터 문자열을 바 아래에 표시되는 레이블로 자동 렌더링합니다.

IronBarcode접근법

IronBarcode의 생성 방식은 완전히 정적입니다. 코드 50837--@@ 이후의 구성 체인과 출력 메서드는 직접 체인을 종료합니다:

@@--코드-50851--@@`csharp // NuGet: dotnet add package IronBarcode using IronBarCode;

public byte[] GenerateCode128(string data) { return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) .ResizeTo(300, 100) .AddAnnotationTextBelowBarcode(data) .ToPngBinaryData(); } @@--코드-50851--@@`

.ToPngBinaryData()은 중간 Image 또는 MemoryStream 객체 없이 바이트 배열을 직접 반환합니다. .AddAnnotationTextBelowBarcode()는 레이블 문자열을 명시적으로 사용하여 막대 아래에 표시되는 텍스트를 제어할 수 있습니다. 고급 바코드 생성 시나리오에 대해서는 IronBarcode 바코드 생성 설명서를 참조하십시오.

바코드립 접근 방식

BarcodeLib에는 읽기 API가 없습니다. Decode(), Scan() 또는 ReadBarcode() 방식은 허용되지 않습니다. 해당 기능이 없는 것은 버전 차이 때문이 아닙니다. 애초에 읽기 기능은 라이브러리 설계에 포함된 적이 없습니다. 디코딩 메서드를 호출하려는 모든 시도는 컴파일 오류를 발생시킵니다.

@@--코드-50851--@@`csharp // 바코드립 — reading does not exist using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method // var value = b.Decode("barcode.png"); // CS1061: no definition // var value = b.Scan("barcode.png"); // CS1061: no definition // var value = b.ReadBarcode("barcode.png"); // CS1061: no definition

// The only thing you can do is generate: Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345"); // this works @@--코드-50851--@@`

BarcodeLib과 함께 바코드 생성 및 읽기 기능이 모두 필요한 팀은 일반적으로 ZXing .NET 과 같은 두 번째 라이브러리를 추가해야 하는데, 이로 인해 자체적인 종속성 관리 부담과 유지 관리해야 할 두 번째 API 표면이 발생합니다.

IronBarcode접근법

코드 50845--@@는 이미지 파일, PDF 파일, 스트림 및 @@--코드 50846--@@ 개체를 허용합니다. PDF 파일을 읽는 데에는 별도의 라이브러리가 필요하지 않습니다.

@@--코드-50851--@@`csharp using IronBarCode;

// Read from an image var results = BarcodeReader.Read("barcode.png"); Console.WriteLine(results.First().Value); // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed var pdfResults = BarcodeReader.Read("invoice-batch.pdf"); foreach (var result in pdfResults) { Console.WriteLine($"Page {result.PageNumber}: {result.Value}"); }

// Tune reading for speed vs. thoroughness var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced, ExpectMultipleBarcodes = true }; var multiResults = BarcodeReader.Read("warehouse-scan.png", options); @@--코드-50851--@@`

ReadingSpeed 열거형은 대용량 시나리오에 맞게 스캔 성능을 조정할 수 있습니다. 읽기 구성에 대한 자세한 내용은 IronBarcode 읽기 설명서를 참조하십시오.

바코드립 접근 방식

BarcodeLib 3.x부터 이 라이브러리는 System.Drawing.Common을 대체하는 그래픽 백엔드로 SkiaSharp를 도입했으며, 이는 .NET 6 이후 Windows전용이 되었습니다. BarcodeLib은 특정 SkiaSharp 버전 범위에 핀으로 고정되어 있습니다. 프로젝트가 이미 다른 종속성(SkiaSharp.Views.Maui 및 Microsoft.Maui.Graphics를 사용하는 MAUI 프로젝트에서 일반적)을 통해 SkiaSharp를 사용하는 경우, 해결된 버전이 BarcodeLib의 예상 범위를 벗어날 수 있습니다. 그 결과 최소한 NU1608 경고가 발생하고, 최악의 경우 런타임 시 어셈블리 바인딩 오류가 발생합니다.

@@--코드-50851--@@ 경고 NU1608: 종속성 제약 조건을 벗어난 패키지 버전이 감지되었습니다. BarcodeLib 3.1.5는 SkiaSharp (>= 2.88.7 && < 2.89.0)를 필요로 합니다. SkiaSharp 3.116.1 버전 문제가 해결되었습니다. @@--코드-50851--@@

명시적인 패키지 참조를 통해 해결 방법을 강제로 적용하는 것은 복잡성을 증가시키지만 보장은 없습니다.

@@--코드-50851--@@`xml

@@--코드-50851--@@`

명시적인 재정의가 있더라도 호환성은 BarcodeLib의 내부 API 호출이 고정된 버전에서 노출하는 내용과 일치하는지에 따라 달라집니다. 프로젝트에 중요한 일정에 맞춰 문제를 해결해 줄 것을 보장하는 지원 계약은 없습니다.

IronBarcode접근법

IronBarcode SkiaSharp 종속성 그래프를 애플리케이션 코드와 공유하지 않습니다. 버전 협상을 관리할 필요도 없고, NU1608 오류를 진단할 필요도 없으며, SkiaSharp 버전 확인과 관련된 런타임 어셈블리 바인딩 위험도 없습니다. MAUI 프로젝트, Blazor 프로젝트 및 SkiaSharp에 의존하는 기타 모든 애플리케이션은 버전 충돌 없이IronBarcode설치할 수 있습니다. MAUI 관련 통합 패턴에 대해서는 IronBarcode MAUI 문서를 참조하십시오.

읽기 요구 사항이 표시됩니다

수개월 동안 배송 라벨을 생성해 온 시스템에 새로운 요구 사항이 생겼습니다. 바로 공급업체에서 반송된 라벨도 처리해야 한다는 것입니다. 창고 통합 시스템은 입고 화물 명세서에서 바코드를 분석해야 합니다. 문서 관리 시스템은 스캔한 PDF 파일의 바코드를 색인화해야 합니다. BarcodeLib은 이러한 요구 사항을 충족할 수 없습니다. 읽기 API가 존재하지 않기 때문입니다. 개발팀은 BarcodeLib과 함께 ZXing .NET 을 추가하는 방안을 검토하고, 두 라이브러리 유지 관리 부담과 두 개의 별도 종속성 그래프를 고려한 결과, 단일 NuGet 설치로 생성과 읽기를 모두 처리하는 라이브러리를 사용하는 것이 더 깔끔한 방법이라고 판단했습니다.

스키아샤프, 마우이 프로젝트에서의 갈등

한 팀이 기존 MAUI 애플리케이션에 BarcodeLib을 추가했는데, 복원 과정에서 즉시 NU1608 경고가 발생했습니다. 이들은 BarcodeLib의 예상 SkiaSharp 범위와 MAUI에서 요구하는 버전 간의 버전 불일치를 조사하고, 명시적인 <PackageReference> 오버라이드를 추가하여 해결을 강제하고 빌드가 통과되도록 합니다. 그러면 SkiaSharp의 네이티브 바이너리가 잘못된 버전을 로드할 때 기기에서 런타임 오류가 발생합니다. 이 문제를 해결하려면 어셈블리 바인딩 로그에 대한 심층적인 조사가 필요합니다.IronBarcode로 전환하면 호환되는 SkiaSharp 버전을 찾는 것이 아니라 공유 종속성을 완전히 제거함으로써 충돌의 근본 원인을 해결할 수 있습니다.

PDF 바코드 처리 필요

송장, 작업 지시서, 배송 명세서 등 바코드가 포함된 PDF 문서를 생성하는 애플리케이션은 후속 처리 과정에서 해당 바코드를 다시 읽어야 하는 경우가 있습니다. BarcodeLib은 바코드 이미지를 생성하지만 PDF를 지원하지 않습니다. BarcodeLib을 사용하여 PDF에서 바코드를 읽으려면 먼저 별도의 PDF 라이브러리를 사용하여 PDF를 이미지로 렌더링한 다음, 해당 이미지를 별도의 읽기 라이브러리에 전달해야 합니다. IronBarcode는 전체 체인을 기본적으로 처리합니다: BarcodeReader.Read("file.pdf")는 모든 페이지를 탐색하고 중간 렌더링 단계 없이 감지된 모든 바코드를 반환합니다.

QR 코드 기능은 기본 단계를 넘어 발전하고 있습니다.

처음에는 기본적인 QR 코드 생성만 필요했던 프로젝트가 시간이 지나면서 로고 삽입, 색상 맞춤 설정 또는 오류 수정 수준 구성과 같은 추가 기능이 필요하게 되는 경우가 많습니다. BarcodeLib은 TYPE.QR_Code을 통해 QR 코드를 지원하지만 표준 Width, Height 및 IncludeLabel 속성 이외의 옵션은 제공하지 않습니다. IronBarcode의 QRCodeWriter는 체인 방식을 통해 로고 삽입, 색상 제어 및 오류 수정 튜닝을 노출합니다. 바코드리브의 기본 구현에서 지원하는 범위를 넘어서는 QR 코드 요구 사항을 가진 팀은 기능 부족으로 인해 마이그레이션을 결정하는 경우가 많습니다.

인스턴스 API에서 정적 Fluent API로

바코드 라이브러리 코드는 Barcode 인스턴스 생성, 속성 설정, Encode() 호출과 같은 변경 가능한 객체 패턴을 사용합니다. IronBarcode는 BarcodeWriter.CreateBarcode() 호출, 구성 메서드 연쇄, 출력 메서드로 종료와 같은 정적인 유창한 패턴을 사용합니다. 코드 50884--@@ 인스턴스를 필드로 저장하거나 메서드 간에 전달하는 기존 코드는 재구조화가 필요합니다. 일반적인 변경 사항은 속성 설정 블록을 메서드 체인으로 대체하는 것입니다.

@@--코드-50851--@@csharp // The property setters on b become chained methods BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) .ResizeTo(300, 100) .AddAnnotationTextBelowBarcode(data) .SaveAsPng(outputPath); @@--코드-50851--@@

System.Drawing.Image를 직접 출력

바코드 라이브러리는 System.Drawing.Image를 반환하며, 바이트 생성에는 MemoryStream가 필요합니다. 코드 50887--@@ 또는 @@--코드 50888--@@에 입력된 모든 코드는 업데이트가 필요합니다. IronBarcode의 유창한 체인은 원하는 출력 형식(.SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData())으로 직접 종료되므로 중간 이미지 개체와 MemoryStream 단계가 필요 없습니다.

TYPE Enum을 BarcodeEncoding Enum으로 변환

BarcodeLib은 TYPE 클래스와 TYPE.CODE128와 같은 대문자 상수를 사용합니다. IronBarcode는 BarcodeEncoding 열거형과 BarcodeEncoding.Code128와 같은 파스칼 대소문자 값을 사용합니다. 값들이 직접적으로 대응됩니다. TYPE\. 파일에서 .cs를 검색하면 업데이트가 필요한 모든 항목을 식별하고, 체계적인 찾기 및 바꾸기를 통해 일반적인 형식을 다룹니다: @@--코드-50899--@@ → @@--코드-50900--@@, @@--코드-50901--@@ → @@--코드-50902--@@, @@--코드-50903--@@ → @@--코드-50904--@@, @@--코드-50905--@@ → @@--코드-50906--@@ 등입니다.

SkiaSharp 참조 정리

BarcodeLib의 NU1608 경고를 해결하기 위해서만 <PackageReference Include="SkiaSharp"> 항목을 명시적으로 추가한 프로젝트는 IronBarcode로 전환한 후 이러한 오버라이드를 제거할 수 있습니다. dotnet list package --include-transitive 명령은 제거하기 전에 프로젝트의 다른 패키지에서 SkiaSharp가 여전히 필요한지 여부를 확인합니다.