MAUI 条码扫描器与IronBarcode的分步指南

构建 MAUI 条形码扫描器需要哪些先决条件？

开始之前，请确保您的开发环境已准备就绪：

• 已安装.NET MAUI工作负载的Visual Studio 2022 （版本 17.8 或更高版本）。
• .NET 10 SDK -- 从.NET官方网站下载 -具备基本的 C# 知识——熟悉 async/await 模式会有帮助
• 用于相机测试的物理设备或模拟器 IronBarcode许可证——提供免费试用版供评估

在创建项目之前确保 Visual Studio 已安装 MAUI 工作负载，可以节省后续大量的故障排除时间。 您可以在 Visual Studio 安装程序的"单个组件"下搜索".NET多平台应用程序 UI 开发"来验证这一点。

如何设置 MAUI 条形码扫描项目？

首先在 Visual Studio 2022 中创建一个新的.NET MAUI应用程序项目。将其命名为 BarcodeScannerApp，并选择.NET 10 作为目标框架。 Visual Studio 会生成标准的 MAUI 项目结构，其中包含 Android、iOS、macOS 和 Windows 等平台特定的文件夹。

Install-Package BarCode

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

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

如何配置安卓和iOS系统的相机权限？

特定平台的相机权限对于条码扫描功能至关重要。 每个平台都需要在其清单文件中进行特定配置，然后 MediaPicker.CapturePhotoAsync() 才能成功。

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to scan barcodes</string>

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to scan barcodes</string>

如何创建条形码扫描器界面？

在 MainPage.xaml 中设计一个用户界面，使用户在扫描过程中获得清晰的反馈。 简洁而实用的布局包括图像预览、结果显示区域和扫描触发按钮：

<?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="BarcodeScannerApp.MainPage"
             Title="Barcode Scanner">
    <VerticalStackLayout Padding="20" Spacing="20">
        <Label Text="Point the camera at a barcode"
               FontSize="16"
               HorizontalOptions="Center"
               TextColor="#555555" />
        <Image x:Name="CapturedImage"
               HeightRequest="300"
               Aspect="AspectFit"
               BackgroundColor="#F0F0F0" />
        <Label x:Name="ResultLabel"
               Text="Tap Scan to begin"
               FontSize="18"
               HorizontalOptions="Center"
               FontAttributes="Bold" />
        <Label x:Name="FormatLabel"
               Text=""
               FontSize="13"
               HorizontalOptions="Center"
               TextColor="#888888" />
        <Button Text="Scan Barcode"
                Clicked="OnScanClicked"
                BackgroundColor="#007ACC"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
        <Button Text="Load from Gallery"
                Clicked="OnPickFromGalleryClicked"
                BackgroundColor="#5C5C5C"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
    </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="BarcodeScannerApp.MainPage"
             Title="Barcode Scanner">
    <VerticalStackLayout Padding="20" Spacing="20">
        <Label Text="Point the camera at a barcode"
               FontSize="16"
               HorizontalOptions="Center"
               TextColor="#555555" />
        <Image x:Name="CapturedImage"
               HeightRequest="300"
               Aspect="AspectFit"
               BackgroundColor="#F0F0F0" />
        <Label x:Name="ResultLabel"
               Text="Tap Scan to begin"
               FontSize="18"
               HorizontalOptions="Center"
               FontAttributes="Bold" />
        <Label x:Name="FormatLabel"
               Text=""
               FontSize="13"
               HorizontalOptions="Center"
               TextColor="#888888" />
        <Button Text="Scan Barcode"
                Clicked="OnScanClicked"
                BackgroundColor="#007ACC"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
        <Button Text="Load from Gallery"
                Clicked="OnPickFromGalleryClicked"
                BackgroundColor="#5C5C5C"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
    </VerticalStackLayout>
</ContentPage>

该布局提供了两种扫描路径：使用相机拍摄新照片和从图库中选择现有图像。 对于用户预先拍摄条形码或通过电子邮件接收图像的工作流程来说，这一点很重要。 FormatLabel 显示检测到的条形码格式以及解码值，这有助于调试和用户验证。

如何实现条形码阅读器功能？

在 MainPage.xaml.cs 中实现核心扫描逻辑。 以下代码同时处理相机拍摄和图库选择，并具有适当的异步模式和错误处理：

using IronBarCode;
using IronSoftware.Drawing;

