바코드립 코어 생성 패턴

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

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

Imports BarcodeStandard
Imports SkiaSharp

Dim b As New Barcode()
b.IncludeLabel = True
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Using stream = File.OpenWrite("barcode.png")
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
End Using

이것이 전체 생성 워크플로입니다. 속성 설정 패턴이 디자인입니다: Encode() 호출 전에 인스턴스에서 구성되며, 반환 값은 인코딩되어 스트림으로 기록되어야 하는 SKImage입니다.

상세 기능 비교

바코드립 접근 방식

BarcodeLib은 인스턴스를 생성하고 속성을 설정한 후, 크기의 Encode() 호출이 필요합니다. 출력은 SKImage입니다.

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

Imports BarcodeStandard
Imports SkiaSharp

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100)

    Using ms As New MemoryStream()
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
        Return ms.ToArray()
    End Using
End Function

SKImage 반환 유형은 바이트 배열 출력을 위해 SKEncodedImageFormat 인코드 호출과 MemoryStream이 필요함을 의미합니다. IncludeLabel 속성은 불리언 토글입니다 - BarcodeLib은 인코딩된 데이터 문자열을 막대 아래의 보이는 레이블로 렌더링합니다.

IronBarcode접근법

IronBarcode의 생성 방식은 완전히 정적입니다. 구성 체인은 CreateBarcode() 후에 체인되며, 출력 방법은 체인을 직접 종료합니다.

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateCode128(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .AddBarcodeValueTextBelowBarcode() _
        .ToPngBinaryData()
End Function

.ToPngBinaryData()는 중간 Image 또는 MemoryStream 객체 없이 바이트 배열을 직접 반환합니다. .AddBarcodeValueTextBelowBarcode()는 인코딩된 데이터 문자열을 막대 아래의 레이블로 렌더링합니다. 고급 바코드 생성 시나리오에 대해서는 IronBarcode 바코드 생성 설명서를 참조하십시오.

바코드립 접근 방식

BarcodeLib에는 읽기 API가 없습니다. Decode(), Scan(), 또는 ReadBarcode() 방법이 없습니다. 읽기는 라이브러리의 설계에 포함되지 않았습니다. 디코딩 메서드를 호출하려는 모든 시도는 컴파일 오류를 발생시킵니다.

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

Imports BarcodeStandard
Imports SkiaSharp

Dim b = New Barcode()

' There is no Decode, Scan, or Read method on Barcode.
' b.Decode("barcode.png")      ' does not exist
' b.Scan("barcode.png")        ' does not exist
' b.ReadBarcode("barcode.png") ' does not exist

' The only public operation is generation:
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

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

IronBarcode접근법

BarcodeReader.Read()는 이미지 파일, PDF 파일, 스트림 및 System.Drawing.Bitmap 객체를 수용합니다. PDF 파일을 읽는 데에는 별도의 라이브러리가 필요하지 않습니다.

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);

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);

Imports IronBarCode

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

' Read all barcodes from a PDF — no separate PDF library needed
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

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

바코드립 접근 방식

BarcodeLib 3.x부터, 이 라이브러리는 System.Drawing.Common를 대체하기 위해 그래픽 백엔드로 SkiaSharp을 도입했습니다. .NET 6 이후 Windows전용이 되었습니다. 바코드립 3.1.5는 SkiaSharp >= 2.88.8을 선언합니다. 프로젝트가 이미 다른 종속성을 통해 SkiaSharp을 사용하고 있는 경우 — MAUI 프로젝트에서 SkiaSharp.Views.Maui와 Microsoft.Maui.Graphics을 사용하는 것이 일반적이며, 이는 SkiaSharp 3.x로 이동하는 경향이 있음 — 해결된 버전들이 일치하지 않을 수 있습니다. 그 결과 최소한 NU1608 경고가 발생하고, 최악의 경우 런타임 시 어셈블리 바인딩 오류가 발생합니다.

