근본적인 문제

NetBarcode만으로 시작해서 2D 형식이 필요하게 되는 프로젝트는 결국 이런 식으로 가져오기를 분할하게 됩니다.

// 넷바코드 for 1D — one library, one API
using NetBarcode;
var code128 = new Barcode("12345", Type.Code128);
code128.SaveImageFile("label.png");

// QRCoder added separately for QR — second library, second API
using QRCoder;
var qrGenerator = new QRCodeGenerator();
var qrData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
var png = new PngByteQRCode(qrData).GetGraphic(20);
File.WriteAllBytes("qr.png", png);

// 넷바코드 for 1D — one library, one API
using NetBarcode;
var code128 = new Barcode("12345", Type.Code128);
code128.SaveImageFile("label.png");

// QRCoder added separately for QR — second library, second API
using QRCoder;
var qrGenerator = new QRCodeGenerator();
var qrData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
var png = new PngByteQRCode(qrData).GetGraphic(20);
File.WriteAllBytes("qr.png", png);

Imports NetBarcode
Imports QRCoder
Imports System.IO

Dim code128 As New Barcode("12345", Type.Code128)
code128.SaveImageFile("label.png")

Dim qrGenerator As New QRCodeGenerator()
Dim qrData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)
Dim png = New PngByteQRCode(qrData).GetGraphic(20)
File.WriteAllBytes("qr.png", png)

IronBarcode 로 마이그레이션한 후에는 단일 가져오기에서 동일한 두 가지 출력이 생성됩니다.

using IronBarCode;

BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128)
    .SaveAsPng("label.png");

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128)
    .SaveAsPng("label.png");

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128) _
    .SaveAsPng("label.png")

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

1단계: NuGet 패키지 교체

NetBarcode와 그에 따른 ImageSharp 종속성을 제거하세요.

dotnet remove package NetBarcode
dotnet remove package SixLabors.ImageSharp

dotnet remove package NetBarcode
dotnet remove package SixLabors.ImageSharp

SixLabors.ImageSharp는 프로젝트의 다른 패키지에서도 전이적으로 참조할 경우 복원된 패키지 목록에 다시 나타날 수 있습니다. 삭제 후, dotnet list package --include-transitive을 실행하여 ImageSharp이 남아 있는지 및 상업적 라이선스 조건이 여전히 프로젝트에 적용되는지를 확인하십시오.

2단계:IronBarcode추가

dotnet add package IronBarcode

dotnet add package IronBarcode

NuGet 패키지 이름은 IronBarcode; 코드에서 사용하는 네임스페이스는 IronBarCode (대문자 C에 주의하십시오).

3단계: 네임스페이스 업데이트 및 라이선스 초기화

NetBarcode 호출이 포함된 모든 파일에서 기존의 using 지시문을 다음과 같이 교체하십시오.

// 제거하다 these:
// using NetBarcode;
// using SixLabors.ImageSharp;
// using SixLabors.ImageSharp.PixelFormats;
// using SixLabors.Fonts;

// Add this:
using IronBarCode;

// 제거하다 these:
// using NetBarcode;
// using SixLabors.ImageSharp;
// using SixLabors.ImageSharp.PixelFormats;
// using SixLabors.Fonts;

// Add this:
using IronBarCode;

Imports IronBarCode

응용 프로그램 시작 시 Program.cs, Startup.cs 또는 프로젝트의 진입 지점에서 라이선스 초기화를 추가하십시오:

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

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

Imports IronBarCode

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

평가를 위해 무료 체험판 키를 사용할 수 있습니다. 라이선스를 구매하면 생성된 바코드 이미지에서 체험판 워터마크가 제거됩니다.

코드128 생성

가장 일반적인 넷바코드 사용 패턴은 생성자를 정적 메서드로 변경하고 메서드 이름을 바꾸는 것만으로IronBarcode에 그대로 적용됩니다.

넷바코드 접근법:

using NetBarcode;

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

using NetBarcode;

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

Imports NetBarcode

Dim barcode As New Barcode("12345678901234", Type.Code128)
barcode.SaveImageFile("shipping-label.png")

IronBarcode 접근 방식:

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

new Barcode(data, Type.X) 생성자는 BarcodeWriter.CreateBarcode(data, BarcodeEncoding.X)이 됩니다. SaveImageFile() 메서드는 필요한 출력 포맷에 따라 SaveAsPng(), SaveAsJpeg(), 또는 SaveAsWindowsBitmap()로 변환됩니다. 사용 가능한 모든 1D 바코드 생성 옵션은IronBarcode사용 설명서에 자세히 설명되어 있습니다.

