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

상세 기능 비교

바코드 접근 방식

Barcoder는 형식 선택 경로를 별도의 네임스페이스에 있는 별도의 인코더 클래스를 통해 지정합니다. 형식을 전환한다는 것은 새로운 using 지시문을 추가하고 다른 메서드 서명을 가진 다른 클래스를 사용하는 것을 의미합니다:

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

각 인코더는 고유한 파라미터 계약을 가지고 있습니다. 기존 프로젝트에 새 형식을 추가하는 것은 단순히 단어 하나만 바꾸는 것이 아닙니다. 새로운 네임스페이스를 가져오고, 새로운 클래스를 배우고, 새로운 매개변수를 이해해야 합니다.

IronBarcode접근법

IronBarcode는 모든 형식 선택을 통합된 BarcodeEncoding 클래스의 BarcodeWriter 열거형을 통해 라우팅합니다. 새로운 형식을 추가하는 것은 열거형 값에서 단어 하나만 변경하는 것입니다.

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

실제 운영 환경에서 사용하려면 애플리케이션 시작 시 라이선스 키를 추가하십시오.

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

IronBarcode 바코드 생성 관련 문서에는 스타일, 여백, 색상 사용자 지정 등 모든 생성 옵션이 자세히 설명되어 있습니다.

바코드 접근 방식

바코드의 인코딩과 렌더링 분리는 아키텍처 원칙에 부합하지만, 출력 형식이 변경될 때마다 오버헤드가 발생합니다. 파일로 저장하려면 FileStream을 열어야 합니다. 바이너리 데이터를 가져오려면 MemoryStream를 열고 ToArray()를 호출해야 합니다. 모든 출력 시나리오에서는 옵션 객체를 사용하여 렌더러를 구성해야 합니다.

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

크기 조절은 간접적으로 이루어집니다: PixelSize는 바코드 모듈 크기의 배율이며 직접적인 너비 및 높이 사양이 아닙니다.

IronBarcode접근법

IronBarcode는 연쇄 메서드 호출을 통해 모든 출력 양식에 도달할 수 있는 GeneratedBarcode 객체를 반환합니다. 렌더러 구축도, 스트림 관리도 필요 없습니다.

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height)는 명시적인 픽셀 치수를 취하고 동일한 객체에서 모든 출력 메서드와 연결합니다.

바코드 접근 방식

바코드 판독 및 해독 기능이 없습니다. 이 라이브러리에는 API가 없으며, API 출시 계획도 없고, 라이브러리 내에서 해결할 수 있는 방법도 없습니다. 애플리케이션에서 바코드를 읽어야 하는 경우, Barcoder와 함께 별도의 라이브러리(자체 API 인터페이스와 버전 관리를 위한 별도의 NuGet 종속성)를 추가해야 합니다. 즉, 최소한 두 가지 읽기 관련 종속성이 필요하다는 뜻입니다. 하나는 바코드 생성을 위한 Barcoder이고, 다른 하나는 읽기를 위한 다른 도구입니다.

IronBarcode접근법

IronBarcode 동일한 패키지와 일관된 API 패턴을 사용하여 바코드 생성과 읽기를 모두 지원합니다. BarcodeReader.Read() 메서드는 기본적으로 이미지 파일, 바이트 배열, 스트림 및 PDF를 허용합니다:

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// PDF에서 읽기 — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// PDF에서 읽기 — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine(result.Value)
    Console.WriteLine(result.Format)
Next

' PDF에서 읽기 — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

PDF 읽기는 기본적으로 지원되므로 중간 이미지 추출이나 변환 라이브러리, 추가 패키지가 필요하지 않습니다. IronBarcode 바코드 판독 관련 문서에는 여러 페이지로 구성된 PDF, 관심 영역 판독 및 성능 튜닝에 대한 내용이 포함되어 있습니다.

읽기 능력이 필수 요건에 추가되었습니다.

많은 프로젝트는 라벨 인쇄, 문서용 코드 생성, 보고서에 바코드 삽입과 같은 순수한 생성 파이프라인으로 시작됩니다. 바코드는 이러한 프로젝트의 초기 단계에서 사용됩니다. 나중에 동일한 애플리케이션에서 수신 바코드를 검증하거나, 스캔한 문서를 처리하거나, 업로드된 PDF에서 바코드를 디코딩해야 하는 경우, Barcoder는 이를 위한 해결책을 제공하지 않습니다. 팀은 두 번째 라이브러리를 평가하고, 해당 API를 학습하고, NuGet 버전을 별도로 관리하고, 두 라이브러리 간의 통합 인터페이스를 처리해야 합니다. 이 단계에 도달한 팀은 두 개의 별도 바코드 종속성을 유지하는 대신 양쪽 모두를 처리하는 라이브러리로 통합하는 경우가 많습니다.

.NET Framework호환성 문제

