BarcodeScanning.MAUI 与 IronBarcode：C# 条码库比较

实时摄像头扫描模式

整个 BarcodeScanning.Native.Maui API 模式是一个 XAML 控件和一个 C# 事件处理程序配对使用：

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

该控件为用户提供了一个嵌入在 MAUI 页面中的实时取景器。 当摄像头画面处于活动状态时，条形码检测会持续触发。对于以"指向扫描"为主要交互方式的消费级应用来说，这种用户体验确实非常出色。 限制在于，这是该库唯一支持的交互方式——一旦需求超出 iOS 或 Android 上的实时摄像头检测范围，BarcodeScanning.Native.Maui 就无法提供任何功能。

详细功能对比

条形码扫描.MAUI 方法

BarcodeScanning.Native.Maui 封装了每个平台上的原生摄像头检测流程。 在 Android 系统上，ML Kit 处理帧。 在 iOS 系统中，苹果的 Vision 框架负责处理帧。 该库将其显示为 MAUI CameraView 控件，并带有 OnDetectionFinished 事件。 应用程序代码从不直接处理图像字节——它只处理从事件中检测到的条形码值。

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

这种设计的后果是，没有其他入口。 摄像头并非可选项——它是库唯一识别的输入设备。 服务器、文件、PDF、Windows 机器——这些都没有该库所期望的那种摄像头。

IronBarcode方法

IronBarcode 通过其静态方法接收图像数据。 调用者提供数据（来自任何来源），库对其进行解码。 在 MAUI 上，数据来自 MediaPicker； 在服务器上，它来自表单上传； 在桌面应用程序中，它来自文件对话框。

//IronBarcodein MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_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)
        ResultLabel.Text = result.Value;
}

//IronBarcodein MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_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)
        ResultLabel.Text = result.Value;
}

Imports IronBarCode
Imports System.IO

'IronBarcode in MAUI: capture a photo, then read barcodes from it
' NuGet: dotnet add package IronBarcode

Private Async Sub ScanBarcodeButton_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
                ResultLabel.Text = result.Value
            Next
        End Using
    End Using
End Sub

这段代码在 iOS、Android 和 Windows MAUI 上运行效果完全相同。 对于服务器端使用，相同的 BarcodeReader.Read() 方法接受上传文件的字节数组或 PDF 路径。 IronBarcode 的文档涵盖了所有支持的输入类型。

条形码扫描.MAUI 方法

BarcodeScanning.Native.Maui 不支持 MAUI 中的 Windows 目标平台。 这不是暂时的缺口，而是图书馆建筑结构造成的必然结果。 该库封装了 iOS 特有的（Vision 框架）和 Android 特有的（ML Kit）原生 API。Windows 系统本身不具备这两种 API。 构建面向 iOS、Android 和 Windows 的 MAUI 应用程序的团队（这是标准的多目标场景）不能使用 BarcodeScanning.Native.Maui 作为所有三个目标的条形码解决方案。 他们要么必须单独为 Windows 平台编写特定代码，要么必须完全替换该库。

IronBarcode方法

IronBarcode 的 BarcodeReader.Read() 调用可在 Windows、iOS、Android 和 macOS MAUI 目标上运行，无需任何平台特定的代码。 没有 #if WINDOWS 代码块，没有条件依赖加载，也不需要存根实现。 对于文件和 PDF 输入，模式也保持一致：

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

Imports IronBarCode

' Read barcodes from a file the user selected
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim results = BarcodeReader.Read(file.FullPath)
    For Each result In results
        Console.WriteLine($"{result.Format}: {result.Value}")
    Next
End If

' Read barcodes directly from a PDF — no image extraction step needed
Dim pdfResults = BarcodeReader.Read("shipment-manifest.pdf")

IronBarcode MAUI 集成指南提供了所有 MAUI 目标的完整设置说明。 IronBarcode还支持在ASP.NET、Docker、Azure Functions 和 AWS Lambda 环境中进行服务器端部署，而 BarcodeScanning.Native.Maui 在这些环境中根本没有路径。

条形码扫描.MAUI 方法

在 iOS 上，BarcodeScanning.Native.Maui 的底层检测（Apple Vision）会为 UPC-A 条形码返回 13 位数字。 UPC-A 是一种 12 位数字格式； 多出的开头零符合 EAN-13 编码。 库会直接传递这个原始值，而不进行任何校正。 将 UPC-A 值存储在数据库中的应用程序可能会累积带有不应该存在的开头零的记录。

已记录的解决方法是检查格式并裁剪值：

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

' Workaround required for iOS UPC-A — strip the leading zero manually
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormat.UPC_A AndAlso value.Length = 13 Then
        value = value.Substring(1) ' strip Apple's prepended leading zero
    End If

    ProcessBarcode(value)
End Sub

如果省略格式检查，这种变通方法会悄无声息地破坏以 0 开头的 EAN-13 条形码。 PDF417 在GitHub issues 中被单独记录为"非常有问题——大多数扫描都不会发生"，影响货运标签、驾驶执照和登机牌。

IronBarcode方法

IronBarcode无需手动规范化即可返回正确的 12 位 UPC-A 值。 PDF417 是一种受支持的格式，可以可靠地读取。 生成端也可以通过IronBarcode的 API 获取：

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

' Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

