如何构建.NET MAUI条形码扫描器 SDK 应用程序

创建 .NET MAUI 项目

打开 Visual Studio，创建一个新的 .NET MAUI App 项目。 将项目命名为类似"条形码扫描器"这样的描述性名称，并选择.NET 8 或更高版本作为目标框架。 Visual Studio 会生成默认项目结构，其中包含 Android 和 iOS 平台特定的文件夹。

如果您面向的是.NET 10，则相同的项目模板也适用。 更新 <TargetFrameworks> 属性，使其包含 .csproj 文件中的 net10.0-android、net10.0-ios 和 net10.0-windows10.0.19041.0 属性（根据需要）。 有关目标框架名称和最低操作系统版本要求的完整列表，请参阅.NET MAUI支持的平台文档。

安装 IronBarcode。

使用程序包管理器控制台安装IronBarcode NuGet程序包：

Install-Package BarCode

此命令下载并安装条形码扫描器 SDK 以及.NET MAUI应用程序所需的所有依赖项。

配置平台权限

即使扫描的是图像文件而不是实时摄像头画面，为.NET MAUI条形码扫描器应用程序配置以下权限也是很好的做法。

对于 Android 系统，请将以下内容添加到 Platforms/Android/AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

对于 iOS，请将以下条目添加到 Platforms/iOS/Info.plist:

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

初始化 SDK.

在应用程序生命周期的早期阶段设置许可证密钥，以确保在发出任何扫描调用之前IronBarcode已完全激活。 请将激活码放在 MauiProgram.cs:

using IronBarCode;

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

// Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

return builder.Build();

using IronBarCode;

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

// Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

return builder.Build();

Imports IronBarCode

Dim builder = MauiApp.CreateBuilder()
builder _
    .UseMauiApp(Of App)() _
    .ConfigureFonts(Sub(fonts)
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular")
    End Sub)

' Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"

Return builder.Build()

IronBarcode提供免费试用许可证，供开发和测试使用。 在启动时设置一次密钥；同一进程内对 BarcodeReader 和 BarcodeWriter 的所有后续调用均使用已激活的许可证。

如何从图像文件中读取条形码？

MAUI条码扫描器的核心功能是读取选定图像中的条码。 BarcodeReader.Read() 方法接受一个文件路径，并返回一个 BarcodeResult 对象集合，每个检测到的条形码对应一个对象。

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

using IronBarCode;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });

        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);

            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);

            ResultLabel.Text = barcodes.Any()
                ? $"Found: {barcodes.First().Value}"
                : "No barcodes detected in selected image.";
        }
    }
}

using IronBarCode;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });

        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);

            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);

            ResultLabel.Text = barcodes.Any()
                ? $"Found: {barcodes.First().Value}"
                : "No barcodes detected in selected image.";
        }
    }
}

Imports IronBarCode

Public Partial Class MainPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Async Sub OnSelectImageClicked(sender As Object, e As EventArgs)
        Dim result = Await FilePicker.PickAsync(New PickOptions With {
            .FileTypes = FilePickerFileType.Images,
            .PickerTitle = "Select a barcode image"
        })

        If result IsNot Nothing Then
            ' Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath)

            ' Read barcodes from the image file
            Dim barcodes = BarcodeReader.Read(result.FullPath)

            ResultLabel.Text = If(barcodes.Any(), $"Found: {barcodes.First().Value}", "No barcodes detected in selected image.")
        End If
    End Sub
End Class

using IronBarCode;

private async void OnSelectPdfClicked(object sender, EventArgs e)
{
    var result = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select a PDF with barcodes"
    });

    if (result != null)
    {
        // Read barcodes from every page of the PDF
        var barcodes = BarcodeReader.ReadPdf(result.FullPath);

        var output = string.Join("\n", barcodes.Select(b =>
            $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"));

        await DisplayAlert("Scan Results", output.Length > 0 ? output : "No barcodes found.", "OK");
    }
}

using IronBarCode;

private async void OnSelectPdfClicked(object sender, EventArgs e)
{
    var result = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select a PDF with barcodes"
    });

    if (result != null)
    {
        // Read barcodes from every page of the PDF
        var barcodes = BarcodeReader.ReadPdf(result.FullPath);

        var output = string.Join("\n", barcodes.Select(b =>
            $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"));

        await DisplayAlert("Scan Results", output.Length > 0 ? output : "No barcodes found.", "OK");
    }
}

Imports IronBarCode

Private Async Sub OnSelectPdfClicked(sender As Object, e As EventArgs)
    Dim result = Await FilePicker.PickAsync(New PickOptions With {
        .PickerTitle = "Select a PDF with barcodes"
    })

    If result IsNot Nothing Then
        ' Read barcodes from every page of the PDF
        Dim barcodes = BarcodeReader.ReadPdf(result.FullPath)

        Dim output = String.Join(vbLf, barcodes.Select(Function(b) $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"))

        Await DisplayAlert("Scan Results", If(output.Length > 0, output, "No barcodes found."), "OK")
    End If
End Sub

using IronBarCode;

// Configure the reader for multi-barcode detection with type filtering
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};

var barcodes = BarcodeReader.Read(imagePath, options);

foreach (var barcode in barcodes)
{
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}");
}

using IronBarCode;

// Configure the reader for multi-barcode detection with type filtering
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};

