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

타입 열거형 설계 경계

Type 열거형은 NetBarcode가 생성할 수 있는 항목의 권위 있는 목록입니다. 살펴보면 도서관의 규모가 드러납니다.

// 넷바코드 Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

// 넷바코드 Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

' 넷바코드 Type enum — complete list as of v1.8
Public Enum Type
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39Extended
    Code93
    EAN8
    EAN13
    UPCA
    UPCE
    Codabar
    ITF
    MSI
End Enum

' These entries do not exist — attempting to use them produces a BC30002 compile error:
' Type.QRCode      — does not exist
' Type.DataMatrix  — does not exist
' Type.PDF417      — does not exist
' Type.Aztec       — does not exist

이는 풀 리퀘스트를 기다리는 누락된 기능이 아닙니다. 해당 열거형에는 1차원 항목이 14개 있으며, 이는 라이브러리의 의도된 범위를 반영합니다. QR 코드, DataMatrix, PDF417또는 아즈텍 형식이 필요한 모든 애플리케이션은 해당 형식을 제공하기 위한 별도의 패키지를 구매해야 합니다.

상세 기능 비교

넷바코드 접근법

NetBarcode는 Type 열거 형식을 통해 14개의 선형 바코드 형식을 제공합니다. 해당 범위 내에서 형식 선택은 간단합니다. 적절한 열거형 멤버를 생성자에 전달하면 됩니다. 경계 또한 명확합니다. 열거형 범위를 벗어난 형식을 사용하려고 하면 컴파일 오류가 발생합니다.

// 넷바코드 — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// 넷바코드 — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

// 넷바코드 — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// 넷바코드 — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

Imports NetBarcode

Dim code128 As New Barcode("12345678901234", Type.Code128)
code128.SaveImageFile("shipping.png")

Dim ean13 As New Barcode("5901234123457", Type.EAN13)
ean13.SaveImageFile("product.png")

' 넷바코드 — formats that produce CS0117 compile errors
' Dim qr As New Barcode("data", Type.QRCode)     ' error CS0117
' Dim dm As New Barcode("data", Type.DataMatrix) ' error CS0117
' Dim p417 As New Barcode("data", Type.PDF417)   ' error CS0117
' Dim aztec As New Barcode("data", Type.Aztec)   ' error CS0117

이러한 경계가 제약 조건이 되는 산업에는 의약품 추적(FDA 2D 바코드 의무화에 따른 데이터매트릭스 필요), 항공권 탑승권(Aztec), 물류 명세서(PDF417) 및 모바일 마케팅(QR 코드)이 포함됩니다. 이러한 요구 사항 각각으로 인해 NetBarcode는 독립형 솔루션으로 사용할 수 없습니다.

IronBarcode접근법

IronBarcode는 지원되는 모든 형식을 동일한 BarcodeWriter.CreateBarcode 방식을 통해 노출합니다. 1D 형식에서 2D 형식으로 이동할 때 API 표면은 변경되지 않으며 BarcodeEncoding 상수만 달라집니다.

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

Imports IronBarCode

' 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product.png")

' 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec) _
    .SaveAsPng("boarding-pass.png")

지원되는 상수 전체 목록은 지원되는 바코드 형식 참조에서 확인할 수 있으며, 여기에는 모든 2D 바코드 생성 형식과 전체 1D 바코드 형식이 모두 포함되어 있습니다.

넷바코드 접근법

NetBarcode의 생성 모델은 생성자 기반입니다. 코드-51702--@@ 객체는 데이터 문자열과 @@--코드-51703--@@ 열거형 값으로 인스턴스화됩니다. 출력은 SaveImageFile()로 직접 저장하거나 Image<Rgba32>를 통해 GetImage()로 검색합니다. 버전 1.8부터 GetImage()의 반환 유형은 SixLabors.ImageSharp 유형이므로 반환 값을 저장하거나 처리하는 모든 코드는 ImageSharp API 내에서 가져와서 작업해야 합니다.

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

Imports NetBarcode
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats
Imports System.IO

' Constructor-based creation
Dim barcode As New Barcode("12345678901234", Type.Code128)

' Save to file — straightforward
barcode.SaveImageFile("code128.png")

' GetImage() returns Image(Of Rgba32) — ImageSharp import required
Dim image As Image(Of Rgba32) = barcode.GetImage()

' Further processing requires familiarity with the ImageSharp API
Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

GetImage() 메서드의 반환 유형은 다운스트림 코드를 ImageSharp 라이브러리에 연결합니다. 결과를 받거나 저장하는 모든 메서드는 Image<Rgba32>로 선언하여 호출 코드에 전이적 종속성을 도입해야 합니다.

IronBarcode접근법

IronBarcode 플루언트 체인을 사용합니다. BarcodeWriter.CreateBarcode은 여러 출력 메서드를 전달하는 GeneratedBarcode 객체를 반환합니다. 이미지 처리는 내부적으로 이루어지며, ImageSharp의 어떤 유형도 호출 코드에 노출되지 않습니다.

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

' Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' Multiple output options on the same GeneratedBarcode object
Dim barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
barcode.SaveAsPng("code128.png")
barcode.SaveAsJpeg("code128.jpg")
Dim bytes As Byte() = barcode.ToPngBinaryData()

Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

너비, 높이 및 라벨 구성을 포함한 1D 바코드 생성 에 대한 자세한 옵션은IronBarcode설명서에 나와 있습니다.

넷바코드 접근법

NetBarcode에는 읽기 API가 없습니다. 바코드 이미지를 데이터 문자열로 다시 디코딩하는 메서드, 클래스 또는 설정은 없습니다. 이는 의도적인 범위 제한이며, 출시를 앞두고 누락된 부분이 아닙니다. NetBarcode를 사용하여 바코드를 생성한 후 인쇄된 라벨의 유효성을 검사하거나, 반품 배송을 스캔하거나, 공급업체 송장에서 값을 추출하는 등 바코드를 읽어야 하는 프로젝트는 해당 목적을 위한 별도의 라이브러리를 도입해야 합니다.

// 넷바코드 — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

// 넷바코드 — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

net

ZXing .NET 라이브러리는 NetBarcode와 함께 읽기 기능을 제공하는 가장 일반적인 추가 라이브러리로, 넷바코드 및 이미 추가된 모든 QR 코드용 2D 라이브러리와 함께 세 번째 API 인터페이스와 세 번째 패키지를 제공하여 버전 관리가 용이해집니다.

IronBarcode접근법

IronBarcode에는 BarcodeReader가 BarcodeWriter와 동일한 패키지에 포함되어 있습니다. 읽기 API는 이미지 파일과 PDF 문서를 입력받아 디코딩된 결과 모음을 반환합니다. 각 결과에는 바코드 값, 형식 유형, 그리고 PDF에서 읽은 경우 페이지 번호가 포함됩니다.

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

Imports IronBarCode

' Read barcodes from an image file
Dim imageResults = BarcodeReader.Read("shipping-label.png")
For Each r In imageResults
    Console.WriteLine($"{r.BarcodeType}: {r.Value}")
Next

' Read barcodes from a PDF document — no additional library required
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

이미지에서 바코드를 읽는 방법에 대한 가이드에서는 읽기 API에서 사용할 수 있는 속도 조정, 다중 바코드 감지 및 이미지 보정 옵션을 다룹니다.

넷바코드 및 이미지샤프

NetBarcode는MIT라이선스에 따라 배포됩니다. 이 라이브러리가 의존하는 SixLabors.ImageSharp는 다른 모델을 사용합니다. 오픈 소스 프로젝트와 연간 총매출액이 특정 기준치 미만인 기업은 무료로 사용할 수 있지만, 기준치를 초과하는 기업은 상업용 라이선스를 구매해야 합니다. 이 구분은 이미지샤프가 프로젝트의 .csproj에 명시적으로 나열되어 있는지 또는 NetBarcode를 통해 전달되는지 여부에 관계없이 적용됩니다.

<PackageReference Include="NetBarcode" Version="1.8.2" />

<PackageReference Include="NetBarcode" Version="1.8.2" />

대규모로 바코드를 처리하는 소매 또는 물류 회사(NetBarcode가 주로 목표로 하는 사용 사례)의 경우 연간 매출액이 ImageSharp 상업용 라이선스가 적용되는 기준치를 초과하는 경우가 많습니다. 규정 준수 감사를 통해 패키지 트리 구조에 이러한 의무 사항이 포함되어 있음을 알 수 있습니다.

V1.8 릴리스에서는 GetImage()의 반환 유형이 내부 표현에서 SixLabors.ImageSharp.Image<Rgba32>로 변경되는 등 ImageSharp 종속성에 따른 추가적인 결과가 도입되었습니다. 명시적인 입력 없이 GetImage()를 호출하는 기존 코드는 컴파일 시 중단되었으며, SixLabors.ImageSharp 및 SixLabors.ImageSharp.PixelFormats에 대한 새로운 using 지시어가 필요하게 되었습니다. ImageSharp 자체 API가 향후 버전에서 발전함에 따라 NetBarcode의 공개 API 표면에도 영향을 미칩니다.

IronBarcode

IronBarcode SixLabors.ImageSharp에 대한 의존성이 없습니다. 라이선스 조건은IronBarcode 라이선스 페이지 에 직접 명시되어 있으며, 분할 임계값이나 양도적 상업적 의무는 없습니다. 평가용 체험판 키가 제공됩니다. 구매한 라이선스는 생성된 출력물에서 체험판 워터마크를 제거합니다.

QR 코드 및 2D 형식 요구 사항

