基本的な問題

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キー割り当てに置き換えてください。 この割り当ては、アプリケーションのスタートアップ時に一度行われます—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"

Neodynamicのライセンスキーを保持している設定ファイル、環境変数、またはシークレットストアは、移行が検証された後に廃止できます。

Code 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バーコードの作成ガイド"を参照してください。

1次元バーコードの読み取り

新力学的アプローチ：

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

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：2つの荷物の撤去命令

問題点：開発者が一方のNeodynamicパッケージのみを削除し、もう一方を残した場合、2つのSDKは型を共有していないにもかかわらず、一部のソースファイルでは両方の名前空間が同じファイル内でインポートされている可能性があるため、コンパイルエラーが発生します。

解決策：ソースコードを変更する前に、両方のパッケージを削除してください。 両方を削除した後、すべての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：デュアルライセンス構成のクリーンアップ

問題：2つのNeodynamicライセンスブロックが異なる場所に表示されることが多い — 1つはアプリケーション起動クラス、もう1つはサービスイニシャライザ内。 ブロックを1つだけ削除した場合、残りのコードは既に存在しない名前空間を参照するため、コンパイルエラーが発生します。

解決策： Neodynamicライセンスのプロパティ割り当て4つすべてを検索し、 IronBarcodeキーを追加する前にそれらをまとめて削除します。

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

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

4行すべてを1つの代入文に置き換えてください。

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

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

Imports IronBarCode

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

問題3：CatchブロックからのNotSupportedExceptionの削除

問題： ネオダイナミックリーダーを使用した一部のコードベースは、2Dバーコード読み取りのサイレントフェイルに対処するためにcatch (NotSupportedException)ブロックを追加しました。 それらのcatchブロックは、例外をスローするコードとともに削除する必要があります。 そうでない場合、catch節は発生することのないコードパスを参照しています。

解決策： バーコード関連のファイルでNotSupportedExceptionを検索し、各出現を確認します。 2Dフォーマットの読み取り試行に応答して例外が発生した場合は、throwとcatchの両方を削除してください。

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

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

例外を投げるメソッドの本体をBarcodeReader.Read(imagePath)に置き換え、コーラーから対応するキャッチ節を削除します。

移行前

• すべてのネオダイナミックパッケージ参照を検索：grep -r "Neodynamic.SDK" --include="*.csproj" .
• すべてのネオダイナミック使用ディレクティブを検索：grep -r "using Neodynamic" --include="*.cs" .
• ライセンス構成の場所を検索します: grep -r "LicenseOwner\|LicenseKey" --include="*.cs" .
• すべてのgrep -r "new BarcodeInfo\(\)" --include="*.cs" .
• すべてのネオダイナミック読み取り呼び出しを検索：grep -r "BarcodeReader.Read" --include="*.cs" .
• バーコードパスでのすべてのgrep -r "NotSupportedException" --include="*.cs" .
• 2D読み取りギャップを埋めるために特別に追加されたサードパーティライブラリ（ZXing .NETなど）を特定します。これは移行後に削除できます。
• すべての Neodynamic ライセンス キーを記録し、検証後にシークレット ストアから削除できるようにします。

コード更新タスク

1. dotnet remove package Neodynamic.SDK.Barcodeを実行
2. dotnet remove package Neodynamic.SDK.BarcodeReaderを実行
3. dotnet add package IronBarcodeを実行
4. すべてのusing Neodynamic.SDK.BarcodeReaderディレクティブを削除
5. バーコード操作を行うすべてのファイルにusing IronBarCodeを追加
6. 両方の Neodynamic ライセンス構成ブロックを削除します。
7. アプリケーションのスタートアップ時に一度IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"を追加
8. new BarcodeInfo() + プロパティの割り当て + BarcodeWriter.CreateBarcode(data, encoding).SaveAsPng(path)に置き換え
9. QRCodeWriter.CreateQrCode()を使用して適切に置き換える
10. BarcodeReader.Read(imagePath)に渡すことにより置き換える
11. 2D読み取り用のすべてのBarcodeReader.Read(imagePath)に置き換える
12. コーラーから対応するcatch (NotSupportedException)ブロックを削除
13. Neodynamic 2D の読み取りギャップを埋めるためだけに追加されたサードパーティライブラリをすべて削除します。

移行後のテスト

コード128バーコード生成の結果が、以前の寸法とDPI設定に一致することを確認する

• QRコード生成がスキャン可能な出力を生成することを確認する
• 1Dバーコード読み取りが、以前のNeodynamic Reader実装と同じ値を返すことを検証します。
• 以前にNotSupportedExceptionを投げた画像でQRコードの読み取りが成功することを確認 アプリケーションの入力にDataMatrixおよびPDF417形式が含まれている場合、これらの形式の読み取りが成功することを確認します。 アプリケーションがPDFドキュメントを処理する場合、PDFバーコードの読み取りをテストします。
• 設定ファイルおよび環境変数から、Neodynamicのライセンスキーに関するすべての参照が削除されていることを確認してください。 サードパーティ製の2Dライブラリ（存在する場合）が完全に削除され、残りのインポートで参照されていないことを確認してください。