var barcodes = BarcodeReader.Read(imagePath, options);

foreach (var barcode in barcodes)
{
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}");
}

Imports IronBarCode

' Configure the reader for multi-barcode detection with type filtering
Dim options As New BarcodeReaderOptions With {
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128,
    .Speed = ReadingSpeed.Balanced
}

Dim barcodes = BarcodeReader.Read(imagePath, options)

For Each barcode In barcodes
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}")
Next

如何从内存流中读取条形码？

文件路径在大多数情况下都能很好地工作，但某些.NET MAUI工作流会通过内存传递图像数据——从相机预览捕获的帧、从 REST API 下载的字节或进程内生成的图像数据。 IronBarcode 支持在 BarcodeReader.Read() 重载中直接输入 System.IO.Stream：

using IronBarCode;
using System.IO;

// Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
private BarcodeResult[] ReadFromStream(Stream imageStream)
{
    return BarcodeReader.Read(imageStream);
}

// Example: download an image and scan without writing to disk
private async Task<string> ScanDownloadedBarcode(string imageUrl)
{
    using var httpClient = new HttpClient();
    using var stream = await httpClient.GetStreamAsync(imageUrl);
    using var memoryStream = new MemoryStream();

    await stream.CopyToAsync(memoryStream);
    memoryStream.Position = 0;

    var barcodes = BarcodeReader.Read(memoryStream);
    return barcodes.Any() ? barcodes.First().Value : string.Empty;
}

using IronBarCode;
using System.IO;

// Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
private BarcodeResult[] ReadFromStream(Stream imageStream)
{
    return BarcodeReader.Read(imageStream);
}

// Example: download an image and scan without writing to disk
private async Task<string> ScanDownloadedBarcode(string imageUrl)
{
    using var httpClient = new HttpClient();
    using var stream = await httpClient.GetStreamAsync(imageUrl);
    using var memoryStream = new MemoryStream();

    await stream.CopyToAsync(memoryStream);
    memoryStream.Position = 0;

    var barcodes = BarcodeReader.Read(memoryStream);
    return barcodes.Any() ? barcodes.First().Value : string.Empty;
}

Imports IronBarCode
Imports System.IO
Imports System.Net.Http
Imports System.Threading.Tasks

' Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
Private Function ReadFromStream(imageStream As Stream) As BarcodeResult()
    Return BarcodeReader.Read(imageStream)
End Function

' Example: download an image and scan without writing to disk
Private Async Function ScanDownloadedBarcode(imageUrl As String) As Task(Of String)
    Using httpClient As New HttpClient()
        Using stream As Stream = Await httpClient.GetStreamAsync(imageUrl)
            Using memoryStream As New MemoryStream()
                Await stream.CopyToAsync(memoryStream)
                memoryStream.Position = 0

                Dim barcodes = BarcodeReader.Read(memoryStream)
                Return If(barcodes.Any(), barcodes.First().Value, String.Empty)
            End Using
        End Using
    End Using
End Function

流重载接受任何 Stream 子类，包括 MemoryStream、FileStream 和网络流。 该库内部会处理格式检测，因此在调用之前无需指定图像类型。

如何在MAUI应用程序中生成条形码？

IronBarcode既能生成条形码，也能读取条形码。 BarcodeWriter 类生成条形码，作为图像文件、Bitmap 对象或 Stream 实例，您可以在 MAUI 视图中内联显示这些条形码。 这对于需要打印或共享条形码以及具备扫描功能的库存管理应用程序非常有用：

using IronBarCode;

// Generate a QR code and display it in a MAUI Image control
private async void OnGenerateQrClicked(object sender, EventArgs e)
{
    // Create a QR code barcode
    var qrCode = QRCodeWriter.CreateQrCode(
        value: "https://ironsoftware.com/csharp/barcode/",
        qrCodeSize: 500,
        errorCorrection: QRCodeWriter.QrErrorCorrectionLevel.Medium
    );

    // Save to a temporary file and display
    var tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png");
    qrCode.SaveAsPng(tempPath);

    GeneratedImageView.Source = ImageSource.FromFile(tempPath);
}

