KivyMD中VKeyboard按键识别错误及TextField输入异常问题排查

问题描述 #

在基于KivyMD的应用中使用VKeyboard虚拟键盘时，遇到两类核心问题：

• 按键识别不准确：例如按下“4”键却被识别为“6”
• 输入无法同步到KivyMD TextField：即使通过on_key_up事件捕获到按键，内容也无法正常显示或完全无输入

环境信息 #

• Kivy版本：2.3.0
• KivyMD版本：2.0.1.dev0
• Python版本：3.9
• 运行平台：Raspberry Pi CM4

复现步骤 #

1. 配置VKeyboard使用numeric.json数字布局
2. 通过on_focus事件绑定VKeyboard与TextField，控制键盘显示
3. 运行应用并尝试通过虚拟键盘输入，可观察到按键识别错误及输入异常

解决方法 #

通过以下操作可解决问题：

1. 在代码开头设置Kivy Config的keyboard_mode为systemanddock，并指定keyboard_layout路径：

from kivy.config import Config

Config.set('kivy', 'keyboard_mode', 'systemanddock')
Config.set('kivy', 'keyboard_layout', 'path/to/numeric.json')

2. 将Kivy与KivyMD更新至最新版本

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