CameraBarcodeReaderView架构

CameraBarcodeReaderView控件是ZXing.Net.MAUI的核心组件。 它在XAML中声明，并通过BarcodeReaderOptions绑定进行配置。 每个使用它的页面必须实现IsDetecting状态：

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <zxing:CameraBarcodeReaderView
        x:Name="CameraView"
        Options="{Binding ReaderOptions}"
        BarcodesDetected="OnBarcodesDetected" />
</ContentPage>

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <zxing:CameraBarcodeReaderView
        x:Name="CameraView"
        Options="{Binding ReaderOptions}"
        BarcodesDetected="OnBarcodesDetected" />
</ContentPage>

// Toggling IsDetecting in lifecycle overrides is the documented pattern
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  // 否 IDisposable on the control
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

// Toggling IsDetecting in lifecycle overrides is the documented pattern
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  // 否 IDisposable on the control
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

' Toggling IsDetecting in lifecycle overrides is the documented pattern
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = False ' 否 IDisposable on the control
    End If
End Sub

Protected Overrides Sub OnAppearing()
    MyBase.OnAppearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = True
    End If
End Sub

ZXing .NET.MAUI 应用程序中的每个扫描页面都包含此生命周期样板代码。 缺少Dispose模式。

详细功能对比

ZXing .NET.MAUI 方法

ZXing.Net.MAUI围绕iOS和Android的平台相机API设计。 Windows MAUI仅支持条形码生成——相机扫描未实现且不在公开路线图上。这反映了围绕实时相机取景器控件构建库的结构选择，其平台实现仅为移动操作系统编写。

目标是net8.0-windows10.0.19041.0的MAUI项目将不会从ZXing.Net.MAUI得到条码扫描功能。 Mac Catalyst存在于目标框架列表中，但尚未正式记录在该目标上的扫描。 开始仅针对移动目标项目且随后添加Windows或macOS需求的团队会发现在这些目标上ZXing.Net.MAUI无法覆盖扫描。 iOS支持本身带有警告：GitHub问题 #260 记录了iPhone 15 Pro和Pro Max设备遇到了自动对焦问题，导致无法可靠检测。

IronBarcode方法

IronBarcode支持所有 MAUI 目标框架——iOS、Android、Windows 和 macOS——使用同一个软件包和相同的代码模式。 MediaPicker + MediaPicker.CapturePhotoAsync()调用设备相机； 在 Windows 系统中，它会映射到文件选择器，这对于桌面环境来说是合适的行为。 无需平台特定代码、无需条件编译、也无需平台服务注册。

适用于 Windows 和 macOS 的 MAUI 桌面条形码模式与处理移动扫描的软件包相同。 在安卓设备上运行的相同BarcodeReader.Read()调用也在ASP.NET Core端点、WinForms桌面应用程序或Azure Function中运行——部署目标不影响API。

ZXing .NET.MAUI 方法

CameraBarcodeReaderView是嵌入在XAML页面中的持久相机控件。 当false时停止。 缺少IDisposable模式释放。 记录的缓解措施是在OnAppearing()中恢复它：

// ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    CameraView.IsDetecting = true;
}

// ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    CameraView.IsDetecting = true;
}

' ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    CameraView.IsDetecting = False
End Sub

Protected Overrides Sub OnAppearing()
    MyBase.OnAppearing()
    CameraView.IsDetecting = True
End Sub

在所有放置扫描仪的页面上，都必须重复此模式。 经常导航到和从扫描页面返回的应用程序可能会累积未完全释放的相机资源，这记录在GitHub问题 #164中，伴随内存增长和返回时相机初始化间歇性的问题报告。 iPhone 15 Pro自动对焦问题（GitHub问题#260）是相机集成层中的一个独立问题：相机视图清晰地渲染条码，但自动对焦系统未能足够清晰地锁定以便在iPhone16,2硬件上进行检测。 记录的解决方法是指示用户手动调整设备和条形码之间的距离。

IronBarcode方法

IronBarcode没有在 XAML 布局中嵌入相机控件。 相反，当用户点击按钮时，MediaPicker.CapturePhotoAsync()调用打开系统相机用户界面。 系统摄像头可独立处理对焦、曝光和自动对焦。 当用户确认捕获时，结果图像将以字节数组形式传递给BarcodeReader.Read()：