using IronBarCode;

// Generate a QR code and display it in a MAUI Image control
private async void OnGenerateQrClicked(object sender, EventArgs e)
{
    // Create a QR code barcode
    var qrCode = QRCodeWriter.CreateQrCode(
        value: "https://ironsoftware.com/csharp/barcode/",
        qrCodeSize: 500,
        errorCorrection: QRCodeWriter.QrErrorCorrectionLevel.Medium
    );

    // Save to a temporary file and display
    var tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png");
    qrCode.SaveAsPng(tempPath);

    GeneratedImageView.Source = ImageSource.FromFile(tempPath);
}

Imports IronBarCode

' Generate a QR code and display it in a MAUI Image control
Private Async Sub OnGenerateQrClicked(sender As Object, e As EventArgs)
    ' Create a QR code barcode
    Dim qrCode = QRCodeWriter.CreateQrCode(
        value:="https://ironsoftware.com/csharp/barcode/",
        qrCodeSize:=500,
        errorCorrection:=QRCodeWriter.QrErrorCorrectionLevel.Medium
    )

    ' Save to a temporary file and display
    Dim tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png")
    qrCode.SaveAsPng(tempPath)

    GeneratedImageView.Source = ImageSource.FromFile(tempPath)
End Sub

QRCodeWriter 类支持所有四个 QR 纠错级别（低、中、四分位数、高）、自定义尺寸和样式选项，包括前景色/背景色控制。 对于非 QR 码符号，请使用 BarcodeWriter.CreateBarcode() 和相应的 BarcodeEncoding 值。 条形码生成 API 参考文档记录了所有支持的输出格式。

该条码扫描器库的主要功能有哪些？

IronBarcode为.NET MAUI条码扫描项目提供了几个优势，使其区别于 ZXing .NET.MAUI 等开源替代方案：

在.NET MAUI项目中，"不依赖原生 SDK"这一点很重要，因为特定于平台的原生库需要为每个目标单独进行链接步骤。 IronBarcode完全避免了这种复杂性，这意味着同一个NuGet参考可以生成适用于所有三个受支持平台的可用二进制文件，而无需额外的配置。

有关支持的条形码格式的完整列表，请参阅IronBarcode支持的格式文档。 有关生产部署的定价和许可条款，请查看IronBarcode许可页面。

生产中条形码扫描的最佳实践是什么？

将条形码扫描器部署到生产环境中，除了基本的读取调用之外，还需要注意一些其他方面。 以下指南针对.NET MAUI条形码应用程序中最常见的故障点。

选择合适的读取速度。 ReadingSpeed.Balanced 可以正确处理大多数实际图像。 预留 ReadingSpeed.ExtraSlow 用于扫描用户无法重新捕获的打印文档或图像。 对于大批量工作流程，请避免使用 ReadingSpeed.ExtraSlow，因为每次扫描所需时间会大大延长。

按预期类型筛选。如果应用程序仅处理二维码，请设置 ExpectBarcodeTypes = BarcodeEncoding.QRCode。 限制搜索空间可以减少处理时间，并消除背景图形中存在的其他符号体系造成的误报。

仅在需要时使用 ExpectMultipleBarcodes。将其设置为 true 始终会导致读取器执行额外的扫描操作。 对于单个条形码输入，保留默认值（false），以便扫描在找到第一个有效代码后立即返回。

优雅地处理空结果。当未检测到条形码时，BarcodeReader.Read() 返回一个空数组，而不是抛出异常。 在访问 First() 之前，请检查 .Any()，并向用户显示明确的消息。 带有指导的重试提示（"确保条形码光线充足且居中"）比通用错误提示更能改善用户体验。

缓存选项对象。每次扫描都创建一个 BarcodeReaderOptions 实例会增加内存分配。 在类级别构建一次选项，并在多个调用中重复使用。

有关诊断扫描故障和优化性能的更多指导，请参阅IronBarcode故障排除指南和条形码阅读器教程。

下一步计划是什么？

使用 IronBarcode 构建 .NET MAUI 条形码扫描器需要安装一个 NuGet 包，配置平台权限，然后使用文件路径或流调用 BarcodeReader.Read()。 同一个 API 可以同时支持 Android、iOS 和 Windows 系统，没有针对特定平台的代码分支。

要进一步扩展应用程序的功能，请参考以下资源：

IronBarcode完整功能列表——所有扫描和生成功能的目录 条形码读取器 API 参考-- 完整的方法和属性文档 MAUI条形码阅读器分步教程——涵盖摄像头集成的详细讲解 MAUI 文档扫描仪指南——文档扫描用例

立即开始免费试用，获取开发许可证密钥，或了解生产部署的许可选项。