EAN-13

소매 제품 바코드 유형은 상수 이름 변경 및 메서드 이름 변경을 통해 라이브러리 간에 직접 매핑됩니다.

넷바코드 접근법:

using NetBarcode;

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

using NetBarcode;

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

Imports NetBarcode

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

IronBarcode 접근 방식:

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

인코딩 상수 이름은 직접 대응이 존재하는 경우 NetBarcode의 Type 열거형 멤버 이름과 일치합니다. UPC-A (Type.UPCA), UPC-E (Type.UPCE), ITF (Type.ITF), MSI (Type.MSI) 등은 NetBarcode의 Type 열거형에 포함되지 않습니다 — 해당 포맷이 필요한 경우 IronBarcode는 BarcodeEncoding.UPCA, BarcodeEncoding.UPCE, BarcodeEncoding.ITF, BarcodeEncoding.MSI를 통해 네이티브로 지원합니다.

GetImage()를 ToPngBinaryData()로 변환

NetBarcode의 GetImage() 메서드는 SixLabors.ImageSharp.Image<Rgba32>을 반환하며, 호출 코드에서 명시적인 ImageSharp 가져오기와 하위 로직을 ImageSharp API에 연결합니다. IronBarcode는 GeneratedBarcode 객체에서 이진 및 스트림 출력 메서드를 직접 노출하여 호출 코드에서 ImageSharp 의존성을 완전히 제거합니다.

넷바코드 접근법:

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

var barcode = new Barcode("12345", Type.Code128);
Image<Rgba32> image = barcode.GetImage();

using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

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

var barcode = new Barcode("12345", Type.Code128);
Image<Rgba32> image = barcode.GetImage();

using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

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

Dim barcode As New Barcode("12345", Type.Code128)
Dim image As Image(Of Rgba32) = barcode.GetImage()

Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

IronBarcode 접근 방식:

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128);

// Retrieve bytes directly — no ImageSharp type in calling code
byte[] bytes = barcode.ToPngBinaryData();

// Or write to a stream directly
using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128);

// Retrieve bytes directly — no ImageSharp type in calling code
byte[] bytes = barcode.ToPngBinaryData();

// Or write to a stream directly
using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128)

' Retrieve bytes directly — no ImageSharp type in calling code
Dim bytes As Byte() = barcode.ToPngBinaryData()

' Or write to a stream directly
Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

Image<Rgba32> 결과에 대해 추가 ImageSharp 조작을 수행했던 코드 — 크기 조정, 합성, 포맷 변환 —는 IronBarcode가 ImageSharp 객체를 노출하지 않기 때문에 개별적으로 평가가 필요합니다.

NetBarcode와 QRCoder를 하나로 통합하여 대체

NetBarcode와 QRCoder를 함께 사용하는 프로젝트는 두 프로그램을 한 번에 교체할 ​​수 있습니다. IronBarcode의 2D 생성은 1D 생성과 동일한 BarcodeWriter.CreateBarcode 메서드를 사용합니다; 단지 BarcodeEncoding 상수만 다릅니다. 인코딩 옵션 및 구성에 대한 자세한 내용은 2D 바코드 생성 가이드를 참조하십시오.

넷바코드 및 QR코더 접근 방식:

using NetBarcode;
using QRCoder;

// 1D with NetBarcode
var code128 = new Barcode("12345", Type.Code128);
code128.SaveImageFile("label.png");

// QR with QRCoder
var qrGenerator = new QRCodeGenerator();
var qrData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrData);
File.WriteAllBytes("qr.png", qrCode.GetGraphic(20));

using NetBarcode;
using QRCoder;

// 1D with NetBarcode
var code128 = new Barcode("12345", Type.Code128);
code128.SaveImageFile("label.png");

// QR with QRCoder
var qrGenerator = new QRCodeGenerator();
var qrData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrData);
File.WriteAllBytes("qr.png", qrCode.GetGraphic(20));

Imports NetBarcode
Imports QRCoder

' 1D with NetBarcode
Dim code128 As New Barcode("12345", Type.Code128)
code128.SaveImageFile("label.png")

' QR with QRCoder
Dim qrGenerator As New QRCodeGenerator()
Dim qrData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)
Dim qrCode As New PngByteQRCode(qrData)
File.WriteAllBytes("qr.png", qrCode.GetGraphic(20))

