이 가이드는 Neodynamic.SDK.Barcode 및 Neodynamic.SDK.BarcodeReader에서 IronBarcode로의 완전한 마이그레이션 경로를 제공합니다. 이 문서에는 네오다이나믹 패키지 두 가지 모두의 제거, 이중 라이선스 구성을 단일 키로 대체, 생성 및 읽기 API 호출 번역, 그리고 네오다이나믹 제품군으로는 불가능했던 2D 바코드 읽기 기능 확보 과정이 포함되어 있습니다. 이 가이드는 기존 네오다이나믹 코드를 보유하고 있으며 마이그레이션을 체계적인 파일별 접근 방식으로 완료해야 하는 개발자를 위해 작성되었습니다.

네오다이내믹 바코드에서 마이그레이션해야 하는 이유는 무엇일까요?

2D 판독 격차: 네오다이나믹 바코드 Professional SDK는 QR 코드, DataMatrix, PDF417 및 Aztec 바코드를 생성합니다. 이러한 형식은 함께 제공되는 바코드 리더 SDK에서 읽을 수 없습니다. 제품 라벨, 배송 용기 또는 문서 추적을 위한 QR 코드를 생성하는 프로젝트는 해당 생성기와 함께 구매한 리더기를 통해 생성된 QR 코드를 다시 읽을 수 없습니다.IronBarcode동일한 라이브러리와 라이선스를 통해 QR 코드, DataMatrix, PDF417, Aztec 및 기타 지원되는 모든 2D 형식을 읽고 생성합니다.

이중 제품 부하: Neodynamic SDK를 사용하는 모든 프로젝트는 두 PackageReference 항목, 두 using 지시문, 두 개의 라이선스 블록 및 별도의 두 개의 업데이트 주기를 가지고 있습니다. 이러한 오버헤드는 모든 개발자 컴퓨터, 모든 CI 파이프라인, 그리고 모든 프로덕션 환경에서 반복적으로 발생합니다. 유지 관리 요구 사항이 각각 다른 두 패키지를 단일 라이선스를 사용하는 단일 종속성으로 통합하는 것이 이번 마이그레이션의 기계적인 결과입니다.

세 번째 라이브러리 문제: 2D 읽기 기능에 대한 격차를 발견하고 마이그레이션 대신 해결책을 선택한 팀은 일반적으로 QR 코드 읽기를 위해 세 번째 라이브러리(가장 흔한 선택은 ZXing .NET) 를 추가했습니다. 그러한 결정은 하나의 제약을 감수하는 대신 다른 복잡성을 야기합니다. 즉, 바코드 관련 종속성이 세 가지나 존재하게 되는데, 각 종속성은 고유한 버전 제약 조건, 릴리스 노트, 그리고 .NET 런타임이나 종속 프레임워크가 업데이트될 때 발생할 수 있는 충돌 가능성을 가지고 있습니다.IronBarcode이 세 가지를 모두 대체합니다.

가격 복잡성: 네오다이나믹 바코드 Professional SDK는 개발자당 가격이 책정되어 있습니다(약 $352부터 시작하는 Basic, 약 $705부터 시작하는 Ultimate의 경우 ComponentSource를 통해 구입 가능). Barcode Reader SDK는 별도의 비용이 들며, 생성 및 1D 읽기가 모두 필요한 프로젝트는 둘 다 구입해야 하며 팀 크기와 함께 Reader 비용에 따라 가격이 증가합니다. 2D 읽기가 필요한 프로젝트는 Neodynamic 제품군 내에서 어떤 가격으로도 그 요구를 충족할 수 없습니다.IronBarcode Lite는 생성 및 읽기 — 1D 및 2D — 를 단일 라이선스로 포함합니다. 현재 가격은 IronBarcode 라이선스 페이지에 있습니다.

근본적인 문제

완전한 바코드 워크플로우를 위해 Neodynamic SDK를 모두 사용하는 모든 코드베이스의 핵심 문제는 QR 코드 읽기가 불가능하다는 것이었습니다.

// Before: 네오다이나믹 바코드 리더 does not support QR codes
using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results are always null or empty for 2D barcodes
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

