Scanbot SDK 与 IronBarcode：C# 条形码库对比

摄像机流水线架构

Scanbot 的架构需要在应用程序启动时进行初始化，然后调用摄像头进行扫描。 没有接受文件路径或流的 BarcodeScanner.Open() 重载； 方法签名需要 BarcodeScannerConfiguration，因为整个操作都是由摄像头驱动的：

// In MauiProgram.cs or App.xaml.cs — initialization required before any scan
ScanbotSDK.Initialize(new ScanbotSDKConfiguration
{
    LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
    EnableLogging = false
});

// Configure accepted formats and camera appearance
var configuration = new BarcodeScannerConfiguration();
configuration.BarcodeFormats = new[]
{
    BarcodeFormat.Code128,
    BarcodeFormat.QrCode,
    BarcodeFormat.Ean13
};

// Open full-screen camera scanner — UI takes over the entire screen
var result = await ScanbotBarcodeSDK.BarcodeScanner.Open(configuration);

if (result.Status == OperationResult.Ok)
{
    foreach (var barcode in result.Barcodes)
        Console.WriteLine($"{barcode.Format}: {barcode.Text}");
}

// In MauiProgram.cs or App.xaml.cs — initialization required before any scan
ScanbotSDK.Initialize(new ScanbotSDKConfiguration
{
    LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
    EnableLogging = false
});

// Configure accepted formats and camera appearance
var configuration = new BarcodeScannerConfiguration();
configuration.BarcodeFormats = new[]
{
    BarcodeFormat.Code128,
    BarcodeFormat.QrCode,
    BarcodeFormat.Ean13
};

// Open full-screen camera scanner — UI takes over the entire screen
var result = await ScanbotBarcodeSDK.BarcodeScanner.Open(configuration);

if (result.Status == OperationResult.Ok)
{
    foreach (var barcode in result.Barcodes)
        Console.WriteLine($"{barcode.Format}: {barcode.Text}");
}

Imports System

' In MauiProgram.vb or App.xaml.vb — initialization required before any scan
ScanbotSDK.Initialize(New ScanbotSDKConfiguration With {
    .LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
    .EnableLogging = False
})

' Configure accepted formats and camera appearance
Dim configuration As New BarcodeScannerConfiguration()
configuration.BarcodeFormats = New BarcodeFormat() {
    BarcodeFormat.Code128,
    BarcodeFormat.QrCode,
    BarcodeFormat.Ean13
}

' Open full-screen camera scanner — UI takes over the entire screen
Dim result = Await ScanbotBarcodeSDK.BarcodeScanner.Open(configuration)

If result.Status = OperationResult.Ok Then
    For Each barcode In result.Barcodes
        Console.WriteLine($"{barcode.Format}: {barcode.Text}")
    Next
End If

SDK 实时处理实时视频帧，在取景器中突出显示检测到的条形码，并在条形码确认或用户取消时返回。 配置对象控制相机用户界面外观，而不是处理行为。 这就是完整的模型。

详细功能对比

Scanbot SDK 方法

Scanbot 的架构基于原生相机管道构建。当调用 BarcodeScanner.Open(configuration) 时，该库会将控制权交给设备在 iOS 和 Android 上的原生相机 API，从而实现全屏相机体验。 该库持续处理实时视频帧，对每一帧应用条形码检测，并在确认条形码或用户关闭扫描器时将控制权返回给调用应用程序。 Scanbot 模型中没有静态图像的概念——输入始终是来自设备摄像头的实时视频帧流。

该设计可带来流畅的扫描体验：实时条形码在取景器中突出显示，可配置的扫描区域具有纵横比控制，手电筒切换，音频和触觉反馈，以及方向锁定。 这些是 Scanbot 为移动相机使用场景投入开发的 UI 功能。 但缺点是，该库与相机硬件以及驱动它的移动操作系统密不可分。

IronBarcode方法

IronBarcode接受任何包含条形码的图像的二进制表示形式，并通过相同的静态方法返回解码结果，而不管图像是如何获得的：

// Install: dotnet add package IronBarcode
IronBarCode.License.LicenseKey = "YOUR-KEY";

// From a file path — works in any project type
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// From a PDF — reads all barcodes on all pages
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

// From a stream — useful for HTTP file uploads
using var stream = File.OpenRead("document.pdf");
var streamResults = BarcodeReader.Read(stream);

// With processing options
var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced };
var configuredResults = BarcodeReader.Read("image.png", options);

// Install: dotnet add package IronBarcode
IronBarCode.License.LicenseKey = "YOUR-KEY";

// From a file path — works in any project type
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// From a PDF — reads all barcodes on all pages
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

// From a stream — useful for HTTP file uploads
using var stream = File.OpenRead("document.pdf");
var streamResults = BarcodeReader.Read(stream);

