拆分式 SDK 架构

购买两个Neodynamic SDK的项目必须在启动时配置两个独立的许可证块。双重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条码阅读器仅支持线性条码。 当向读取器提交二维条形码时，SDK 返回空结果集或 null 结果集。 没有引发异常，也没有错误消息表明发生了什么。 使用此 SDK 的团队通常会在部署调用读取器读取二维码图像的代码后发现此限制，并观察到结果集合始终为空。

在使用 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() 调用读取所有支持的条码类型。 系统会根据图像内容自动检测格式。 二维码、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类提供特定于二维码的附加选项：

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

有关生成具有尺寸和注释选项的一维条码的指导，请参阅创建一维条码指南。 有关二维条码的创建（包括 DataMatrix 和 PDF417），请参阅二维条码创建指南。

新动力学方法

Neodynamic 的条形码功能分为两个独立授权的产品。 条码ProfessionalSDK 涵盖条码生成，条码读取器 SDK 涵盖条码读取。 每款产品都需要单独购买，并配有单独的许可证密钥。 购买两个产品的团队必须维护两个LicenseOwner / LicenseKey配置块，跟踪两个单独的续约日期，并在出现问题时处理两个独立的支持渠道。

条码专业 SDK 的售价从单个开发者 Basic 版许可证大约352美元起，而终极版大约705美元起（通过 ComponentSource 购买开发者许可证）。 条码阅读器 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单个开发者版本售价为 749 美元，涵盖所有功能。 有关当前定价等级和批量选项，请参阅IronBarcode许可页面。

二维码读取要求

导致 Neodynamic 团队转向IronBarcode 的最常见情况是，他们发现 Barcode Professional SDK 生成的二维码无法被 Barcode Reader SDK 读取。 构建产品标签系统、库存管理工具或文档跟踪工作流程的团队通常会将生成和读取作为更大系统中的独立阶段来实现。 当首先使用 Barcode Professional构建生成过程时，只有在尝试读取组件时，读取器的限制才会显现出来。 到那时，该项目已经承诺使用 Neodynamic 进行生成，而添加第三个库来涵盖 2D 阅读会引入版本管理的复杂性，而统一的 SDK 则不会出现这种情况。

降低产品复杂性

有些团队迁移并非因为存在特定的格式差异，而是因为维护两个独立产品来实现概念上单一的功能所带来的开销，成为了反复出现的摩擦点。 在 .csproj 文件中有两个包，两个许可证续约周期，两个发布说明集可供审查，以及在应用 .NET 或 Windows 更新时可能出现的两个不兼容来源——所有这些开销都没有提供单一统一包无法提供的功能。团队在进行 .NET 升级时进行依赖审查时，常将 Neodynamic 的双包方案视为简化机会。

PDF条形码处理

处理包含条形码的 PDF 文档的应用程序代表了 Neodynamic SDK 同时无法满足需求的场景。 生成 SDK 和读取器 SDK 都无法打开 PDF 文件并从其页面中提取条形码值。 处理货运清单、发票文件、医疗记录或任何在 PDF 中嵌入条形码的文档工作流程的团队，必须在进行任何读取之前实施中间图像提取步骤。 该提取步骤需要额外的库，这意味着该项目已经存在第三个依赖项，以解决单个IronBarcode安装即可消除的限制。

读写格式的一致性

大规模运行条形码工作流程的团队有时会发现，生成和读取之间格式支持的不一致会造成测试和验证问题。 当一个系统为一种目的生成二维码，并为另一种目的读取不同格式类型的二维码时，生成器支持的内容与读取器支持的内容之间的差异会在往返测试中造成差距。 生成和读取共享同一个库和同一个支持格式列表的系统更容易验证。 验证生成的条形码是否可以成功读取，变成了单库操作，而不是多库集成测试。

双包装移除

从 Neodynamic 迁移需要删除两个 NuGet 包：Neodynamic.SDK.Barcode 和 Neodynamic.SDK.BarcodeReader。 两个都必须从using指令也必须从源文件中移除。 为每个运行dotnet remove package是足够的； 两者之间没有需要额外清理的共享依赖项。

双许可证配置清理

两个许可证配置块——一个用于IronBarCode.License.LicenseKey分配替换。 此分配在应用程序启动时进行一次，通常在Program.cs或应用程序的依赖注入引导中进行。在验证迁移后，可以撤销存储Neodynamic许可证密钥的任何配置文件或环境变量。

NotSupportedException 移除

在开发过程中遇到2D读取限制的代码基常包含抛出NotSupportedException用于QR码或DataMatrix读取的占位方法。 这些方法不是变通方法——它们是对能力不存在的诚实承认。迁移到IronBarcode后，每个此类方法体都被标准BarcodeReader.Read(imagePath)调用替换。 无需特殊处理； 系统会自动检测格式。