Split SDKアーキテクチャ

Neodynamic SDK両方を購入するプロジェクトは、スタートアップ時に2つの別々のライセンスブロックを構成しなければなりません。二重のLicenseKey割り当ては異なる名前空間と異なるクラス名を使用し、どちらのブロックも他方を認識していません。

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

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

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

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

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

' Neodynamic: two products, two license configurations

' Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company"
BarcodeProfessional.LicenseKey = "GEN-KEY"

' Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company"
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY"

このパターンは、開発環境、ステージング環境、本番環境といったあらゆる環境で繰り返され、いずれかの製品がアップグレードまたは更新される際には必ず維持されなければなりません。

詳細な機能比較

ネオダイナミック・バーコードリーダー・アプローチ

Neodynamicバーコードリーダーは、直線型バーコードのみをサポートしています。 2次元バーコードがリーダーに送信されると、SDKは空またはnullの結果セットを返します。 例外は発生せず、何が起こったかを示すエラーメッセージも表示されません。 このSDKを使用するチームは、通常、QRコード画像に対してリーダーを呼び出すコードをデプロイした後、結果コレクションが常に空であることに気づき、この制限を発見します。

Neodynamic Readerを使用するコードベースでよく見られる防御パターンは、2Dフォーマットが想定される場合に例外を発生させる明示的なチェックです。

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 will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

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 will be null or empty — QR codes are not recognised by this SDK
    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 will be null or empty — QR codes are not recognised by this SDK
        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

このメソッドは、Neodynamic Reader SDK単体では完了できません。 NotSupportedExceptionは回避策ではありません、それは2D入力に対するリーダーの実際の能力境界を反映しています。

IronBarcodeのアプローチ

IronBarcodeは、同じBarcodeReader.Read()呼び出しを通じてすべてのサポートされているシンボロジーを読み取ります。 画像の内容からフォーマットが自動的に検出されます。 QRコード、Code 128、およびDataMatrixバーコードはすべて、同一の呼び出しコードを使用します。

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

Imports IronBarCode

Public Function ReadQrCode(imagePath As String) As String
    ' QR codes, DataMatrix, PDF417 — all handled automatically
    Dim result = BarcodeReader.Read(imagePath).FirstOrDefault()
    Return If(result?.Value, Nothing)
End Function

呼び出し元は、想定されるフォーマットを指定していません。 IronBarcodeはシンボルを識別し、値を返します。 マルチバーコード検出や画像前処理などの画像読み取りオプションの詳細については、 "画像からのバーコード読み取りガイド"を参照してください。

ネオダイナミック・バーコード・Professional・アプローチ

Neodynamicの生成APIはインスタンスベースです。 System.Drawing.Imageを返します。 画像はSystem.Drawing.Imaging.ImageFormat列挙を使用して保存されます:

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

Imports Neodynamic.SDK.Barcode
Imports System.Drawing

' Configure license first
BarcodeProfessional.LicenseOwner = "Your Company"
BarcodeProfessional.LicenseKey = "YOUR-KEY"

' Build the barcode through property assignment
Dim barcode As New BarcodeProfessional()
barcode.Code = "12345678"
barcode.Symbology = Symbology.Code128
barcode.BarcodeUnit = BarcodeUnit.Pixel

' Get image and save via System.Drawing
Dim image As Image = barcode.GetBarcodeImage()
image.Save("output.png", Imaging.ImageFormat.Png)

SDKは、DPI制御、テキスト配置、カラー設定、静音ゾーンのサイズ設定など、正当なカスタマイズオプションを提供します。 これらは、正確な物理的寸法が重要な印刷ワークフローにおいて役立ちます。 発電能力自体は完成している。 移行を促す制約は、生成側ではなく、読み取り側にある。

IronBarcodeのアプローチ