// With processing options
var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced };
var configuredResults = BarcodeReader.Read("image.png", options);

Imports IronBarCode
Imports System.IO

' Install: dotnet add package IronBarcode
License.LicenseKey = "YOUR-KEY"

' From a file path — works in any project type
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"{result.Value} ({result.Format})")
Next

' From a PDF — reads all barcodes on all pages
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' From a stream — useful for HTTP file uploads
Using stream = File.OpenRead("document.pdf")
    Dim streamResults = BarcodeReader.Read(stream)
End Using

' With processing options
Dim options = New BarcodeReaderOptions With {.Speed = ReadingSpeed.Balanced}
Dim configuredResults = BarcodeReader.Read("image.png", options)

同一个调用可以在控制台应用程序、 ASP.NET Core控制器、Azure 函数、WPF 表单或 MAUI 页面中运行。 IronBarcode可以直接从 PDF 中读取条形码——不是从 PDF 中提取图像，而是直接解析 PDF 结构，在每一页上查找条形码。

Scanbot SDK 方法

Scanbot 的软件包目标为 net8.0-android 和 net8.0-ios。 一个只声明了这两个目标的 .NET MAUI Application 项目将成功构建。 但是，当将 net8.0-windows 或 net8.0-maccatalyst 添加到 TargetFrameworks 时，Scanbot 包引用无法解析这些目标。 这不是配置问题——该软件包没有提供适用于 Windows 或 macOS 的程序集。 故障出现在桌面目标上的首次构建尝试期间，而不是NuGet安装时。

此限制意味着 Scanbot 在结构上与包含桌面平台的多目标 MAUI 项目不兼容，并且无论框架版本如何，它都不能用于任何非 MAUI 服务器或桌面项目类型。

IronBarcode方法

IronBarcode以单个NuGet包的形式分发，可在所有.NET项目类型和目标框架中正确解析：

// Same package, same API — works in ASP.NET Core, WPF, console, MAUI, Azure Functions
dotnet add package IronBarcode

// Same package, same API — works in ASP.NET Core, WPF, console, MAUI, Azure Functions
dotnet add package IronBarcode

对于也面向 Windows 或 macOS 桌面的 MAUI 应用程序， IronBarcode通过单个软件包引用支持所有四个 MAUI 目标，无需平台条件配置。 构建面向 iOS、Android 和 Windows 的 MAUI 项目的团队可以添加一次 IronBarcode，然后在所有三个平台上使用 BarcodeReader.Read()，而无需进行任何修改。

Scanbot SDK 方法

在面向 iOS 和 Android 的 MAUI 项目中，Scanbot 提供了一个嵌入在应用程序导航流程中的原生相机取景器。 BarcodeScanner.Open() 调用会显示全屏扫描器，当用户完成或关闭扫描时，结果会返回到调用页面。 这种集成使移动应用程序拥有专门的扫描用户界面，感觉就像是平台原生应用一样。

当项目规模扩大时，这种局限性就显现出来了。 在 MAUI 项目中添加 Windows 或 macOS 目标会导致这些平台上的构建失败。 添加需要条形码处理的服务器端组件需要单独的库。 Scanbot 依赖项无法跟随项目扩展到 iOS 和 Android 以外的平台。

IronBarcode方法

在 MAUI 项目中，IronBarcode 与该平台的 MediaPicker 配合使用，以捕获照片并从生成的图像中读取条形码。 扫描工作流程使用系统摄像头，而不是定制取景器：

// Works on iOS, Android, Windows, and macOS MAUI targets
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK");
}

// Works on iOS, Android, Windows, and macOS MAUI targets
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK");
}

Imports IronBarCode

Private Async Sub ScanButton_Clicked(sender As Object, e As EventArgs)
    Dim photo = Await MediaPicker.CapturePhotoAsync()
    If photo Is Nothing Then Return

    Using stream = Await photo.OpenReadAsync()
        Using ms As New MemoryStream()
            Await stream.CopyToAsync(ms)

            Dim results = BarcodeReader.Read(ms.ToArray())
            For Each result In results
                Await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK")
            Next
        End Using
    End Using
End Sub

这项交易是实时取景器叠加。 用户看到的是系统相机界面，而不是自定义扫描区域，这对于只需对准拍摄即可满足的商业应用来说已经足够了。 .NET MAUI条形码扫描器教程涵盖了iOS和Android目标的完整 MAUI 集成模式，包括权限处理和项目配置。

扫描机器人方法

Scanbot采用年度固定收费模式。 无论扫描量多少，年度许可费用都是固定的——无论是每年扫描 100 次还是每年扫描 1000 万次，费用都一样。 这为拥有稳定纯移动端部署的团队提供了可预测的年度预算。 确切价格需联系 Scanbot 销售团队； 暂无已公布的数据。 每年续期义务意味着许可证是一项持续的运营成本。

