Neodynamic Barcode Professional 与 IronBarcode：C# 条码库对比

拆分式 SDK 架构

购买了两个 Neodynamic SDK 的项目必须在启动时配置两个独立的许可证块。这两个许可证块 LicenseOwner 和 LicenseKey 使用不同的命名空间和类名，并且彼此之间互不感知：

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

// Generation license (Barcode Professional SDK)
BarcodeInfo.LicenseOwner = "Company";
BarcodeInfo.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)
BarcodeInfo.LicenseOwner = "Company";
BarcodeInfo.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)
BarcodeInfo.LicenseOwner = "Company"
BarcodeInfo.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 格式时引发异常：

// 新动力条形码阅读器 SDK: QR code reading is not supported
using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var results = BarcodeReader.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;
}

// 新动力条形码阅读器 SDK: QR code reading is not supported
using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var results = BarcodeReader.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 results = BarcodeReader.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 是基于实例的。 构造一个 BarcodeInfo 对象，分别赋值其属性，并调用 GetImage() 返回一个 System.Drawing.Image。 然后使用 System.Drawing.Imaging.ImageFormat 枚举保存图像：

using Neodynamic.SDK.Barcode;

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

// Build the barcode through property assignment
var barcode = new BarcodeInfo();
barcode.Value = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.TextAlign = BarcodeTextAlignment.BelowCenter;
barcode.Dpi = 300;

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

using Neodynamic.SDK.Barcode;

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

// Build the barcode through property assignment
var barcode = new BarcodeInfo();
barcode.Value = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.TextAlign = BarcodeTextAlignment.BelowCenter;
barcode.Dpi = 300;

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

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

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

' Build the barcode through property assignment
Dim barcode As New BarcodeInfo()
barcode.Value = "12345678"
barcode.Symbology = Symbology.Code128
barcode.TextAlign = BarcodeTextAlignment.BelowCenter
barcode.Dpi = 300

' Get image and save via System.Drawing
Dim image As Image = barcode.GetImage()
image.Save("output.png", 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")

对于二维条形码生成，专用的 QRCodeWriter 类提供了特定于二维码的其他选项：

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

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

新动力学方法

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

条形码ProfessionalSDK 的单开发者许可证价格约为 245 美元。 条形码读取器 SDK 需要单独付费。因此，一个既需要生成条形码又需要读取一维条形码的项目，对于单个开发人员来说，总支出可能接近或超过 500 美元。 需要 2D 读取的项目，无论价格如何，Neodynamic 产品都无法满足这一要求——必须添加第三个库。 请参阅IronBarcode支持的条形码格式页面，了解单个统一许可证涵盖的完整列表。

IronBarcode方法

IronBarcode作为一款单一产品出售，它涵盖所有条码操作——生成和读取所有支持的条码符号——只需一个许可证密钥即可完成。 没有单独的阅读器许可证，没有单独的生成器许可证，2D 格式支持也不收取额外费用。 许可证密钥在应用程序启动时设置一次，无需其他配置：

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-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。 必须从 .csproj 文件中删除这两个指令，并且必须从源文件中删除相应的 using 指令。 对每个运行 dotnet remove package 就足够了； 两者之间没有需要额外清理的共享依赖项。

双许可证配置清理

两个许可证配置块——一个用于 BarcodeInfo，一个用于 Neodynamic.SDK.BarcodeReader.BarcodeReader——都被一个 IronBarCode.License.LicenseKey 赋值所取代。 此分配在应用程序启动时执行一次，通常在 Program.cs 或应用程序的依赖注入引导程序中执行。任何存储 Neodynamic 许可证密钥的配置文件或环境变量都可以在迁移验证后停用。

NotSupportedException 移除

在开发过程中遇到 2D 读取限制的代码库通常包含占位符方法，这些方法会抛出 NotSupportedException 错误，导致无法读取 QR 码或 DataMatrix 码。 这些方法并非权宜之计，而是坦诚地承认该功能此前并不存在。迁移到IronBarcode后，每个此类方法体都替换为标准的 BarcodeReader.Read(imagePath) 调用。 无需特殊处理； 系统会自动检测格式。