Barkoder SDK 与 IronBarcode：C# 条码库对比

巴科德建筑的外观

SDK 的 C/C++ 核心负责处理图像处理。 iOS 和 Android 封装器通过平台原生 API 公开了该核心功能。以下两项均不在 .NET 环境中运行——任何 C# 项目中都不存在 using Barkoder; 语句：

// iOS — Swift only, no C# equivalent
let barkoderView = BarkoderView(frame: frame)
barkoderView.config = BarkoderConfig(licenseKey: "LICENSE_KEY") { config in
    config.decoder.decoderType = .code128
    config.decoder.deblurEnabled = true
}
barkoderView.startScanning { result in
    print(result.textualData ?? "No result")
}

// Android — Kotlin only, no C# equivalent
val barkoderView = BarkoderView(context)
barkoderView.config = BarkoderConfig("LICENSE_KEY")
barkoderView.config.decoder.decoderType = DecoderType.Code128
barkoderView.config.decoder.deblurEnabled = true
barkoderView.startScanning { result ->
    println(result.textualData)
}

在彻底放弃 Barkoder 之前，值得肯定它有哪些优点。 它之所以能在评测中占有一席之地，是因为它具备真正的实力。 MatrixSight 和 DeBlur Mode提供专有的损坏恢复技术，可以读取物理损坏、印刷质量差或在光线不足的情况下拍摄的条形码。 多条形码检测功能可同时解码单个摄像头画面中的多个条形码，使仓库工人能够一次扫描整个货架。 DPM（直接零件标记）扫描支持 DataMatrix 和其他格式，包括激光蚀刻和点阵喷丸配置，而大多数通用库都无法很好地处理这些配置。 高密度格式支持包括 PDF417、Aztec 和其他 2D 格式，在移动相机上具有很高的精度。

详细功能对比

条形码 SDK 方法

Barkoder 平台列表很明确：iOS Native（Swift / Objective-C）、Android Native（Kotlin / Java）、React Native、Flutter、Cordova、Capacitor。 不支持.NET、C#、. .NET MAUI、Xamarin、Windows、Linux 和ASP.NET Core 。 该SDK的架构是围绕移动设备上的实时摄像头管道构建的。它没有基于文件的输入模式、没有流媒体API、没有批处理路径，也没有服务器端执行模型。

缺少.NET SDK 并非小问题，而是一个完全的障碍。 没有NuGet包可供安装，没有异步 API 接口，没有依赖注入集成，不支持 Azure 或 AWS Lambda，也没有 PDF 处理功能。 社区版 MAUI 绑定仅公开了 SDK 的一个子集，并且不提供生产环境支持。

IronBarcode方法

IronBarcode可通过NuGet使用单个命令进行安装，并在启动时使用许可证密钥进行初始化：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Read a barcode from an image
var results = BarcodeReader.Read("scan.png");
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Value: {result.Value}");
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Read a barcode from an image
var results = BarcodeReader.Read("scan.png");
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Value: {result.Value}");
}

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

' Read a barcode from an image
Dim results = BarcodeReader.Read("scan.png")
For Each result In results
    Console.WriteLine($"Format: {result.Format}")
    Console.WriteLine($"Value: {result.Value}")
Next

该库完全在本地运行——没有网络调用，没有数据传输，没有外部依赖。 它与ASP.NET Core依赖注入集成，支持 async/await，无需修改即可部署到 Docker、Azure Functions 和 AWS Lambda。 有关生产级ASP.NET Core集成，请参阅IronBarcode文档。

条形码 SDK 方法

Barkoder 的 DeBlur 模式会在解码尝试之前应用图像预处理——对比度增强、锐化、旋转校正。 此功能仅在移动摄像头处理流程中运行。该模式在扫描开始前于 SDK 层进行配置，摄像头视频流将持续处理。 没有等效的基于文件的路径。

// iOS Swift — not usable from C#
barkoderView.config = BarkoderConfig(licenseKey: "LICENSE_KEY") { config in
    config.decoder.deblurEnabled = true
    config.decoder.decoderType = .code128
}
barkoderView.startScanning { result in
    print(result.textualData ?? "No result")
}

IronBarcode方法

IronBarcode 通过 ReadingSpeed.ExtremeDetail 解决了同样的问题，它激活了一个多遍图像分析流程——在尝试解码之前应用基于 ML 的损伤恢复、对比度增强、锐化和旋转校正。 这适用于任何文件、流或字节数组输入：

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("worn-shipping-label.png", options);