// Before: 네오다이나믹 바코드 리더 does not support QR codes
using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results are always null or empty for 2D barcodes
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

IronBarcode 로 마이그레이션한 후에는 동일한 작업이 형식별 처리가 없는 표준 읽기 호출로 변경됩니다.

// After:IronBarcode reads QR codes with the same call used for all formats
using IronBarCode;

public string ReadQrCode(string imagePath)
{
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

// After:IronBarcode reads QR codes with the same call used for all formats
using IronBarCode;

public string ReadQrCode(string imagePath)
{
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

2D 바코드 판독을 참조하는 모든 throw new NotSupportedException(...) 플레이스홀더는 이 마이그레이션 동안 제거되고 실제 판독 호출로 대체됩니다.

##IronBarcode와 네오다이나믹 바코드: 기능 비교

빠른 시작: 네오다이나믹 바코드에서IronBarcode로의 마이그레이션

1단계: Neodynamic 패키지 두 개를 모두 제거합니다.

두 패키지 모두 제거해야 합니다. 삭제 순서에 영향을 미치는 공통 종속성이 없습니다.

dotnet remove package Neodynamic.SDK.Barcode
dotnet remove package Neodynamic.SDK.BarcodeReader

dotnet remove package Neodynamic.SDK.Barcode
dotnet remove package Neodynamic.SDK.BarcodeReader

후속 진행 전에 .csproj 파일에서 두 항목이 모두 사라졌는지 확인하세요.

2단계:IronBarcode추가

dotnet add package IronBarcode

dotnet add package IronBarcode

3단계: 이중 라이선스 구성 교체

Neodynamic 라이선스 블록 두 개를 모두 제거하고IronBarcode키 할당 하나로 대체하십시오. 이 할당은 애플리케이션 시작 시 한 번 이루어지며, Program.cs, Startup.cs, 또는 애플리케이션의 구성 루트에 있습니다:

// Before: two license blocks, two products
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "GEN-LICENSE-KEY";

Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Your Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-LICENSE-KEY";

// Before: two license blocks, two products
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "GEN-LICENSE-KEY";

Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Your Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-LICENSE-KEY";

Imports Neodynamic.SDK.Barcode
Imports Neodynamic.SDK.BarcodeReader

BarcodeProfessional.LicenseOwner = "Your Company"
BarcodeProfessional.LicenseKey = "GEN-LICENSE-KEY"

Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Your Company"
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-LICENSE-KEY"

Imports Neodynamic.SDK.Barcode
Imports Neodynamic.SDK.BarcodeReader

BarcodeProfessional.LicenseOwner = "Your Company"
BarcodeProfessional.LicenseKey = "GEN-LICENSE-KEY"

Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Your Company"
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-LICENSE-KEY"

// After: one key covers generation and reading across all formats
using IronBarCode;

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

// After: one key covers generation and reading across all formats
using IronBarCode;

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

Imports IronBarCode

' After: one key covers generation and reading across all formats
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Imports IronBarCode

' After: one key covers generation and reading across all formats
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

네오다이나믹 라이선스 키가 저장된 모든 구성 파일, 환경 변수 또는 비밀 저장소는 마이그레이션이 검증된 후 더 이상 사용하지 않아도 됩니다.

코드 마이그레이션 예제

코드 128 바코드 생성

신역동적 접근법:

using Neodynamic.SDK.Barcode;
using System.Drawing.Imaging;

public void GenerateCode128(string data, string outputPath)
{
    var barcode = new BarcodeProfessional();
    barcode.Code = data;
    barcode.Symbology = Symbology.Code128;
    barcode.BarcodeUnit = BarcodeUnit.Pixel;

    System.Drawing.Image image = barcode.GetBarcodeImage();
    image.Save(outputPath, ImageFormat.Png);
}

using Neodynamic.SDK.Barcode;
using System.Drawing.Imaging;

public void GenerateCode128(string data, string outputPath)
{
    var barcode = new BarcodeProfessional();
    barcode.Code = data;
    barcode.Symbology = Symbology.Code128;
    barcode.BarcodeUnit = BarcodeUnit.Pixel;

    System.Drawing.Image image = barcode.GetBarcodeImage();
    image.Save(outputPath, ImageFormat.Png);
}

Imports Neodynamic.SDK.Barcode
Imports System.Drawing.Imaging

Public Sub GenerateCode128(data As String, outputPath As String)
    Dim barcode As New BarcodeProfessional()
    barcode.Code = data
    barcode.Symbology = Symbology.Code128
    barcode.BarcodeUnit = BarcodeUnit.Pixel

    Dim image As System.Drawing.Image = barcode.GetBarcodeImage()
    image.Save(outputPath, ImageFormat.Png)
End Sub

Imports Neodynamic.SDK.Barcode
Imports System.Drawing.Imaging

Public Sub GenerateCode128(data As String, outputPath As String)
    Dim barcode As New BarcodeProfessional()
    barcode.Code = data
    barcode.Symbology = Symbology.Code128
    barcode.BarcodeUnit = BarcodeUnit.Pixel

    Dim image As System.Drawing.Image = barcode.GetBarcodeImage()
    image.Save(outputPath, ImageFormat.Png)
End Sub

IronBarcode 접근 방식:

using IronBarCode;

public void GenerateCode128(string data, string outputPath)
{
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .SaveAsPng(outputPath);
}

using IronBarCode;

public void GenerateCode128(string data, string outputPath)
{
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .SaveAsPng(outputPath);
}

Imports IronBarCode

Public Sub GenerateCode128(data As String, outputPath As String)
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .SaveAsPng(outputPath)
End Sub

Imports IronBarCode

Public Sub GenerateCode128(data As String, outputPath As String)
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .SaveAsPng(outputPath)
End Sub

System.Drawing.Imaging 임포트가 더 이상 필요하지 않습니다. BarcodeInfo 인스턴스와 해당 속성 할당이 단일 메서드 호출로 통합됩니다. 크기, 주석 및 출력 형식 옵션에 대한 자세한 내용은 1D 바코드 생성 가이드를 참조하십시오.

QR 코드 생성하기

신역동적 접근법:

using Neodynamic.SDK.Barcode;

public void GenerateQrCode(string data, string outputPath)
{
    var barcode = new BarcodeProfessional();
    barcode.Code = data;
    barcode.Symbology = Symbology.QRCode;
    barcode.QRCodeECL = QRCodeErrorCorrectionLevel.H;

    barcode.GetBarcodeImage().Save(outputPath, System.Drawing.Imaging.ImageFormat.Png);
}

using Neodynamic.SDK.Barcode;

public void GenerateQrCode(string data, string outputPath)
{
    var barcode = new BarcodeProfessional();
    barcode.Code = data;
    barcode.Symbology = Symbology.QRCode;
    barcode.QRCodeECL = QRCodeErrorCorrectionLevel.H;

    barcode.GetBarcodeImage().Save(outputPath, System.Drawing.Imaging.ImageFormat.Png);
}

Imports Neodynamic.SDK.Barcode
Imports System.Drawing.Imaging

Public Sub GenerateQrCode(data As String, outputPath As String)
    Dim barcode As New BarcodeProfessional()
    barcode.Code = data
    barcode.Symbology = Symbology.QRCode
    barcode.QRCodeECL = QRCodeErrorCorrectionLevel.H

    barcode.GetBarcodeImage().Save(outputPath, ImageFormat.Png)
End Sub

Imports Neodynamic.SDK.Barcode
Imports System.Drawing.Imaging

Public Sub GenerateQrCode(data As String, outputPath As String)
    Dim barcode As New BarcodeProfessional()
    barcode.Code = data
    barcode.Symbology = Symbology.QRCode
    barcode.QRCodeECL = QRCodeErrorCorrectionLevel.H

    barcode.GetBarcodeImage().Save(outputPath, ImageFormat.Png)
End Sub

IronBarcode 접근 방식:

using IronBarCode;

public void GenerateQrCode(string data, string outputPath)
{
    QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
        .SaveAsPng(outputPath);
}

using IronBarCode;

public void GenerateQrCode(string data, string outputPath)
{
    QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
        .SaveAsPng(outputPath);
}

Imports IronBarCode

Public Sub GenerateQrCode(data As String, outputPath As String)
    QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
        .SaveAsPng(outputPath)
End Sub

Imports IronBarCode

Public Sub GenerateQrCode(data As String, outputPath As String)
    QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
        .SaveAsPng(outputPath)
End Sub

세대 변환은 API 표면만 변경합니다. 이번 마이그레이션으로 인한 결정적인 차이점은 이제 동일한 애플리케이션이 동일한IronBarcode라이브러리와 라이선스를 통해 자신이 생성한 QR 코드도 읽을 수 있다는 것입니다. 2D 바코드 생성에 대한 자세한 내용은 2D 바코드 생성 가이드를 참조하십시오.

1D 바코드 읽기

신역동적 접근법:

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string[] Read1DBarcodes(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);
    return results?.Select(r => r.Value).ToArray() ?? Array.Empty<string>();
}

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string[] Read1DBarcodes(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);
    return results?.Select(r => r.Value).ToArray() ?? Array.Empty<string>();
}