对于条形码数据准确性直接影响库存查找、销售点交易或供应链集成的应用而言，IronBarcode 的正确格式处理消除了 BarcodeScanning.Native.Maui 在应用程序代码中留下的一类生产错误。 IronBarcode条形码读取文档详细介绍了特定格式的行为。

已将 Windows MAUI 目标添加到构建中

MAUI 应用通常以 iOS 和 Android 为目标平台，随着应用的成熟或Enterprise分发需求的扩展，再逐步添加 Windows 版本。 添加 Windows 目标后，BarcodeScanning.Native.Maui 会立即成为一个阻碍因素——库中没有 Windows 实现，也没有解决方法。 在这种情况下，团队要么必须使用不同的库为 Windows 维护单独的条形码实现，要么必须将整个条形码层迁移到一个可以在所有 MAUI 目标上一致工作的库。 第二条路径操作起来更简单，并且消除了平台特定分支的维护开销。

新增文件上传或PDF处理要求

移动应用程序通常最初以实时摄像头扫描作为唯一的输入方式，之后才扩展到接受上传的图像或文档。 当用户需要扫描图库中的照片、通过电子邮件收到的图像或包含货运清单或登机牌的 PDF 中的条形码时，BarcodeScanning.Native.Maui 没有可提供的代码路径。 达到此需求阈值的团队面临一个选择：要么在 BarcodeScanning.Native.Maui 之外再添加一个条形码库来处理文件和 PDF 输入，要么迁移到一个能够处理所有输入类型的单一库。管理两个具有不同 API、不同结果类型和不同格式支持表的条形码包会增加长期的复杂性，而单一包解决方案则可以避免这一点。

服务器端条形码处理技术推出

在移动设备上扫描条形码的应用程序通常会开发一个服务器端组件——一个用于验证条形码的ASP.NET API 端点、一个用于处理 PDF 的后台作业，或者一个用于从上传的文档中提取跟踪号码的云函数。 BarcodeScanning.Native.Maui 是一个依赖于相机硬件上下文的 UI 控件库； 它无法在服务器进程中运行。 如果团队需要在移动端和服务器端使用相同的条形码读取逻辑，则服务器端必须使用不同的库。当出现服务器端需求时，团队通常会评估是使用一个同时涵盖移动端和服务器端的单一库，还是维护两个独立的实现更可取。

UPC-A 数据准确性成为生产问题

iOS UPC-A 13 位数字的行为并非总能在开发过程中被发现。 在开发过程中扫描的 UPC-A 条形码可能看起来工作正常，但 Apple 的 Vision 框架引入的前导零会出现在数据库中。 在库存记录、销售点系统或供应链集成中发现 13 位 UPC-A 值的团队，除了面临代码问题外，还面临着数据更正问题。 BarcodeScanning.Native.Maui 的GitHub问题中记录的解决方法可以纠正新的扫描结果，但无法修复历史数据。 当数据质量问题的范围变得明确时，迁移到无需应用级规范化即可返回正确 UPC-A 值的库通常是更清晰的长期解决方案。

PDF417 文档扫描要求

PDF417 是北美地区用于货运标签、驾驶执照和登机牌的条形码格式。 这些是物流、身份验证和旅游应用中常见的扫描目标。 BarcodeScanning.Native.Maui 的GitHub问题跟踪器将 PDF417 描述为"问题重重——大多数扫描都无法成功"。对于任何将 PDF417 的可靠性视为功能性要求而非锦上添花的应用来说，这个已知问题会直接阻碍应用的运行，迫使开发者评估其他替代库。

相机事件到媒体选择器和静态读取

迁移的核心结构变化是用 MediaPicker 捕获后紧接着 BarcodeReader.Read() 捕获来取代连续的相机事件模式。 事件处理程序、XAML 控件和 XML 命名空间声明均已移除。 取而代之的是，一个按钮触发 MediaPicker.CapturePhotoAsync()，并将产生的照片字节传递给 BarcodeReader.Read()。 这会将用户体验从实时连续取景器变为系统相机屏幕——适用于大多数商业应用。

线程编组变更

BarcodeScanning.Native.Maui 在后台线程中触发 OnDetectionFinished，因此所有更新 UI 元素的现有处理程序都会将其更新包装在 MainThread.BeginInvokeOnMainThread() 中。IronBarcode使用的 MediaPicker + async 模式，在 await 之后的延续会在调用上下文中返回，这通常是主线程。 大多数情况下，可以删除 MainThread.BeginInvokeOnMainThread() 包装器，从而简化事件处理程序代码。

UPC-A 规避移除

任何处理 BarcodeScanning.Native.Maui 的 iOS UPC-A 13 位行为的代码库都会有代码检查 BarcodeFormat.UPC_A 并调用 Substring(1) 来去除前导零。 迁移后必须删除此代码 — IronBarcode返回正确的 12 位值，保留此变通方法会错误地从有效的 UPC-A 读取中去除第一位数字。

MAUI权限

BarcodeScanning.Native.Maui 在其软件包设置过程中会自动向 Android 和 iOS 清单添加相机权限。当IronBarcode使用 MediaPicker 时，需要 AndroidManifest.xml 和 Info.plist 中的标准 MAUI 相机权限——这与任何 MAUI 应用使用 MediaPicker.CapturePhotoAsync() 所需的权限相同。 在任何使用摄像头的 MAUI 项目中，这些权限通常都已经存在。