if (results.Any())
{
    Console.WriteLine($"Recovered: {results.First().Value}");
}
else
{
    Console.WriteLine("Could not decode — image quality too low");
}

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("worn-shipping-label.png", options);

if (results.Any())
{
    Console.WriteLine($"Recovered: {results.First().Value}");
}
else
{
    Console.WriteLine("Could not decode — image quality too low");
}

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.ExtremeDetail,
    .ExpectMultipleBarcodes = False
}

Dim results = BarcodeReader.Read("worn-shipping-label.png", options)

If results.Any() Then
    Console.WriteLine($"Recovered: {results.First().Value}")
Else
    Console.WriteLine("Could not decode — image quality too low")
End If

ReadingSpeed.Balanced 可以处理大多数干净或轻微损坏的条形码，而且速度更快。 保留 ExtremeDetail 用于 Balanced 失败的情况——它很彻底，但速度明显较慢。 有关读取复杂条形码的更多指导，请参阅IronBarcode读取文档。

条形码 SDK 方法

Barkoder 的多条形码模式可以从单个相机帧中同时检测和解码多个条形码。 在仓库环境中，一名工人将手机举过货架，一次性接收所有条形码的值。 这是在扫描开始前在 SDK 级别配置的：

// Android Kotlin — not usable from C#
barkoderView.config.decoder.multicodingEnabled = true
barkoderView.startScanning { results ->
    results.forEach { result ->
        println("${result.barcodeType}: ${result.textualData}")
    }
}

IronBarcode方法

在.NET服务器端应用程序中，多条形码场景通常涉及一个文档——带有发货跟踪条形码和产品条形码的发票，或者每页包含多个项目的发货清单。IronBarcode使用 ExpectMultipleBarcodes = true 来处理这种情况，同样的选项对图像和 PDF 也同样有效：

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
};

// Works on images and PDFs — single method call
var results = BarcodeReader.Read("shipping-manifest.pdf", options);

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}");
}

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
};

// Works on images and PDFs — single method call
var results = BarcodeReader.Read("shipping-manifest.pdf", options);

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}");
}

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

' Works on images and PDFs — single method call
Dim results = BarcodeReader.Read("shipping-manifest.pdf", options)

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}")
Next

无需页面提取，无需多次请求，无需每个条形码的网络开销。 PDF 文件可通过一次调用直接读取。 有关多条形码和 PDF 读取的更多信息，请参阅IronBarcode文档。

条形码 SDK 方法

Barkoder 支持对激光蚀刻和点阵标记进行 DPM 配置的 DataMatrix 读取。 该 SDK 还支持 PDF417、Aztec 和其他高密度 2D 格式，在移动摄像头上具有很高的精度。 所有这些操作都在 iOS 或 Android 的相机处理流程中进行：

// iOS Swift — not usable from C#
barkoderView.config = BarkoderConfig(licenseKey: "LICENSE_KEY") { config in
    config.decoder.decoderType = .dataMatrix
}
barkoderView.startScanning { result in
    print(result.textualData ?? "No result")
}

Barkoder 不生成 DataMatrix 或任何其他格式的条形码。 这是一个只读 SDK。

IronBarcode方法

IronBarcode可原生读取和生成 DataMatrix 数据。 在读取方面，ReadingSpeed.ExtremeDetail 可以处理激光蚀刻 DPM 标记典型的低对比度和粗糙边缘。 在生成方面，BarcodeWriter.CreateBarcode() 生成用于创建零件标签的 DataMatrix：

using IronBarCode;

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

// Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix)
    .SaveAsPng("part-label.png");

// Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("branded-qr.png");

// Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
var results = BarcodeReader.Read("etched-part.png");

using IronBarCode;

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

// Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix)
    .SaveAsPng("part-label.png");

// Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("branded-qr.png");

// Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
var results = BarcodeReader.Read("etched-part.png");

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

' Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("part-label.png")

' Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500) _
    .AddBrandLogo("company-logo.png") _
    .SaveAsPng("branded-qr.png")

' Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
Dim results = BarcodeReader.Read("etched-part.png")

有关支持的格式和生成选项的完整列表，请参阅IronBarcode条形码生成指南。

.NET项目要求

最常见的场景很简单：开发人员或团队正在构建.NET应用程序（ ASP.NET Core、Windows 服务、控制台工具、桌面应用程序），并在研究过程中遇到了 Barkoder。 他们阅读了有关 MatrixSight、DeBlur 和多条形码检测的内容，发现这些功能很有吸引力，然后发现这些功能都无法通过 C# 访问。 评估在NuGet结束。 在这种情况下，各团队并没有放弃 Barkoder； 他们从一开始就为自己的平台找到了合适的工具。 IronBarcode是针对 Barkoder 在移动端所提出的需求而开发的 .NET解决方案。