Imports Neodynamic.SDK.BarcodeReader
Imports System.Drawing

Public Function Read1DBarcodes(imagePath As String) As String()
    Using bitmap As New Bitmap(imagePath)
        Dim reader As New BarcodeReader()
        Dim results = reader.Read(bitmap)
        Return If(results?.Select(Function(r) r.Value).ToArray(), Array.Empty(Of String)())
    End Using
End Function

Imports Neodynamic.SDK.BarcodeReader
Imports System.Drawing

Public Function Read1DBarcodes(imagePath As String) As String()
    Using bitmap As New Bitmap(imagePath)
        Dim reader As New BarcodeReader()
        Dim results = reader.Read(bitmap)
        Return If(results?.Select(Function(r) r.Value).ToArray(), Array.Empty(Of String)())
    End Using
End Function

IronBarcode 접근 방식:

using IronBarCode;

public string[] Read1DBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value).ToArray();
}

using IronBarCode;

public string[] Read1DBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value).ToArray();
}

Imports IronBarCode

Public Function Read1DBarcodes(imagePath As String) As String()
    Dim results = BarcodeReader.Read(imagePath)
    Return results.Select(Function(r) r.Value).ToArray()
End Function

Imports IronBarCode

Public Function Read1DBarcodes(imagePath As String) As String()
    Dim results = BarcodeReader.Read(imagePath)
    Return results.Select(Function(r) r.Value).ToArray()