// 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 barcode in results)
        Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

// 否 OnAppearing or OnDisappearing needed — no camera state to manage

// 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 barcode in results)
        Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

// 否 OnAppearing or OnDisappearing needed — no camera state to manage

Imports IronBarCode
Imports System.IO
Imports System.Threading.Tasks

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 barcode In results
                Console.WriteLine($"{barcode.Format}: {barcode.Value}")
            Next
        End Using
    End Using
End Sub

' 否 OnAppearing or OnDisappearing needed — no camera state to manage

.NET MAUI条形码扫描器教程涵盖了此模式的完整项目设置，包括 iOS 和 Android 的权限配置。 因为没有持久的相机视图，所以无需释放资源，无需切换状态，也无需跨页面维护生命周期样板代码。

ZXing .NET.MAUI 方法

ZXing .NET.MAUI 继承了 ZXing .NET格式规范要求。 在扫描开始之前，开发者必须用BarcodeReaderOptions.Formats，以检测应检测的类型。 未包含在列表中的格式将不会被检测到——不会发出任何错误或警告，也不会显示任何提示信息：

// ZXing.Net.MAUI: formats must be declared explicitly
// Formats not listed here are not detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

// ZXing.Net.MAUI: formats must be declared explicitly
// Formats not listed here are not detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

' ZXing.Net.MAUI: formats must be declared explicitly
' Formats not listed here are not detected
ReaderOptions = New BarcodeReaderOptions With {
    .Formats = BarcodeFormats.QRCode Or
               BarcodeFormats.Code128 Or
               BarcodeFormats.Ean13 Or
               BarcodeFormats.UpcA,
    .TryHarder = True,
    .AutoRotate = True
}

如果用户将相机对准GS1 DataBar、Aztec码、MaxiCode或任何未在选项中声明的格式，扫描将不返回结果且不会引发错误。 相机渲染出条形码，应用程序未返回结果。 在受控环境中——例如仓库中每件商品都贴有 Code128 标签——这是可以管理的。 在条形码格式由外部供应商、客户或第三方系统决定的部署中，缺乏回退路径成为一个经常性的支持问题。

IronBarcode方法

IronBarcode无需任何预配置，即可自动检测所有支持的格式。 BarcodeReader.Read()分析图像并返回其识别到的每个条码的结果，无论格式如何。 不需要BarcodeReaderOptions列表：

// IronBarcode: no format specification needed
// All 50+ formats detected automatically
var results = BarcodeReader.Read(imageBytes);
foreach (var barcode in results)
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");

// IronBarcode: no format specification needed
// All 50+ formats detected automatically
var results = BarcodeReader.Read(imageBytes);
foreach (var barcode in results)
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");

Imports IronBarcode

' IronBarcode: no format specification needed
' All 50+ formats detected automatically
Dim results = BarcodeReader.Read(imageBytes)
For Each barcode In results
    Console.WriteLine($"{barcode.Format}: {barcode.Value}")
Next

如果需要针对只预期一种格式的受控场景进行性能调优，则可以选择性地传递格式提示——但它们对于正确检测来说并非必需。 即使条形码的格式并非开发者预期，系统仍能检测到并返回该条形码。

ZXing .NET.MAUI 方法

ZXing .NET.MAUI 是一个相机控制库。 它没有从文件路径、直接从存储传递的字节数组或 PDF 文档读取条形码的 API。 CameraBarcodeReaderView控件需要实时相机源； 没有静态方法可以接受文件路径并返回条形码结果。 需要从上传的 PDF、文档管理系统或批量图像处理队列中读取条形码的团队无法在这些场景中使用 ZXing .NET.MAUI，必须引入单独的库。

IronBarcode方法