IronBarcode 접근 방식:

using IronBarCode;

// 1D — same API as 2D
BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128)
    .SaveAsPng("label.png");

// QR — change the encoding constant, nothing else
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Additional 2D formats available with no further imports
BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

using IronBarCode;

// 1D — same API as 2D
BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128)
    .SaveAsPng("label.png");

// QR — change the encoding constant, nothing else
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Additional 2D formats available with no further imports
BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

Imports IronBarCode

' 1D — same API as 2D
BarcodeWriter.CreateBarcode("12345", BarcodeEncoding.Code128) _
    .SaveAsPng("label.png")

' QR — change the encoding constant, nothing else
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

' Additional 2D formats available with no further imports
BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

읽기 기능 추가

프로젝트에서 읽기 작업에 ZXing .NET 을 사용하는 경우, NetBarcode와 함께 해당 종속성도 제거할 수 있습니다. IronBarcode의 BarcodeReader는 이미지 및 PDF 문서를 자동 포맷 탐지로 처리합니다.

ZXing .NET 접근 방식:

using ZXing;
using ZXing.Common;
using ZXing.Rendering;

var reader = new BarcodeReaderGeneric();
reader.Options = new DecodingOptions { TryHarder = true };

// Bitmap loading and format-specific handling required before decode call

using ZXing;
using ZXing.Common;
using ZXing.Rendering;

var reader = new BarcodeReaderGeneric();
reader.Options = new DecodingOptions { TryHarder = true };

// Bitmap loading and format-specific handling required before decode call

Imports ZXing
Imports ZXing.Common
Imports ZXing.Rendering

Dim reader = New BarcodeReaderGeneric()
reader.Options = New DecodingOptions With {.TryHarder = True}

' Bitmap loading and format-specific handling required before decode call

IronBarcode 접근 방식:

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

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

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

바코드 이미지 판독 옵션에 대한 전체 문서는 속도 조정, 다중 바코드 감지 및 이미지 보정 설정 등을 다루는 "이미지에서 바코드 판독" 가이드에서 확인할 수 있습니다.

문제 1: 패키지 제거 후에도 ImageSharp의 전이적 종속성이 남아 있음

문제: dotnet remove package NetBarcode 실행 후, dotnet restore에서 다른 패키지가 참조 중이기 때문에 SixLabors.ImageSharp이 종속성 트리에 여전히 존재하는 것으로 나타납니다.

해결책: dotnet list package --include-transitive을 실행하여 여전히 ImageSharp을 가져오는 패키지를 식별하십시오. 만약 NetBarcode만 참조하는 경우, 명시적인 패키지 참조를 제거하고 복원하면 이를 해결할 수 있습니다. 다른 패키지가 책임인 경우, 해당 패키지의 ImageSharp 종속성 및 상업적 라이선스 조건은 넷바코드 제거와 독립적으로 적용됩니다.

dotnet list package --include-transitive | grep -i imagesharp

dotnet list package --include-transitive | grep -i imagesharp

문제 2: 이미지 삭제 후 유형을 확인할 수 없습니다.

문제: SixLabors.ImageSharp 패키지를 제거한 후, Image<Rgba32>로 선언된 변수나 SixLabors.ImageSharp.Image<Rgba32>로 타이핑된 매개변수에 대해 타입이 더 이상 사용 불가능하여 컴파일 오류가 발생합니다.

해결 방법: 각 사용 부분을 적절한IronBarcode출력 방식으로 대체하십시오. 변수가 바이트를 얻기 위해 사용된 경우 .ToPngBinaryData()으로 대체하십시오. 스트림에 기록된 경우 .SaveAsPng(stream)로 대체하십시오. 파일에 저장된 경우 .SaveAsPng(path)으로 대체하십시오.

// Before — requires SixLabors.ImageSharp reference
Image<Rgba32> img = barcode.GetImage();
img.SaveAsPng(stream);

// After — no external image type required
barcode.SaveAsPng(stream);

// Before — requires SixLabors.ImageSharp reference
Image<Rgba32> img = barcode.GetImage();
img.SaveAsPng(stream);

// After — no external image type required
barcode.SaveAsPng(stream);

' Before — requires SixLabors.ImageSharp reference
Dim img As Image(Of Rgba32) = barcode.GetImage()
img.SaveAsPng(stream)

' After — no external image type required
barcode.SaveAsPng(stream)

