Flutter中不同Android条码扫描器KeyEvent行为不一致问题

问题详情 #

• 搭载Android 9的Cipherlab扫描器：生成符合预期的KeyEvent
• 搭载Android 8.1的Zebra扫描器：应用重启前会触发一系列含未知逻辑键、字符值为null的KeyRepeatEvent，重启应用后恢复正常
• 已排查Zebra设备的DataWedge设置

可行排查与解决方向 #

1. 过滤无效KeyRepeatEvent #

在Flutter键盘事件监听中主动过滤字符值为null的重复事件，避免干扰业务逻辑：

RawKeyboard.instance.addListener((RawKeyEvent event) {
  // 只处理有效按键事件
  if ((event is RawKeyDownEvent || event is RawKeyUpEvent) && event.character != null) {
    // 执行你的条码解析逻辑
    handleBarcodeInput(event.character!);
  }
  // 直接忽略字符为null的KeyRepeatEvent
});

2. 深度检查Zebra扫描器配置 #

即便已检查DataWedge，仍可确认以下细节：

• 确认DataWedge的扫描输出模式为键盘仿真（Keyboard Wedge），且未开启重复按键模拟选项
• 排查是否存在自定义按键映射规则，导致生成未知逻辑键
• 尝试将DataWedge配置重置为默认值，再重新适配应用

3. 针对Android版本的原生适配 #

由于Android 8.1与9的KeyEvent处理逻辑存在差异，可通过原生层拦截处理：

• 在Flutter项目的Android原生MainActivity中，重写dispatchKeyEvent方法，针对Zebra Android 8.1设备过滤无效的KeyRepeatEvent
• 通过设备型号与系统版本判断，定向处理异常事件

4. 应用启动时初始化扫描器 #

在应用启动阶段主动触发扫描器状态重置，避免设备缓存状态影响：

• 通过MethodChannel调用原生代码，触发Zebra扫描器重新初始化
• 在Flutter页面的initState中添加延迟初始化逻辑，确保扫描器状态稳定

内容的提问来源于stack exchange，提问作者Jim Lu