IronBarcode通过相同的BarcodeReader.Read()方法读取任何来源的条码。 它接受文件路径、字节数组、流和 PDF 文档。 PDF解析是原生支持的IronBarcode直接处理PDF页面，无需中间光栅化步骤：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read barcodes from a PDF file
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
var file = await FilePicker.PickAsync();
if (file != null)
{
    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read barcodes from a PDF file
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
var file = await FilePicker.PickAsync();
if (file != null)
{
    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

Imports IronBarCode
Imports Microsoft.Maui.Storage

' Read barcodes from a PDF file
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

' Read from a user-selected file using MAUI FilePicker
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim fileResults = BarcodeReader.Read(file.FullPath)
    For Each result In fileResults
        ResultLabel.Text &= $"\n{result.Format}: {result.Value}"
    Next
End If

完整的 PDF 条形码读取工作流程，包括多页文档和跨页混合条形码格式，已记录在《从 PDF 读取条形码指南》中。 这涵盖了 ZXing .NET.MAUI 仅使用摄像头的架构无法处理的运输发票、电子票据、文档管理工作流程和批量处理场景。

Windows MAUI要求

最常见的重新评估触发因素是，在最初只有 iOS 和 Android 目标的项目中添加了Windows MAUI目标。 MAUI 团队通常从移动优先的构建开始，随着需求的演变再扩展到桌面目标。 当这种扩展发生时，ZXing .NET.MAUI 没有提供任何后续方案——Windows 平台尚未实现，也没有列入公开的开发路线图。团队要么必须接受条形码扫描功能在 Windows 上无法使用，要么就得替换掉这个库。 由于更换过程涉及扫描模式的结构性改变，团队通常会同时对所有平台进行更改。

当前一代硬件兼容性

iPhone 15 Pro自动对焦问题（GitHub问题 #260）对于向iOS用户提供生产条形码扫描仪的团队是真实的考虑因素。 iPhone 15 Pro和Pro Max在期望应用体验精致的消费者群体中很常见，请求用户调整与条形码的距离的解决方法与旧款iPhone硬件相比是显著的用户体验倒退。 在QA中浮现这一问题的团队，或接到iPhone 15 Pro用户的支持报告，面临着继续使用在当前尚无解决方案的库或迁移到不受相机视图对焦模型影响的方法之间的选择。

文件和文档处理

条形码扫描需求很少会局限于实时摄像头拍摄。 最初作为库存扫描器的应用，通常会扩展到读取上传的 PDF 中的条形码、处理发货发票或处理电子邮件附件中的电子票据。 ZXing .NET.MAUI 没有针对这些场景的 API。 当产品需求进入待办事项列表，涉及从文件或文档中读取条形码时，使用 ZXing .NET.MAUI 的团队必须引入一个单独的库来处理它。 如果团队已经在使用IronBarcode处理任何基于文件的场景，那么将 MAUI 相机扫描整合到同一个库中就成了顺理成章的下一步。

生产稳定性要求

v0.7.4的1.0之前标识——尽管包本身是稳定的NuGet发布——对于受到软件组成分析、依赖性审计或内部批准流程的团队有影响。 某些企业环境要求生产依赖具有1.0+稳定发布、商业支持合同或两者兼备。 ZXing.Net.MAUI由社区维护并且处于1.0之前，这适用于内部工具和原型，但在以条形码扫描仪作为主要工作流的面向客户的应用中增加了审查步骤。 缺乏付费支持层意味着任何关键错误均取决于社区维护者的可用性。

CameraBarcodeReaderView 到 MediaPicker 模式

CameraBarcodeReaderView XAML控件及其xmlns:zxing命名空间声明完全移除。 在每个包含扫描器视图的XAML文件中，替换为在其Button控件。 通过BarcodeReader.Read()返回值所取代。

正在检测生命周期移除

所有唯一存在用于切换OnDisappearing覆盖都可以删除。 如果这些覆盖包含其他页面生命周期逻辑，IsDetecting行将被移除，而剩余逻辑将被保留。 没有IronBarcode相当于IsDetecting的替代，因为没有持久的相机状态需要在页面导航之间进行管理。

使用条形码读取器() 注册移除

ZXing.Net.MAUI需要在builder.UseBarcodeReader()调用，以注册其平台相机服务。 IronBarcode不需要任何MauiProgram.cs注册。 using ZXing.Net.Maui;命名空间导入被连同包卸载一起移除。