End Function

Bitmap 구성과 System.Drawing 임포트가 제거됩니다.IronBarcode파일 경로를 직접 입력받습니다. 두 API에서 result.Value 속성 이름이 동일하므로 반환된 값을 처리하는 다운스트림 코드는 변경되지 않습니다. 여러 바코드를 이미지로 읽고 전처리하는 옵션에 대해서는 이미지에서 바코드 읽기 가이드 를 참조하십시오.

QR 코드 읽기 (이전에는 불가능)

신역동적 접근법:

// This method could not be implemented with Neodynamic Barcode Reader
public string ReadQrCode(string imagePath)
{
    throw new NotSupportedException(
        "Neodynamic Barcode Reader does not support QR codes");
}

// This method could not be implemented with Neodynamic Barcode Reader
public string ReadQrCode(string imagePath)
{
    throw new NotSupportedException(
        "Neodynamic Barcode Reader does not support QR codes");
}

' This method could not be implemented with Neodynamic Barcode Reader
Public Function ReadQrCode(imagePath As String) As String
    Throw New NotSupportedException("Neodynamic Barcode Reader does not support QR codes")
End Function

' This method could not be implemented with Neodynamic Barcode Reader
Public Function ReadQrCode(imagePath As String) As String
    Throw New NotSupportedException("Neodynamic Barcode Reader does not support QR codes")
End Function

IronBarcode 접근 방식:

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

Imports IronBarCode

Public Function ReadQrCode(imagePath As String) As String
    Dim result = BarcodeReader.Read(imagePath).FirstOrDefault()
    Return If(result?.Value, Nothing)
End Function

Imports IronBarCode

