条码比对系统是由单机版桌面软件和Android版的PDA扫码软件组成，桌面软件采用Blazor与WinForm进行混合开发，PDA扫码软件采用MAUI进行开发，这个项目都是基于.NET技术进行构建，这也是将近期学习Blazor和MAUI这两门技术应用到实践当中。
1. 项目背景
- 朋友公司外仓发货时把客户标签贴错了，导致客户扫码入库异常，被客户投诉，为此损失百万订单
- 为防止后续再次出现上述问题，因此开发一套条码比对系统来预防此类问题出现
2. 项目需求
- 客户下单后，将通知外仓备货，打印客户条码标签贴到纸箱上
- 外仓现场距离办公室远，无网络
- 根据客户订单明细和装箱配置自动生成总箱数（要考虑尾箱）
- 每箱出货码及数量必须与客户码及数量一致
- 总箱数和每箱条码比对一致，才能打印出货单，由司机签字装货
3. 技术方案
根据上述需求，系统分为PC单机版软件 + PDA扫码软件 + 数据传输接口三部分组成
- PC单机版软件：采用Blazor+WinForm进行混合开发
- PDA扫码软件：采用MAUI开发原生Android应用
- 数据传输接口：采用WebApi进行数据交互（用于PDA扫码完成后拿到办公室上载扫码数据）
4. 功能设计
1）PC单机版软件
主界面
- 装箱配置
配置料号与每箱数量关系，用于比对时自动根据出货清单的数量计算出货箱数。
- 条码比对
点击【新增】按钮进入比对页面添加一条比对记录，可对记录进行编辑、删除和打印交货单；交货完成可点击【归档】按钮将记录归入历史记录中。
点击【新增】按钮进入比对操作页面，在"扫码清单"下拉选择由扫描枪上载的扫码记录；点击【导入出货清单】将出货清单Excel导入系统；点击【比对】按钮将导入的出货清单与选择的扫码记录进行比对，比对结果显示在"单货比对结果"中，明细结果全部一致且总箱数一致，比对结果才一致；比对结果一致方可打印交货单放行。
- 扫码记录
用于查询由扫码枪PDA软件上载的扫码记录，点击名称连接查看该批扫码明细记录。
- 历史记录
用于查询历史比对记录，点击【取消归档】可取消归档该记录。
2）PDA扫码软件
- 扫码主页
打开条码比对PDA软件默认显示扫码主页，在文本框输入备注信息，再点击【开始扫码】按钮进入扫码比对页面，对逐个装箱条码进行扫码比对，全部扫码比对完成后点击【上载数据】按钮，将该批比对数据上载到电脑端比对管理系统与出货清单进行比对。
点击【开始扫码】后，显示扫码比对页面，按下PDA扫描枪按键，自动匹配条码信息至出货码，客户码、数量码，自动比对出货码与客户码是否一致，一致显示OK，否则显示FAIL；点击【确认继续】按钮继续扫描下一个装箱，如果条码不允许重复，可勾选"禁止提交重复条码选项"，全部扫完点击【全部完成】按钮返回扫码主页。
- 扫码记录
点击底部【记录】Tab菜单进入扫码记录页面，该功能主要是用于查询历史扫描的记录信息。
- 软件设置
点击底部【设置】Tab菜单进入软件设置页面，该功能主要是配置电脑端服务器主机地址，用于上载扫码记录，点击【测试连接】按钮测试与服务器链路是否通畅。
5. 遇到的问题
最初扫码时光标需要定位到一个文本框才能扫码，每次扫码需要点击文本框，用户体验很差，最终是通过PDA的广播功能解决这个问题，关键代码如下：
csharp
//定义扫码广播接收者
[BroadcastReceiver(Enabled = true, Exported = true)]
[IntentFilter(new[] { MainActivity.IntentAction })]
class ScanBroadcastReceiver : BroadcastReceiver
{
public override void OnReceive(Context context, Intent intent)
{
var value = intent.GetStringExtra("value");//扫码接收到的条码字符
AppSetting.OnScan?.Invoke(value); //调用扫码处理委托
}
}
//在Android入口注册和卸载扫码广播接收者
[Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
public class MainActivity : MauiAppCompatActivity
{
internal const string IntentAction = "android.intent.action.SCANRESULT";
private ScanBroadcastReceiver scanReceiver;
protected override void OnCreate(Bundle savedInstanceState)
{
base.OnCreate(savedInstanceState);
scanReceiver = new ScanBroadcastReceiver();//创建接收者
}
protected override void OnResume()
{
base.OnResume();
//注册接收者
RegisterReceiver(scanReceiver, new Android.Content.IntentFilter(IntentAction));
}
protected override void OnPause()
{
UnregisterReceiver(scanReceiver);//卸载接收者
base.OnPause();
}
}
//在扫码页面使用广播接收者
public partial class ScanPage : ContentPage
{
private ScanItem scan = new();
public ScanPage()
{
InitializeComponent();
BindingContext = scan;
AppSetting.OnScan = OnCodeChanged;//进入页面设置扫码处理委托
}
private void OnCodeChanged(string text)
{
//text即是PDA扫码接收到的条码字符串，在此处理条码数据
}
}