Barcoder.Renderer.Image.NET Framework지원이 중단되었습니다..NET Framework4.x에서 서비스 또는 데스크톱 애플리케이션을 유지 관리하는 팀이 정기적인 종속성 유지 관리 중에 이미지 렌더러 패키지를 업데이트하면 빌드 오류가 발생합니다. 이는 설정 오류가 아니라 라이브러리 측의 플랫폼 지원 결정입니다.IronBarcode특별한 패키징이나 대상에 따른 조건부 종속성 없이.NET Framework4.6.2부터 .NET 9까지 지원합니다.

패키지 버전 차이로 인해 조정 문제가 발생합니다.

코드-50999--@@와 @@--코드-51000--@@는 독립적으로 버전이 관리되므로 종속성을 새로 고치는 동안 한 쪽을 업데이트하면 미묘한 비호환성이 발생할 수 있습니다. 여러 프로젝트가 있는 저장소에서 각 프로젝트가 서로 다른 버전의 렌더러 패키지를 사용하는 경우, 프로젝트 간 일관된 동작을 보장하는 것은 팀 규모가 커질수록 더욱 어려워지는 조정 문제가 됩니다.IronBarcode로 통합된 팀들은 하나의 패키지와 하나의 버전만 관리함으로써 이러한 문제가 완전히 해결되었다고 보고합니다.

포맷 적용 범위는 시간이 지남에 따라 확대됩니다.

프로젝트는 Code128 라벨로 시작하여 나중에 고객용 링크를 위한 QR 코드를 추가하고, 규정 준수 요구 사항을 충족하기 위해 DataMatrix를 추가할 수 있습니다. Barcoder를 사용하면 형식을 추가할 때마다 새 네임스페이스를 가져와야 하고, 메서드 매개변수가 다른 다른 인코더 클래스를 생성해야 하며, 경우에 따라 새 NuGet 패키지를 추가해야 합니다. IronBarcode에서 형식을 추가하는 것은 기존 호출의 BarcodeEncoding 열거형 값을 변경하는 것입니다. 바코드 형식 지원 범위를 확장하는 로드맵을 가진 팀은 열거형 기반 모델이 유지 관리하기 훨씬 쉽다는 것을 알게 됩니다.

MAUI 및 크로스 플랫폼 배포 요구 사항

Barcoder는 MAUI, Docker, AWS Lambda 또는 Azure 배포에 대한 지원을 문서화하지 않습니다. 크로스 플랫폼 MAUI 애플리케이션을 구축하거나 서버리스 인프라에 바코드 처리를 배포하는 팀은 Barcoder의 문서와 테스트가 이러한 목표를 다루지 않는다는 것을 알게 됩니다.IronBarcodeiOS, Android, Windows, macOS MAUI 대상, Docker 컨테이너 및 주요 클라우드 플랫폼 전반에 걸친 배포를 문서화하고 적극적으로 테스트합니다.

IBarcode에서 GeneratedBarcode로 유형 변경

코드-51004--@@@ 변수를 저장하고 나중에 렌더러에 전달하는 바코드 코드는 리팩터링해야 합니다. IronBarcode에서 GeneratedBarcode는 별도의 렌더러 단계가 없이 자체 출력 메서드를 전달합니다. 현재 IBarcode을 허용하는 모든 메서드 시그니처는 GeneratedBarcode을 허용하도록 변경되어야 하며, 해당 메서드 내부의 렌더링 호출은 .SaveAsPng() 또는 .ToPngBinaryData()처럼 직접 호출이 되어야 합니다. 유형 시스템은 컴파일 중에 업데이트가 필요한 모든 위치를 표시합니다(IBarcode는 바코드 패키지가 제거된 후에는 해결되지 않습니다).

PixelSize 직접적인 등가물이 없음

바코드의 PixelSize는 명시적인 픽셀 치수가 아니라 바코드의 자연 모듈 크기에 대한 배율입니다. 출력 너비는 바코드 내용, 형식 및 배율의 조합에 따라 달라집니다. IronBarcode는 명시적인 픽셀 치수와 함께 .ResizeTo(width, height)를 사용합니다. 마이그레이션하는 동안 기존 바코드 코드가 생성하는 실제 출력 치수를 측정하고 .ResizeTo() 호출에서 해당 값을 사용합니다:

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

네임스페이스 통합

바코드 프로젝트에는 사용된 형식당 하나씩 using Barcoder.* 문이 누적됩니다. 마이그레이션 중에는 이 모든 것이 하나의 using IronBarCode;로 축소됩니다. 솔루션 전체에서 using Barcoder을 검색하면 업데이트가 필요한 모든 파일이 식별됩니다. 영향을 받는 파일 수는 일반적으로 팀이 예상하는 것보다 많습니다. 바코드 형식을 사용하는 각 파일은 자체 형식별 네임스페이스를 가져오기 때문입니다.

SVG 출력 경로 변경

코드-51018--@@ 및 @@--코드-51019--@@ 클래스를 사용하는 프로젝트는 렌더러 파이프라인을 @@--코드-51020--@@의 직접 메서드 호출로 대체합니다:

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

모든 SVG 렌더링 사이트가 마이그레이션되면 Barcoder.Renderer.Svg 패키지를 제거할 수 있습니다.