Public Function ReadQrCode(imagePath As String) As String
    Dim result = BarcodeReader.Read(imagePath).FirstOrDefault()
    Return If(result?.Value, Nothing)
End Function

2D 바코드 판독을 참조하는 모든 throw new NotSupportedException(...) 플레이스홀더가 표준 읽기 호출로 변환됩니다. 메서드 본문이 예외 발생에서 정상 작동하는 구현으로 변경됩니다. QR 코드는 특별한 취급이 필요하지 않습니다.IronBarcode형식을 자동으로 식별합니다.

PDF 문서에서 바코드 읽기 (새로운 기능)

신역동적 접근법:

// Neodynamic Reader cannot read barcodes from PDF files directly
// An image extraction step using a separate library was required before reading
// 아니요 direct equivalent exists

// Neodynamic Reader cannot read barcodes from PDF files directly
// An image extraction step using a separate library was required before reading
// 아니요 direct equivalent exists

IronBarcode 접근 방식:

using IronBarCode;

public void ReadBarcodesFromPdf(string pdfPath)
{
    var results = BarcodeReader.Read(pdfPath);

    foreach (var result in results)
    {
        Console.WriteLine($"Value: {result.Value} | Format: {result.Format} | Page: {result.PageNumber}");
    }
}

using IronBarCode;

public void ReadBarcodesFromPdf(string pdfPath)
{
    var results = BarcodeReader.Read(pdfPath);

    foreach (var result in results)
    {
        Console.WriteLine($"Value: {result.Value} | Format: {result.Format} | Page: {result.PageNumber}");
    }
}

Imports IronBarCode

Public Sub ReadBarcodesFromPdf(pdfPath As String)
    Dim results = BarcodeReader.Read(pdfPath)

    For Each result In results
        Console.WriteLine($"Value: {result.Value} | Format: {result.Format} | Page: {result.PageNumber}")
    Next
End Sub

Imports IronBarCode

Public Sub ReadBarcodesFromPdf(pdfPath As String)
    Dim results = BarcodeReader.Read(pdfPath)

    For Each result In results
        Console.WriteLine($"Value: {result.Value} | Format: {result.Format} | Page: {result.PageNumber}")
    Next
End Sub

IronBarcode PDF 문서의 모든 페이지에 있는 바코드를 직접 읽어냅니다. 결과에는 각 바코드가 발견된 페이지 번호가 반환됩니다. 이 기능은 추가 라이브러리나 중간 이미지 추출 단계를 필요로 하지 않습니다.

Neodynamic 바코드 API와IronBarcode매핑 참조

일반적인 마이그레이션 문제와 해결책

문제 1: 두 개의 포장 제거 주문

문제: 개발자가 Neodynamic 패키지 중 하나만 제거하고 다른 하나는 그대로 두면 컴파일 오류가 발생합니다. 두 SDK는 공통된 형식을 가지고 있지 않지만, 일부 소스 파일은 동일한 파일에서 두 네임스페이스를 모두 가져올 수 있기 때문입니다.

해결 방법: 소스 코드를 변경하기 전에 두 패키지를 모두 제거하십시오. 둘 모두 제거한 후, 모든 using Neodynamic.SDK.Barcode 및 using Neodynamic.SDK.BarcodeReader 지시문을 검색하고 함께 제거하세요:

dotnet remove package Neodynamic.SDK.Barcode
dotnet remove package Neodynamic.SDK.BarcodeReader

dotnet remove package Neodynamic.SDK.Barcode
dotnet remove package Neodynamic.SDK.BarcodeReader

그런 다음 다음 항목으로 감사를 진행하십시오.

grep -r "Neodynamic.SDK" --include="*.cs" .

grep -r "Neodynamic.SDK" --include="*.cs" .

문제 2: 이중 라이선스 구성 정리

문제: 두 Neodynamic 라이선스 블록은 종종 다른 위치에 나타납니다 — 하나는 애플리케이션 시작 클래스에, 다른 하나는 서비스 이니셜라이저에 있습니다. 만약 코드 블록 하나만 제거하면, 남은 코드는 더 이상 존재하지 않는 네임스페이스를 참조하게 되어 컴파일 오류가 발생합니다.

