【亲测免费】 ZXing.Net.Maui 安装和配置指南

2026-01-20 01:40:23作者：羿妍玫Ivan

1. 项目基础介绍和主要的编程语言

项目基础介绍

ZXing.Net.Maui 是 ZXing.Net.Mobile 的继任者，专为 .NET MAUI 应用程序设计的条码扫描和生成库。它允许开发者在 .NET MAUI 应用中轻松实现条码扫描和生成功能。

主要的编程语言

该项目主要使用 C# 编程语言。

2. 项目使用的关键技术和框架

关键技术和框架

.NET MAUI: 多平台应用开发框架，支持 Android、iOS、macOS 和 Windows。
ZXing.Net: 一个开源的条码处理库，支持多种条码格式。
XAML: 用于定义用户界面的标记语言。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

安装 .NET SDK: 确保你已经安装了最新版本的 .NET SDK。
安装 Visual Studio 或 Visual Studio Code: 推荐使用 Visual Studio 2022 或 Visual Studio Code 进行开发。
创建 .NET MAUI 项目: 如果你还没有 .NET MAUI 项目，可以使用以下命令创建一个新项目：
```
dotnet new maui -n MyMauiApp
cd MyMauiApp
```

详细的安装步骤

步骤 1: 安装 ZXing.Net.Maui.Controls NuGet 包

在 Visual Studio 中，右键点击你的项目，选择“管理 NuGet 包”，然后搜索并安装 ZXing.Net.Maui.Controls 包。

或者，你可以在命令行中使用以下命令安装：

dotnet add package ZXing.Net.Maui.Controls

步骤 2: 初始化插件

在你的 MauiProgram.cs 文件中，添加以下代码来初始化 ZXing.Net.Maui 插件：

using ZXing.Net.Maui;

public static MauiApp Create()
{
    var builder = MauiApp.CreateBuilder();
    builder.UseMauiApp<App>()
           .UseBarcodeReader(); // 确保添加这一行
    return builder.Build();
}

步骤 3: 添加平台权限

根据你的目标平台，添加相应的权限。

Android

在你的 AndroidManifest.xml 文件中（位于 Platforms\Android 文件夹下），添加以下权限：

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

iOS

在你的 info.plist 文件中（位于 Platforms\iOS 文件夹下），添加以下权限：

<key>NSCameraUsageDescription</key>
<string>This app uses barcode scanning to...</string>

确保你提供了一个清晰且有效的理由，说明为什么你的应用需要访问相机。

Windows

Windows 目前不支持条码扫描，但你可以使用条码生成功能。不需要额外的权限。

步骤 4: 在 XAML 中使用 ZXing.Net.Maui

在你的 XAML 文件中，添加以下命名空间：

xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.Maui.Controls"

然后，你可以使用 CameraBarcodeReaderView 来扫描条码：

<zxing:CameraBarcodeReaderView x:Name="cameraBarcodeReaderView" BarcodesDetected="BarcodesDetected" />

步骤 5: 配置扫描选项和处理扫描结果

在代码中配置扫描选项并处理扫描结果：

cameraBarcodeReaderView.Options = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.OneDimensional,
    AutoRotate = true,
    Multiple = true
};

protected void BarcodesDetected(object sender, BarcodeDetectionEventArgs e)
{
    foreach (var barcode in e.Results)
    {
        Console.WriteLine($"Barcodes: {barcode.Format} -> {barcode.Value}");
    }
}