嵌入式Linux设备Qt虚拟键盘Backspace键无响应问题求助

现象概述 #

• 桌面环境（Windows/Linux）中，Qt虚拟键盘所有按键正常工作，触发KeyPress和KeyRelease事件
• 嵌入式Linux设备上，虚拟键盘仅触发QEvent::InputMethod事件，Backspace键无任何事件触发
• 外接实体键盘至嵌入式设备时，Backspace键可正常触发KeyPress/KeyRelease事件
• 两端使用的均为QtQuick.VirtualKeyboard 1.0版本

简化QML代码 #

import QtQuick 2.15
import QtQuick.VirtualKeyboard 1.0
import QtQuick.Controls 2.15
import QtQuick.Controls.Styles 1.4
import QtQuick.Layouts 1.3

Rectangle {
    id: root
    width: 640
    height: 480
    color: "red"

    TextField {
        id: test
        Layout.fillWidth: true
        horizontalAlignment: TextInput.AlignHCenter
        color: "white"
        font.pointSize: 20
        background: Rectangle {
            color: "red"
            border.color: "white"
        }
        onTextChanged: {
            classMyDialog.setText(text);
        }
    }

    InputPanel {
        id: inputPanel
        y: Qt.inputMethod.visible ? parent.height - inputPanel.height : parent.height
        anchors.left: parent.left
        anchors.right: parent.right
    }
}

当前环境 #

• Qt 5.15
• Yocto 4.0 (kirkstone)
• Linux 6.1.45

遇到的问题 #

尝试更新嵌入式设备的虚拟键盘时，在qtvirtualkeyboard_git.bb配方中发现SRCREV为4191fd9098ae25ffd5917370427460842e73f0cb，但该提交哈希不存在，且不在qtbase仓库中。

解决步骤 #

1. 定位Qt VirtualKeyboard的正确仓库 #

Qt VirtualKeyboard是独立仓库，不属于qtbase，仓库地址为git://code.qt.io/qt/qtvirtualkeyboard.git。执行以下命令查找提交：

git clone git://code.qt.io/qt/qtvirtualkeyboard.git
cd qtvirtualkeyboard
git log --all --grep="4191fd9098ae25ffd5917370427460842e73f0cb"

若未找到该提交，说明配方中的SRCREV可能有误，需检查使用的Yocto Qt层（如meta-qt5）是否为kirkstone对应分支。

2. 获取Qt 5.15匹配的VirtualKeyboard提交 #

切换到Qt 5.15对应的VirtualKeyboard分支，获取稳定提交哈希：

git checkout 5.15
git pull origin 5.15
# 获取当前分支HEAD的提交哈希
git rev-parse HEAD

将该哈希替换到qtvirtualkeyboard_git.bb的SRCREV字段中。

3. 排查Backspace键无响应的根源 #

（1）验证输入方法配置

确保嵌入式设备启用了Qt虚拟键盘作为输入方法，启动应用前设置环境变量：

export QT_IM_MODULE=qtvirtualkeyboard

（2）调试InputMethod事件

在QML中添加事件过滤器，监听输入方法事件细节：

Rectangle {
    id: root
    // ... 原有代码

    function eventFilter(obj, event) {
        if (event.type === Qt.InputMethod) {
            console.log("InputMethod event:", event)
            console.log("Delete count:", event.deleteCount)
            console.log("Commit string:", event.commitString)
        }
        return false
    }

    TextField {
        id: test
        // ... 原有代码
        Component.onCompleted: {
            installEventFilter(root)
        }
    }
}

• 若Backspace触发时deleteCount>0：说明输入方法已发送删除信号，需检查TextField的输入处理逻辑
• 若deleteCount=0：说明虚拟键盘未正确发送Backspace事件，需检查按键映射

（3）检查虚拟键盘按键映射

查看Qt VirtualKeyboard布局文件（如qtvirtualkeyboard/src/virtualkeyboard/content/layouts/en_US.qml）中Backspace键的配置，确保：

Key {
    key: Qt.Key_Backspace
    text: qsTr("Backspace")
    iconSource: "qrc:/qt-project.org/imports/QtQuick/VirtualKeyboard/content/images/backspace.png"
    repeat: true
}

或使用输入方法命令：

Key {
    inputMethodCommand: InputMethodCommand.DeletePreviousCharacter
    text: qsTr("Backspace")
    // ... 其他属性
}

4. 重新构建并部署 #

修改配方或配置后，重新构建虚拟键盘包：

bitbake qtvirtualkeyboard -c cleanall
bitbake qtvirtualkeyboard

将生成的包部署到嵌入式设备，测试Backspace功能。

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