服务器端条形码处理工作流程

有些团队最初会使用移动扫描应用（例如 Barkoder 或其他移动 SDK）来构建条形码处理工作流程原型，之后需要在服务器端复制或扩展该工作流程。常见的例子包括通过 API 接口处理上传的条形码图像、从文档管理系统中的 PDF 文档读取条形码，或者批量处理扫描的标签存档。 Barkoder 没有服务器端部署模型，因此这些工作流程都无法实现。 IronBarcode使用相同的静态 API 在ASP.NET Core、Azure Functions、Docker 和AWS Lambda中处理所有这些问题。

条形码生成要求

为物流、库存或合规性构建.NET应用程序的团队经常发现，读取条形码只是工作流程的一半。 生成条形码——打印标签、在文档中嵌入二维码、生成运输清单——同样重要。 Barkoder 的设计是只读的； 它没有发电能力。 当项目范围扩展到纯粹的阅读之外时，一个涵盖工作流程两端的库就无需集成第二个依赖项。 IronBarcode通过统一的 API 提供 50 多种格式的读取和生成功能。

PDF文档处理

在.NETEnterprise应用程序中，条形码经常出现在 PDF 文档中——例如发票、装运清单、医疗记录、合规文件等。 Barkoder 对这种工作流程毫无概念； 它专为移动设备上的摄像头输入而设计。需要读取传入 PDF 文档中的条形码、提取条形码数据以用于业务逻辑或验证文档存档中是否存在条形码的团队，需要一个具有原生 PDF 支持的库。 IronBarcode直接从 PDF 读取条形码，无需中间图像提取。

定价和部署可预测性

Barkoder 的移动 SDK 定价是围绕移动应用程序和分发模式构建的。 对于正在评估.NET环境工具的团队来说，这种定价模式毫无意义——SDK 根本不在.NET中运行。 当团队确定IronBarcode是其平台的合适工具时，定价模式很简单：一次性永久许可证，不收取任何请求费用，也没有数量限制，无论处理多少条形码。

从移动摄像头输入到基于文件的输入

已经实现了基于 Barkoder 的移动扫描原型，并且需要在.NET中复制该功能的团队会发现，输入模型从相机帧变为文件、流或字节数组。IronBarcode接受多种形式的相同数据——文件路径字符串、Stream、byte[] 或 System.Drawing.Image。 条形码处理逻辑的其他部分都相同：

// All of these call the same underlying pipeline
var results1 = BarcodeReader.Read("scan.png");
var results2 = BarcodeReader.Read(imageStream);
var results3 = BarcodeReader.Read(imageBytes);

// All of these call the same underlying pipeline
var results1 = BarcodeReader.Read("scan.png");
var results2 = BarcodeReader.Read(imageStream);
var results3 = BarcodeReader.Read(imageBytes);

' All of these call the same underlying pipeline
Dim results1 = BarcodeReader.Read("scan.png")
Dim results2 = BarcodeReader.Read(imageStream)
Dim results3 = BarcodeReader.Read(imageBytes)

速度与准确性的权衡

Barkoder 的 DeBlur 模式在配置后始终处于激活状态，并在移动相机循环中运行。IronBarcode 通过 ReadingSpeed 明确地暴露了准确性与速度之间的权衡。 对于大多数文件，ReadingSpeed.Balanced 是合适的。 对于 Balanced 解码失败的损坏或降级输入，ReadingSpeed.ExtremeDetail 将应用完整的多遍机器学习流水线。对于性能要求较高的工作流程，建议将批处理结构设置为默认使用 Balanced，仅在解码失败时才回退到 ExtremeDetail。

ASP.NET Core中的异步集成

IronBarcode 的 BarcodeReader.Read() 方法是同步的。 在处理并发请求的 ASP.NET Core 终结点中，将调用包装在 Task.Run() 中，以避免阻塞请求线程：

var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));

var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));

Dim results = Await Task.Run(Function() BarcodeReader.Read(imageBytes, options))

性能格式规范

IronBarcode默认自动检测条形码格式。 对于已知预期格式的高吞吐量场景，指定格式可以减少处理时间，因为它可以消除不匹配的格式测试。 当格式事先已知时，使用 BarcodeReaderOptions.ExpectedBarcodeFormats 来限制搜索范围。