넷바코드의 대안을 검토하게 되는 가장 흔한 계기는 QR 코드에 대한 새로운 요구 사항입니다. 소매 라벨이나 배송 명세서에 사용되는 1D 바코드 생성으로 시작하는 애플리케이션은 일반적으로 비접촉식 링크, 모바일 앱 딥 링크, 마케팅 캠페인 등과 같은 용도로 QR 코드 생성이 필요하게 됩니다. Type 열거형에는 QR 항목이 없기 때문에 이 요구 사항은 넷바코드 내에서 충족할 수 없습니다. QR 코드 라이브러리를 별도로 추가하여 이러한 격차를 해소하는 팀은 제약 통합에 DataMatrix가 필요하거나 배송 라벨에 PDF417을 의무화하는 물류 운송업체에 필요한 경우 두 번째 평가를 받아야 합니다.

바코드 판독이 필수적이 되었습니다

일부 프로젝트는 순수한 바코드 생성으로 시작하여 나중에 유효성 검사 또는 문서 처리 요구 사항을 추가합니다. 예를 들어 인쇄된 바코드가 원본 데이터와 일치하는지 확인하거나, 들어오는 공급업체 송장에서 바코드 값을 추출하거나, 반품 배송 라벨을 스캔하는 등의 작업이 포함될 수 있습니다. NetBarcode는 이를 위한 경로를 제공하지 않습니다. ZXing .NET 또는 이와 유사한 읽기 라이브러리를 추가하면 넷바코드 및 QR 라이브러리가 이미 포함된 동일한 코드베이스에서 학습하고 유지 관리해야 할 세 번째 API가 추가됩니다. 미래 단계에서 요구되는 자료량을 예상하는 프로젝트의 경우, 처음부터 이러한 두 가지 사항을 모두 충족하는 도서관을 선택하는 것이 더 효율적인 경우가 많습니다.

ImageSharp 상업용 라이선스 감사

타사 종속성에 대한 법률 및 규정 준수 검토 과정에서 넷바코드 패키지 트리에 포함된 SixLabors.ImageSharp 상업용 라이선스 조건이 종종 발견됩니다. 연간 총매출액이 기준치를 초과하는 기업의 경우, ImageSharp를 의도적으로 선택했든 NetBarcode를 통해 간접적으로 선택했든 관계없이 해당 의무가 적용됩니다. 이 문제를 도입 전이 아닌 감사 중에 발견한 팀은 계획된 마이그레이션이 아닌 사후 수정 작업을 해야 합니다. 프로젝트를 시작하기 전에 종속성 라이선스를 평가하는 것이 더 깔끔한 방법입니다.

멀티라이브러리 복잡성 감소

1D 바코드 생성을 위한 NetBarcode, 2D 출력을 위한 QR 코드 전용 라이브러리, 그리고 읽기를 위한 ZXing .NET 을 사용하는 팀들은 세 가지 서로 다른 패키지 간의 버전 호환성을 유지해야 하는 어려움에 직면합니다. 업그레이드 주기마다 세 개의 라이브러리가 공유하는 ImageSharp 버전이 일치하는지 확인해야 합니다. 프로젝트에 새로 참여하는 개발자는 개념적으로 하나의 기능에 대해 서로 다른 세 가지 API를 접하게 됩니다. 단일 바코드 라이브러리로 통합하면 온보딩이 간소화되고, 버전 충돌 가능성이 줄어들며, 유지 관리가 하나의 릴리스 주기로 집중됩니다.

패키지 교체 및 전이적 종속성 정리

첫 번째 단계는 dotnet remove package NetBarcode로 NetBarcode를 제거하는 것입니다. 프로젝트의 다른 패키지가 이 패키지를 일시적으로 가져오는 경우 종속성 트리에 SixLabors.ImageSharp 패키지가 다시 나타날 수 있습니다. 제거한 후 dotnet list package --include-transitive로 복원된 패키지 목록을 검사하여 ImageSharp가 여전히 존재하는지, 상용 라이선스 조건이 여전히 적용되는지 확인합니다.

GetImage() 반환 유형 대체

코드-51760--@@의 결과를 @@--코드-51761--@@로 저장한 코드는 모두 업데이트해야 합니다. ImageSharp 유형에 해당하는IronBarcode유형은 없습니다. 이미지 교체는 하위 단계에서 이미지가 어떻게 사용되었는지에 따라 달라집니다. 스트림에 이미지를 저장한 코드는 .SaveAsPng(stream) 개체에서 직접 GeneratedBarcode로 대체할 수 있습니다. 원시 바이트를 검색한 코드는 .ToPngBinaryData()를 사용할 수 있습니다. 반환된 이미지에 대해 추가적인 ImageSharp 조작을 수행하는 코드는 해당 작업들을 개별적으로 평가해야 합니다.

네임스페이스 업데이트

코드-51765--@@, 코드-51766--@@, 코드-51767--@@ 또는 코드-51768--@@를 가져온 파일은 해당 지시어를 @@--코드-51769--@@로 대체해야 합니다. 프로젝트 전체에서 이러한 using 문을 검색하면 빌드를 시도하기 전에 주의가 필요한 모든 파일을 식별할 수 있습니다.