이슈 3: v1.8 호환성 파괴 변경 사항 컨텍스트

문제: v1.8 이전의 NetBarcode를 기반으로 작성된 코드베이스에서 명시적인 타이핑 없이 결과를 저장한 GetImage() 호출이 있을 수 있습니다. 이러한 호출은IronBarcode마이그레이션과는 별개로 넷바코드 업데이트 이후 이미 작동하지 않을 수 있습니다.

해결책: v1.8 이전에 발생한 문제를 해결할 기회로 IronBarcode로의 마이그레이션을 활용하십시오. 모든 GetImage() 호출 지점을 프로젝트 전체 검색으로 찾아서 마이그레이션 진행 중에 적절한IronBarcode출력 메서드로 교체하십시오. 아래 마이그레이션 체크리스트의 grep 명령어는 이러한 위치를 식별합니다.

사전 마이그레이션

변경 사항을 적용하기 전에 모든 넷바코드 사용 내역을 감사하십시오.

grep -r "using NetBarcode" ./src
grep -r "new Barcode(" ./src
grep -r "Type\.Code128\|Type\.EAN13\|Type\.Code39\|Type\.EAN8" ./src
grep -r "Type\.Codabar\|Type\.Code93" ./src
grep -r "SaveImageFile(" ./src
grep -r "GetImage(" ./src
grep -r "using SixLabors\.ImageSharp" ./src
grep -r "Image<Rgba32>" ./src

grep -r "using NetBarcode" ./src
grep -r "new Barcode(" ./src
grep -r "Type\.Code128\|Type\.EAN13\|Type\.Code39\|Type\.EAN8" ./src
grep -r "Type\.Codabar\|Type\.Code93" ./src
grep -r "SaveImageFile(" ./src
grep -r "GetImage(" ./src
grep -r "using SixLabors\.ImageSharp" ./src
grep -r "Image<Rgba32>" ./src

• using 지시문 변경이 필요한 모든 파일을 식별합니다.
• 모든 GetImage() 호출 지점과 반환된 Image<Rgba32> 객체가 하위에서 어떻게 사용되는지 기록하십시오.
• QRCoder 또는 ZXing .NET 이 설치되어 있는지 확인하고, 설치되어 있다면 같은 과정에서 제거할 수 있는지 확인합니다.
• 제거 전에 현재 ImageSharp 종속성 상태를 문서화하기 위해 dotnet list package --include-transitive을 실행하십시오. -IronBarcode라이선스 키를 받으세요 (구매 없이 무료 평가판 키를 사용할 수 있습니다).

코드 업데이트

1. dotnet remove package NetBarcode 실행
2. 다른 패키지에서 사용되지 않는 경우 dotnet remove package SixLabors.ImageSharp 실행
3. dotnet add package IronBarcode 실행
4. 응용 프로그램 시작 시 IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; 추가
5. 각 영향을 받는 파일에서 using NetBarcode;을(를) using IronBarCode;으로 교체
6. 모든 파일에서 using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats;, 및 using SixLabors.Fonts;을(를) 제거
7. new Barcode(data, Type.X) 호출을 API 맵핑 테이블을 사용하여 BarcodeWriter.CreateBarcode(data, BarcodeEncoding.X)으로 변환
8. SaveImageFile()을(를) SaveAsPng() 또는 적절한 포맷별 메서드로 교체
9. GetImage() 호출을 필요에 따라 ToPngBinaryData(), SaveAsPng(), 또는 SaveAsPng(stream)으로 교체
10. QR코더 제거 시: QRCodeGenerator + PngByteQRCode 체인을 BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)으로 교체
11. ZXing.Net 제거 시: 리더 설정을 BarcodeReader.Read(path)으로 교체

마이그레이션 후 테스트

• 프로젝트를 빌드하고 컴파일 오류가 없는지 확인합니다.
• 생성된 바코드 출력에 대해 기존 단위 테스트를 실행합니다.
• 바코드 이미지의 심볼이 올바르고 내용이 읽기 쉬운지 육안으로 확인합니다.
• 마이그레이션 중에 QR 코드 형식이 추가된 경우 QR 코드 출력 결과를 확인합니다.
• 바코드 스캔 기능이 추가된 경우 읽기 기능을 테스트합니다.
• ImageSharp이 제거되었는지 확인하기 위해 dotnet list package --include-transitive을 실행합니다.
• 첫 번째 바코드 작업 전에 라이선스 키 초기화가 실행되는지 확인합니다.