IronBarcodeは、流暢な静的解析手法を採用しています。 エンコーディングとデータはBarcodeWriter.CreateBarcode() にパラメータとして渡され、出力形式は戻されたオブジェクトのメソッド名として表現されます。 System.Drawingインポートは必要ありません:

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("output.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("output.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("output.png")

2Dバーコード生成には、専用のQRCodeWriterクラスがQRコードに特化した追加のオプションを提供します:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .SaveAsPng("qrcode.png")

サイズ設定や注釈オプション付きの1次元シンボルを生成する方法については、 "1次元バーコードの作成ガイド"を参照してください。 DataMatrixやPDF417を含む2次元バーコードの作成については、 "2次元バーコードの作成ガイド"を参照してください。

新力動的アプローチ

Neodynamicのバーコード機能は、2つの別個のライセンス製品に分かれています。 Barcode Professional SDKは生成機能を、Barcode Reader SDKは読み取り機能をそれぞれカバーしています。 各製品は個別に購入する必要があり、それぞれにライセンスキーが付属しています。 両方の製品を購入するチームは、2つのLicenseKey構成ブロックを維持し、2つの別個の更新日を追跡し、問題が発生したときには2つの別々のサポートチャンネルに対応する必要があります。

Barcode Professional SDKは、Basic版の単一開発者ライセンスが約$352から、Ultimate版が約$705から価格が設定され（開発者ライセンスはComponentSource経由）。 Barcode Reader SDKは別の価格があり、レガシー価格の下で供給されています—製品は2019年12月31日にサービス終了マークがされています。2D読み取りを必要とするプロジェクトは、Neodynamic製品でその要件を満たすことができません; 第三のライブラリを追加しなければなりません。 単一の統合ライセンスでカバーされる内容の完全なリストについては、 IronBarcodeがサポートするバーコードフォーマットのページをご覧ください。

IronBarcodeのアプローチ

IronBarcodeは、単一のライセンスキーで、サポートされているすべてのシンボル体系におけるバーコードの生成と読み取りといった、すべてのバーコード操作を網羅する単一製品として販売されています。 別途リーダーライセンス、別途ジェネレーターライセンスは不要で、2Dフォーマットのサポートに追加費用もかかりません。 ライセンスキーはアプリケーション起動時に一度設定され、それ以上の設定は不要です。

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

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

Imports IronBarCode

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

IronBarcode Liteは、開発者1人あたり749ドルで、すべての機能を網羅しています。 現在の価格帯とボリュームオプションについては、IronBarcodeのライセンスページをご覧ください。

QRコード読み取り要件

NeodynamicからIronBarcodeへ移行する最も一般的なケースは、Barcode Professional SDKで生成されたQRコードをBarcode Reader SDKで読み取ることができないという問題が発覚することです。 製品ラベルシステム、在庫管理ツール、または文書追跡ワークフローを構築するチームは、多くの場合、生成と読み取りをより大きなシステムの別々のフェーズとして実装します。 Barcode Professionalを使用して最初に生成を行った場合、読み取りコンポーネントを試行したときに初めて、リーダーの制限が明らかになります。 その時点で、プロジェクトは既に生成にNeodynamicを採用することを決定しており、2D読み取りをカバーするために3つ目のライブラリを追加すると、統一されたSDKがあれば発生しないバージョン管理の複雑さが生じる。

製品の複雑さを軽減する

一部のチームが移行する理由は、特定のフォーマットのギャップではなく、概念的には単一の機能であるものを2つの異なる製品で維持することによるオーバーヘッドが、繰り返し発生する摩擦点となるためである。 2つのパッケージが.csprojファイルに含まれ、2つのライセンス更新周期、2セットのリリースノートをレビューしなければならず、 .NETまたはWindowsの更新が適用されるときの不適合の2つの潜在的なソース、どれも単一の統合パッケージが提供する機能を超えるものではありません。 .NETアップグレードの一部として依存性の監査を行うチームは、Neodynamicの2重パッケージ構成を簡素化の機会としてしばしば識別します。

PDFバーコード処理

バーコードを含むPDF文書を処理するアプリケーションは、Neodynamic SDKの両方が同時に不十分となるシナリオの一例である。 生成用SDKも読み取り用SDKも、PDFファイルを開いてページからバーコード値を抽出することはできません。 出荷明細書、請求書、医療記録、またはPDFにバーコードが埋め込まれているあらゆる文書ワークフローを扱うチームは、読み取りを行う前に中間的な画像抽出ステップを実施する必要があります。 その抽出手順には追加のライブラリが必要となるため、このプロジェクトは既に3つ目の依存関係を抱えており、単一のIronBarcodeインストールで解消されるはずの制限を回避している。

読み書きにおけるフォーマットの一貫性

大規模なバーコードワークフローを運用するチームは、生成時と読み取り時におけるフォーマットサポートの不一致が、テストや検証上の問題を引き起こす場合があることに気づく。 システムが特定の目的でQRコードを生成し、別の目的で異なるフォーマットのコードを読み取る場合、生成器がサポートする形式と読み取り器がサポートする形式との間に乖離が生じるため、往復テストにギャップが生じる。 生成と読み込みが同じライブラリとサポートされるフォーマットリストを共有するシステムの方が、検証が容易になる。 生成されたバーコードが正常に読み取れるかどうかの検証は、複数のライブラリを統合したテストではなく、単一のライブラリでの操作となる。

二重パッケージの除去

Neodynamicからの移行には、Neodynamic.SDK.BarcodeReaderの両方のNuGetパッケージを削除する必要があります。 両方ともusingディレクティブをソースファイルから削除する必要があります。 それぞれでdotnet remove package を実行するだけで十分です。 両者の間には、追加のクリーンアップを必要とするような共通の依存関係はありません。

デュアルライセンス構成のクリーンアップ

2つのライセンス構成ブロック — 一つはNeodynamic.SDK.BarcodeReader.BarcodeReader用 — は単一のIronBarCode.License.LicenseKey割り当てで置き換えられます。 この割り当ては、通常、アプリケーションのスタートアップ時にProgram.csまたはアプリケーションの依存性注入ブートストラップで一度だけ行われます。 Neodynamicライセンスキーを格納する構成ファイルや環境変数は、移行が確認された後、退役できます。

サポートされていない例外の削除

開発中に2D読み取り制限に遭遇したコードベースには、QRコードやDataMatrixの読み取りにNotSupportedExceptionをスローするプレースホルダーメソッドが含まれていることがあります。 これらのメソッドは回避策ではありません — それらは能力が存在しなかったことを正直に認めています。 IronBarcodeへの移行後、それぞれのメソッド本体は標準のBarcodeReader.Read(imagePath)の呼び出しで置き換えられます。 特別な取り扱いは必要ありません。 フォーマットは自動的に検出されます。