근본적인 문제

완전한 바코드 워크플로우를 위해 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;
}

Imports Neodynamic.SDK.BarcodeReader
Imports System.Drawing

Public Function ReadQrCode(imagePath As String) As String
    Using bitmap As New Bitmap(imagePath)
        Dim reader As New BarcodeReader()
        Dim results = reader.Read(bitmap)

        ' Results are always null or empty for 2D barcodes
        If results Is Nothing OrElse Not results.Any() Then
            Throw New NotSupportedException("Neodynamic Barcode Reader does not support QR codes")
        End If

        Return results.First().Value
    End Using
End Function

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

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(...) 플레이스홀더는 이 마이그레이션 동안 제거되고 실제 판독 호출로 대체됩니다.

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"

// 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"

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

코드 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

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

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

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

세대 변환은 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

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

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

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

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

' 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

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

문제 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"

문제 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 라이브러리(있는 경우)가 완전히 제거되었는지, 그리고 남아 있는 가져오기 항목 중 해당 라이브러리를 참조하는 항목이 없는지 확인하십시오.