syncfusion-maui-barcode-generator

实现 .NET MAUI 条码生成器

Syncfusion® .NET MAUI 条码生成器（SfBarcodeGenerator）是一种数据可视化控件，可生成并显示机器可读格式的数据。它提供了全面的文本编码方式，支持多种条码符号类型，包括一维（线性）和二维（矩阵）条码。

何时使用此技能

在需要执行以下操作时使用此技能：

• 生成条码，用于零售商品、库存、运输标签或身份识别
• 创建 QR 码，用于网址、联系信息、Wi-Fi 凭据或支付系统
• 以机器可读格式直观地编码数据，供扫描应用使用
• 在单个应用中支持多种符号类型（商品编码、批次追踪等）
• 自定义条码外观，以符合品牌形象或可读性要求
• 在 .NET MAUI 应用中显示条码，支持 Windows、macOS、Android 和 iOS
• 实现扫描解决方案，在其中生成并显示条码
• 添加 Data Matrix 码，用于小型包装或高密度数据编码

组件概述

条码生成器控件可创建多种符合行业标准的格式的条码，包括零售（UPC、EAN）、库存管理（Code128、Code39）、物流（Codabar）以及现代二维条码（QR Code、Data Matrix）。它提供丰富的自定义选项，可调整外观、文本显示和条码尺寸。

主要功能：

• 13 种条码符号类型——11 种一维类型 + 2 种二维类型
• 一维条码——Code128、EAN8、EAN13、UPC-A、UPC-E、Code39、Code39 Extended、Code93、Codabar，以及 Code128 变体（A、B、C）
• 二维条码——支持错误纠正的 QR Code，以及支持多种编码的 Data Matrix
• 外观自定义——前景色/背景色、条/点尺寸、文本样式
• 文本显示——使用自定义字体、颜色、间距和对齐方式显示输入值
• 灵活调整尺寸——通过 Module 属性精确控制，并自动调整尺寸以获得最佳显示效果

文档与导航指南

入门

📄 阅读： references/getting-started.md

首次设置条码生成器时，请参阅此文档：

• NuGet 包安装（Syncfusion.Maui.Barcode）
• 在 MauiProgram.cs 中注册处理程序
• 基本条码初始化和命名空间导入
• 设置默认符号类型（Code128）或 QR Code
• 使用 ShowText 属性显示输入值
• 多 IDE 设置（Visual Studio、VS Code、JetBrains Rider）

一维条码

📄 阅读： references/one-dimensional-barcodes.md

使用线性/一维条码时，请参阅此文档：

• Codabar——图书馆、血库；支持数字和特殊字符
• Code39——字母数字，可选校验位，具备自校验功能
• Code39 Extended——支持完整 ASCII，包括小写字母
• Code93——增强版 Code39，密度更高
• Code128——效率高，支持完整 ASCII，自动选择字符集
• Code128A——大写字母、控制字符（ASCII 0-95）
• Code128B——大小写字母、标准键盘字符（ASCII 32-127）
• Code128C——数字对（00-99），用于高密度数字编码
• UPC-A——12 位零售商品编码（北美）
• UPC-E——省略零的 UPC，适用于小型包装
• EAN-13——13 位国际商品编码
• EAN-8——8 位短商品编码
• 用于控制条宽度的 Module 属性

二维条码

📄 阅读： references/two-dimensional-barcodes.md

使用此参考资料处理二维矩阵条码：

• QR Code - 用于 URL、文本且容量大的方形网格条码
  • 纠错级别（低 7%、中 15%、四分位 25%、高 30%、自动）
  • 输入模式（数字、字母数字、二进制、自动）
  • 代码版本（1-40，模块尺寸从 21×21 扩展至 177×177）
  • 使用纠错功能读取受损的代码
• Data Matrix - 用于标签、小型包装的矩形/方形网格
  • 数据类型（数字、字母数字、二进制）
  • 编码方法（自动、ASCII、ASCIINumeric、Base256）
  • 容量最高可达 2335 个字母数字字符或 3116 个数字字符
• 用于控制点/单元格大小的 Module 属性

自定义与样式

📄 阅读： references/customization.md

自定义条码外观时使用此参考资料：

• 文本自定义
  • ShowText 属性，用于显示输入值
  • TextStyle（字体系列、大小、颜色、斜体/粗体等属性）
  • TextSpacing（条码与文本之间的间距）
  • TextAlignment（起始、居中、结束）
• 条/点自定义
  • Module 属性（最小条线或点的大小）
  • ForegroundColor（条/点颜色）
  • BackgroundColor（条码背景）
  • 一维与二维条码的行为差异
  • 未设置 Module 时自动调整大小