**해결 방법:**IronBarcode키를 추가하기 전에 Neodynamic 라이선스 속성 할당 4개를 모두 찾아서 한꺼번에 제거하십시오.

grep -r "LicenseOwner\|LicenseKey" --include="*.cs" .

grep -r "LicenseOwner\|LicenseKey" --include="*.cs" .

네 줄 모두를 하나의 할당문으로 바꾸세요:

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

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

Imports IronBarCode

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

Imports IronBarCode

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

문제 3: catch 블록에서 NotSupportedException 제거

문제: Neodynamic Reader를 사용했던 일부 코드베이스는 2D 바코드 판독의 조용한 실패를 처리하기 위해 특별히 catch (NotSupportedException) 블록을 추가했습니다. 해당 캐치 블록은 던지기 코드와 함께 제거되어야 합니다. 그렇지 않으면 catch 절은 더 이상 발생할 수 없는 코드 경로를 참조합니다.

해결책: 바코드 관련 파일에서 NotSupportedException 를 검색하고 각 발생을 검토하세요. 2D 형식 읽기 시도로 인해 예외가 발생한 경우, throw 문과 catch 문을 모두 제거하십시오.

grep -r "NotSupportedException" --include="*.cs" .

grep -r "NotSupportedException" --include="*.cs" .

throwing 메서드 본문을 BarcodeReader.Read(imagePath) 로 대체하고, 호출자에서 해당하는 catch 절을 제거하세요.

네오다이내믹 바코드 마이그레이션 체크리스트

사전 마이그레이션