namespace BarcodeScannerApp;

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

    private async void OnScanClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.CapturePhotoAsync());
    }

    private async void OnPickFromGalleryClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.PickPhotoAsync());
    }

    private async Task ScanFromSource(Func<Task<FileResult?>> sourceFunc)
    {
        try
        {
            var photo = await sourceFunc();
            if (photo is null) return;

            using var stream = await photo.OpenReadAsync();
            using var memoryStream = new MemoryStream();
            await stream.CopyToAsync(memoryStream);
            var imageBytes = memoryStream.ToArray();

            // Show the captured image in the UI
            CapturedImage.Source = ImageSource.FromStream(() =>
                new MemoryStream(imageBytes));

            // Process with IronBarcode
            var bitmap = AnyBitmap.FromBytes(imageBytes);
            var options = new BarcodeReaderOptions
            {
                Speed = ReadingSpeed.Balanced,
                ExpectMultipleBarcodes = false
            };

            var results = await BarcodeReader.ReadAsync(bitmap, options);

            if (results.Any())
            {
                var first = results.First();
                ResultLabel.Text = $"Value: {first.Value}";
                FormatLabel.Text = $"Format: {first.BarcodeType}";
            }
            else
            {
                ResultLabel.Text = "No barcode detected";
                FormatLabel.Text = string.Empty;
            }
        }
        catch (FeatureNotSupportedException)
        {
            await DisplayAlert("Unsupported",
                "Camera is not available on this device.", "OK");
        }
        catch (PermissionException)
        {
            await DisplayAlert("Permission Required",
                "Please grant camera permission in Settings.", "OK");
        }
        catch (Exception ex)
        {
            await DisplayAlert("Error",
                $"Scanning failed: {ex.Message}", "OK");
        }
    }
}

using IronBarCode;
using IronSoftware.Drawing;

namespace BarcodeScannerApp;

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

    private async void OnScanClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.CapturePhotoAsync());
    }

    private async void OnPickFromGalleryClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.PickPhotoAsync());
    }

    private async Task ScanFromSource(Func<Task<FileResult?>> sourceFunc)
    {
        try
        {
            var photo = await sourceFunc();
            if (photo is null) return;

            using var stream = await photo.OpenReadAsync();
            using var memoryStream = new MemoryStream();
            await stream.CopyToAsync(memoryStream);
            var imageBytes = memoryStream.ToArray();

            // Show the captured image in the UI
            CapturedImage.Source = ImageSource.FromStream(() =>
                new MemoryStream(imageBytes));

            // Process with IronBarcode
            var bitmap = AnyBitmap.FromBytes(imageBytes);
            var options = new BarcodeReaderOptions
            {
                Speed = ReadingSpeed.Balanced,
                ExpectMultipleBarcodes = false
            };

            var results = await BarcodeReader.ReadAsync(bitmap, options);

            if (results.Any())
            {
                var first = results.First();
                ResultLabel.Text = $"Value: {first.Value}";
                FormatLabel.Text = $"Format: {first.BarcodeType}";
            }
            else
            {
                ResultLabel.Text = "No barcode detected";
                FormatLabel.Text = string.Empty;
            }
        }
        catch (FeatureNotSupportedException)
        {
            await DisplayAlert("Unsupported",
                "Camera is not available on this device.", "OK");
        }
        catch (PermissionException)
        {
            await DisplayAlert("Permission Required",
                "Please grant camera permission in Settings.", "OK");
        }
        catch (Exception ex)
        {
            await DisplayAlert("Error",
                $"Scanning failed: {ex.Message}", "OK");
        }
    }
}

此实现使用共享的 ScanFromSource 辅助方法，以避免在相机和图库路径之间重复图像处理逻辑。 AnyBitmap.FromBytes 方法可自动处理 JPEG、PNG、WebP 和其他常见图像格式——无需手动检测格式。

结果对象公开了 first.BarcodeType(格式枚举)和 first.BarcodeImage(检测到的条形码区域的裁剪图像)等属性。 请参阅BarcodeResult 类文档以获取完整列表。

如何配置高级扫描选项？

IronBarcode公开了一个 BarcodeReaderOptions 对象，您可以根据具体用例微调检测行为。 了解这些选项有助于您根据应用程序的需求，在速度和准确性之间取得平衡。

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = await BarcodeReader.ReadAsync(bitmap, options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = await BarcodeReader.ReadAsync(bitmap, options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f)
    }
};

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f)
    }
};

您如何处理常见的故障排除场景？

即使使用配置良好的 MAUI 条形码扫描器，也可能出现因设备特定行为、图像质量问题或平台限制而导致的问题。

下一步计划是什么？

现在您已经拥有一个可正常运行的 MAUI 条形码扫描器和IronBarcode，根据您的应用程序需求，有几种方法可供选择：

-生成条形码-- IronBarcode包含一个 条形码生成 API ，可根据字符串数据创建二维码、Code 128 标签和其他格式的条形码。 -批量扫描-- 使用 BarcodeReader.ReadAsync 和 ExpectMultipleBarcodes = true 在循环中处理多个图像文件； 请参阅批量扫描示例

• PDF 条形码提取-- IronBarcode可以使用相同的 BarcodeReader 类读取嵌入在 PDF 文档中的条形码； 查阅PDF 条形码读取文档 -样式和品牌——使用颜色、徽标和注释自定义生成的条形码的视觉输出； 查看条形码样式选项 -其他 IronSoftware 产品——如果您的 MAUI 应用还需要 PDF 生成、OCR 或电子表格支持，请探索完整的Iron Suite套件，以获得一致的跨平台功能。

首先申请免费试用许可证，在评估期内可以不受限制地进行部署。 有关生产许可选项和批量定价，请访问IronBarcode定价页面。 IronBarcode文档门户和IronBarcode GitHub存储库提供了更多代码示例和社区支持。