warning NU1608: Detected package version outside of dependency constraint:
BarcodeLib 3.1.5 requires SkiaSharp (>= 2.88.8) but
version SkiaSharp 3.116.1 was resolved.

명시적 패키지 참조를 통한 해상 강제는 하나의 경로이지만, 이는 런타임 호환성을 보장하지 않습니다.

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />
  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />
  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

명시적 재정의가 있더라도 호환성은 BarcodeLib의 내부 API 호출이 해결된 SkiaSharp 버전이 노출하는 것과 일치하는지 여부에 따라 달라집니다. 커뮤니티에 의해 유지되는 프로젝트이기에, BarcodeLib는 상용 지원 계약이 릴리스 주기에 붙어 있지 않습니다.

IronBarcode접근법

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

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

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

스키아샤프, MAUI 프로젝트에서의 갈등

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

PDF 바코드 처리 필요

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

QR 코드 또는 기타 2D 기호 요구사항 발생

초기 요구 사항이 선형 바코드에만 국한되었던 프로젝트는 종종 QR 코드, 데이터 매트릭스, PDF417 또는 Aztec 출력을 필요로 하게 진화합니다. BarcodeLib의 3.x 시리즈는 2D 기호를 생성하지 않습니다 — BarcodeStandard.Type 열거형에는 QR 코드나 기타 2D 항목이 없습니다 — 따라서 2D 요구 사항은 두 번째 라이브러리를 추가하거나 BarcodeLib을 완전히 대체해야 합니다. IronBarcode의 QRCodeWriter 및 BarcodeWriter는 유창한 API를 통해 QR 코드(로고 내장, 색상 제어, 오류 수정 조정), 데이터 매트릭스, PDF417, 그리고 Aztec을 다룹니다. 기호 요구 사항이 2D로 이동하는 팀에게는 갭이 마이그레이션 결정을 유도합니다.

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

BarcodeLib 코드는 가변 객체 패턴을 사용합니다: Barcode 인스턴스를 생성하고 속성을 설정한 후 Encode()을 호출합니다. IronBarcode는 정적 유창한 패턴을 사용합니다: BarcodeWriter.CreateBarcode()을 호출하고 구성 방법을 체인한 후 출력 방법으로 종료합니다. Barcode 인스턴스를 필드로 저장하거나 메소드 간에 전달하는 기존 코드는 구조 변경이 필요할 것입니다. 일반적인 변경 사항은 속성 설정 블록을 메서드 체인으로 대체하는 것입니다.

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

' The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .AddBarcodeValueTextBelowBarcode() _
    .SaveAsPng(outputPath)

SKImage에서 직접 출력으로

BarcodeLib 3.x은 SKImage을 반환하며, 이는 바이트를 생성하려면 SKEncodedImageFormat 및 스트림이 필요합니다. SKImage에 입력되었거나 image.Encode(...).SaveTo(stream)을 거치는 모든 코드는 업데이트가 필요합니다. IronBarcode의 유창한 체인은 원하는 출력 형식으로 직접 종료됩니다 — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — 중간 이미지 객체 및 스트림으로 인코딩하는 단계가 필요하지 않습니다.

Type Enum에서 BarcodeEncoding Enum으로

BarcodeLib 3.x는 BarcodeStandard.Type.Code128와 같은 PascalCase 값을 가진 BarcodeStandard.Type 열거형을 사용합니다. IronBarcode는 BarcodeEncoding.Code128와 같은 값을 가진 BarcodeEncoding 열거형을 사용합니다. 1D 값은 직접 매핑됩니다: Code128 → Code128, Ean13 → EAN13, UpcA → UPCA, Code39 → Code39. .cs 파일 전체에서 BarcodeStandard.Type.에 대한 grep을 통해 업데이트가 필요한 모든 발생을 식별합니다.

SkiaSharp 참조 정리

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