• 모든 Neodynamic 패키지 참조를 검색하세요: grep -r "Neodynamic.SDK" --include="*.csproj" .
• 모든 Neodynamic 사용 지시문을 검색하세요: grep -r "using Neodynamic" --include="*.cs" .
• 라이선스 구성 위치 검색: grep -r "LicenseOwner\|LicenseKey" --include="*.cs" .`
• 모든 BarcodeInfo 인스턴스화 사이트를 검색하세요: grep -r "new BarcodeInfo\(\)" --include="*.cs" .
• 모든 Neodynamic 읽기 호출을 검색하세요: grep -r "BarcodeReader.Read" --include="*.cs" .
• 바코드 경로에서 모든 NotSupportedException 사용을 검색하세요: grep -r "NotSupportedException" --include="*.cs" .
• 2D 읽기 기능 부족 문제를 해결하기 위해 특별히 추가된 타사 라이브러리(ZXing .NET 또는 유사 라이브러리)가 있는지 확인하십시오. 이러한 라이브러리는 마이그레이션 후 제거할 수 있습니다.
• 모든 네오다이나믹 라이선스 키를 기록하여 검증 후 비밀 저장소에서 삭제할 수 있도록 하십시오.

코드 업데이트 작업

1. dotnet remove package Neodynamic.SDK.Barcode 실행
2. dotnet remove package Neodynamic.SDK.BarcodeReader 실행
3. dotnet add package IronBarcode 실행
4. 모든 using Neodynamic.SDK.Barcode 및 using Neodynamic.SDK.BarcodeReader 지시문 제거
5. 바코드 작업을 수행하는 모든 파일에 using IronBarCode 추가
6. Neodynamic 라이선스 구성 블록 두 개를 모두 제거합니다.
7. 애플리케이션 시작 시 한 번 IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY" 추가
8. new BarcodeInfo() + 속성 할당 + barcode.GetImage().Save(...) 을 BarcodeWriter.CreateBarcode(data, encoding).SaveAsPng(path) 으로 대체
9. 적절하게 QRCodeWriter 패턴을 QRCodeWriter.CreateQrCode() 이용하여 대체
10. BarcodeReader.Read(bitmap) 호출을 new Bitmap(imagePath) 구성을 제거하고 파일 경로를 BarcodeReader.Read(imagePath) 에 직접 전달하여 대체
11. 2D 판독을 위한 모든 throw new NotSupportedException(...) 플레이스홀더를 제거하고 BarcodeReader.Read(imagePath) 로 대체
12. 호출자에서 해당하는 catch (NotSupportedException) 블록 제거
13. 네오다이내믹 2D 읽기 기능의 부족한 부분을 보완하기 위해 추가된 타사 라이브러리를 모두 제거하십시오.

마이그레이션 후 테스트

• Code 128 바코드 생성 결과가 이전 설정값 및 DPI와 일치하는지 확인합니다.
• QR 코드 생성 결과가 스캔 가능한지 확인합니다.
• 1D 바코드 판독값이 이전 네오다이나믹 리더 구현과 동일한 값을 반환하는지 확인합니다.
• 이전에 NotSupportedException 를 던졌던 이미지에서 QR 코드 읽기가 성공하는지 확인
• 애플리케이션 입력에 DataMatrix 및 PDF417 형식이 포함되어 있는 경우 해당 형식 읽기가 성공적으로 완료되는지 확인합니다.
• 애플리케이션이 PDF 문서를 처리하는지 PDF 바코드 읽기 기능을 테스트합니다.
• 구성 파일 및 환경 변수에서 모든 Neodynamic 라이선스 키 참조가 제거되었는지 확인하십시오.
• 타사 2D 라이브러리(있는 경우)가 완전히 제거되었는지, 그리고 남아 있는 가져오기 항목 중 해당 라이브러리를 참조하는 항목이 없는지 확인하십시오.

##IronBarcode로 마이그레이션할 때의 주요 이점

통합 읽기/쓰기 기능: 마이그레이션 후IronBarcode에서 생성할 수 있는 모든 심볼은 동일한 라이브러리를 통해 다시 읽어올 수도 있습니다. 네오다이나믹의 생성기와 판독기 사이의 비대칭성, 즉 QR 코드, DataMatrix, PDF417 및 Aztec을 생성할 수는 있지만 사용할 수는 없었던 문제가 해결되었습니다. 이전에는 2D 읽기를 위해 별도의 해결 방법이나 타사 라이브러리가 필요했던 애플리케이션들이 추가적인 통합 작업 없이 해당 기능을 사용할 수 있게 되었습니다.

단일 라이선스 관리: 하나의 NuGet 패키지, 하나의 라이선스 키, 하나의 구성 블록으로 두 개의 개별 제품 구독을 대체합니다. 갱신, 핵심 인력 순환 및 환경 변수 관리가 절반으로 간소화됩니다. 관리비 절감은 일회성 성과가 아니라 지속적인 성과입니다.

**PDF 바코드 읽기 기능:**IronBarcode PDF 문서에서 바코드를 직접 읽어 바코드 값과 함께 페이지 번호 메타데이터를 반환합니다. 배송 명세서, 송장 또는 내장된 바코드가 포함된 의료 기록을 처리하는 애플리케이션은 더 이상 바코드 읽기를 지원하기 위해 중간 이미지 추출 단계나 추가 PDF 라이브러리가 필요하지 않습니다. 지원되는 바코드 형식 의 전체 목록을 참조하여 모든 심볼 및 입력 유형을 확인하십시오.

System.Drawing 종속성 제거: Neodynamic의 SDK는 System.Drawing에 의존하여, Linux 및 Docker 컨테이너에서 추가적인 네이티브 라이브러리 구성이 필요합니다. IronBarcode에는 System.Drawing 종속성이 없으므로, 동일한 코드베이스가 Windows, Linux 및 컨테이너화된 클라우드 환경에서 플랫폼별 구성 변경 없이 실행됩니다.

간소화된 라이선스 비용으로 완벽한 기능 활용: Neodynamic SDK 두 Plus 2D 판독을 위한 세 번째 라이브러리가 모두 필요했던 프로젝트는IronBarcode단일 라이선스로 제공하는 기능을 구현하기 위해 세 가지 종속성에 대한 비용을 지불하고 있었습니다. 생성 Plus 2D 판독이 모두 필요한 프로젝트의 경우, 마이그레이션을 통해 기술적 요구 사항과 라이선스 비용을 단일 상용 제품으로 통합할 수 있습니다. 최신 가격 정보는IronBarcode 라이선스 페이지 에서 확인할 수 있습니다.