IronBarcode方法

IronBarcode采用一次性永久购买模式，分为四个级别： Lite749美元， Plus版1499美元， Professional2999美元，Unlimited版5999美元。购买版本无需每年续费即可继续使用。 许可期限内的软件更新包含在内。 Iron Software网站上公布了产品定价，无需销售人员进行洽谈。

服务器端和后端处理

使用 Scanbot 构建的移动应用程序通常会与处理文档上传、批量作业或 API 端点的服务器端组件一起存在。 当服务器端组件需要进行条形码处理时（例如从上传的 PDF 中提取条形码、验证传入文档中的条形码值或处理图像附件中的条形码数据），Scanbot 就无法使用了。 该软件包无法在ASP.NET Core、Azure Functions、控制台应用程序或任何非 MAUI 项目中编译。 在这种情况下，团队会发现自己既要维护移动条形码依赖项，又要维护单独的服务器端条形码解决方案，或者评估IronBarcode是否可以用一个软件包来满足这两个角色。

桌面应用程序要求

MAUI 的价值主张通常是跨平台覆盖：一个代码库即可覆盖 iOS、Android 和 Windows。 当 Windows MAUI 目标进入开发计划时（无论是最初的需求还是后来的添加），Scanbot 的软件包都无法在该目标上解析。 Windows 构建过程中，如果依赖项列表中包含 Scanbot，则无法继续进行。团队会在首次尝试构建桌面目标平台时发现此问题，解决方法是从共享依赖项列表中移除 Scanbot。对于必须使用 Windows 桌面目标平台的团队而言， IronBarcode成为唯一一款既支持移动端又支持桌面平台的条码库。

PDF和文档工作流程

从实时扫描向文档自动化发展的应用会遇到 Scanbot 的功能瓶颈。 从 PDF 发票中读取条形码、从扫描的货运标签图像中提取跟踪代码或处理存档文档中的条形码数据——这些工作流程在 Scanbot 模型中都不可能实现，因为输入必须始终是实时摄像头画面。 IronBarcode可以原生处理所有这些基于文件的输入。 MAUI 移动应用程序中使用的同一个软件包可以在后台处理作业中从 PDF 文档中提取条形码，而无需任何额外的依赖项。

可预测的许可成本

每年的续费费用需要在每个续费周期进行重新评估。 对于最初以小规模移动部署方式使用 Scanbot，后来扩展到拥有更多用户或平台的更广泛部署的团队来说，随着规模的扩大，他们可能会发现年费不再那么划算。IronBarcode的一次性永久授权模式免除了续费义务。 进行许可证续期评估的团队通常会考虑一次性购买是否更符合他们的长期成本规划，尤其是在扩展的项目范围包括 Scanbot 本身就不涵盖的服务器端或桌面平台时。

没有实时取景器等效物

Scanbot 的实时相机取景器（具有扫描区域叠加、连续检测和触觉反馈）在IronBarcode中没有直接的对应功能。 替换模式使用 MAUI 的 MediaPicker.CapturePhotoAsync() 打开系统相机，拍摄照片，并将图像返回以进行处理。 用户体验是照片拍摄流程，而不是连续扫描流程。 对于商业应用（库存、物流、文档处理），这种区别很少具有重要意义。 对于以实时叠加层为核心产品体验的消费者应用而言，这是一个真正的用户体验差异，在决定迁移之前应该对其进行评估。

事件回调模式直接返回

Scanbot 的 BarcodeScanner.Open() 是异步的，并返回一个 OperationResult，其中包含一个状态字段和一个 Barcodes 集合。IronBarcode的 BarcodeReader.Read() 直接返回一个集合——没有带有状态字段的包装对象。 成功检查从 result.Status == OperationResult.Ok 变为 results.Any() 或对 results.FirstOrDefault() 进行空值检查。

格式枚举命名空间更改

Scanbot 的 BarcodeFormat 枚举（例如，BarcodeFormat.Code128）和IronBarcode的 BarcodeEncoding 枚举（例如，BarcodeEncoding.Code128）包含类似的成员，但它们是不同命名空间中的不同类型。 按枚举类型存储或比较格式值的代码需要更新类型引用。 基于 .ToString() 输出的字符串比较通常是兼容的，因为成员名称相似，但显式枚举类型比较需要更新为 BarcodeEncoding 值。

Windows 构建附加组件

如果在迁移之前 Scanbot 软件包导致 Windows MAUI 构建失败，则将其删除即可解决这些失败。 添加IronBarcode后，请验证 MAUI 应用程序代码中是否正确处理了 Windows 特有的功能（文件选择对话框、本地文件路径、Windows 权限），因为这些功能与 iOS 和 Android 的文件访问模式不同。