如何在QML应用中实现自定义输入法？示例代码运行崩溃求助

崩溃原因 #

1. 缺失VirtualKeyboard依赖：你的CMake配置未引入Qt VirtualKeyboard组件，导致运行时无法加载相关库，触发崩溃。
2. 错误的InputMethod使用方式：QML中的InputMethod是抽象接口，不能直接实例化并替换系统输入法，必须通过C++实现标准输入法接口后注册使用。
3. 候选词逻辑缺失：原代码未实现自定义候选词的生成与展示逻辑，无法满足自动补全需求。

修复与实现步骤 #

1. 修改CMakeLists.txt，添加VirtualKeyboard依赖 #

cmake_minimum_required(VERSION 3.16)

project(inputMethod VERSION 0.1 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 引入VirtualKeyboard组件
find_package(Qt6 6.5 REQUIRED COMPONENTS Quick VirtualKeyboard)

qt_standard_project_setup(REQUIRES 6.5)

qt_add_executable(appinputMethod
    main.cpp
    custominputmethod.h
    custominputmethod.cpp
)

qt_add_qml_module(appinputMethod
    URI inputMethod
    VERSION 1.0
    QML_FILES Main.qml
)

set_target_properties(appinputMethod PROPERTIES
    MACOSX_BUNDLE_BUNDLE_VERSION ${PROJECT_VERSION}
    MACOSX_BUNDLE_SHORT_VERSION_STRING ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}
    MACOSX_BUNDLE TRUE
    WIN32_EXECUTABLE TRUE
)

# 链接VirtualKeyboard库
target_link_libraries(appinputMethod
    PRIVATE Qt6::Quick Qt6::VirtualKeyboard
)

include(GNUInstallDirs)
install(TARGETS appinputMethod
    BUNDLE DESTINATION .
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)

2. C++实现自定义输入法（含候选词逻辑） #

custominputmethod.h

#ifndef CUSTOMINPUTMETHOD_H
#define CUSTOMINPUTMETHOD_H

#include <QtVirtualKeyboard/qvirtualkeyboardinputmethod.h>

class CustomInputMethod : public QVirtualKeyboardInputMethod
{
    Q_OBJECT
public:
    explicit CustomInputMethod(QObject *parent = nullptr);

    QList<QVirtualKeyboardInputEngine::InputMode> inputModes(const QString &locale) override;
    bool setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode) override;
    bool setTextCase(QVirtualKeyboardInputEngine::TextCase textCase) override;
    void reset() override;
    void update() override;
    bool keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers) override;

private:
    QStringList getCandidates(const QString &input);
};

#endif // CUSTOMINPUTMETHOD_H

custominputmethod.cpp

#include "custominputmethod.h"
#include <QtVirtualKeyboard/qvirtualkeyboardinputengine.h>
#include <QtVirtualKeyboard/qvirtualkeyboardinputcontext.h>

CustomInputMethod::CustomInputMethod(QObject *parent)
    : QVirtualKeyboardInputMethod(parent)
{}

QList<QVirtualKeyboardInputEngine::InputMode> CustomInputMethod::inputModes(const QString &locale)
{
    Q_UNUSED(locale)
    return {QVirtualKeyboardInputEngine::Latin};
}

bool CustomInputMethod::setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode)
{
    Q_UNUSED(locale)
    Q_UNUSED(inputMode)
    return true;
}

bool CustomInputMethod::setTextCase(QVirtualKeyboardInputEngine::TextCase textCase)
{
    Q_UNUSED(textCase)
    return true;
}

void CustomInputMethod::reset()
{
    inputEngine()->setCandidates({});
}

void CustomInputMethod::update()
{
    QString currentText = inputContext()->preeditText();
    inputEngine()->setCandidates(getCandidates(currentText));
}

bool CustomInputMethod::keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)
{
    Q_UNUSED(modifiers)
    if (key == Qt::Key_Backspace) {
        if (!inputContext()->preeditText().isEmpty()) {
            inputContext()->setPreeditText(inputContext()->preeditText().left(inputContext()->preeditText().length() - 1));
            update();
            return true;
        }
    } else if (!text.isEmpty() && text.isPrintable()) {
        QString newPreedit = inputContext()->preeditText() + text;
        inputContext()->setPreeditText(newPreedit);
        update();
        return true;
    } else if (key == Qt::Key_Enter || key == Qt::Key_Return) {
        inputContext()->commit(inputContext()->preeditText());
        inputContext()->setPreeditText({});
        reset();
        return true;
    }
    return false;
}

QStringList CustomInputMethod::getCandidates(const QString &input)
{
    // 模拟自动补全逻辑，可根据需求修改
    QStringList candidates;
    if (input.startsWith("h")) {
        candidates << "hello" << "world" << "how" << "hi";
    } else if (input.startsWith("w")) {
        candidates << "world" << "welcome" << "what";
    }
    return candidates;
}

3. 修改main.cpp，注册自定义输入法 #

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QtVirtualKeyboard/qvirtualkeyboardinputengine.h>
#include "custominputmethod.h"

int main(int argc, char *argv[])
{
    qputenv("QT_IM_MODULE", QByteArray("qtvirtualkeyboard"));

    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;

    // 注册自定义输入法到系统输入引擎
    auto inputEngine = QVirtualKeyboardInputEngine::instance();
    auto customInputMethod = new CustomInputMethod(&app);
    inputEngine->setInputMethod(customInputMethod);

    const QUrl url(u"qrc:/inputMethod/Main.qml"_qs);
    QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
                     &app, [url](QObject *obj, const QUrl &objUrl) {
        if (!obj && url == objUrl)
            QCoreApplication::exit(-1);
    }, Qt::QueuedConnection);
    engine.load(url);

    return app.exec();
}

4. 简化QML代码（移除错误的InputMethod实例） #

import QtQuick
import QtQuick.VirtualKeyboard
import QtQuick.Controls

Window {
    id: window

    width: 400
    height: 300

    visible: true

    TextField {
        anchors.centerIn: window
        width: 300
        placeholderText: "点击输入测试"
    }

    InputPanel {
        id: inputPanel

        z: 99
        x: 0
        y: window.height

        width: window.width

        states: State {
            name: "visible"
            when: inputPanel.active
            PropertyChanges {
                target: inputPanel
                y: window.height - inputPanel.height
            }
        }

        transitions: Transition {
            from: ""
            to: "visible"
            reversible: true
            ParallelAnimation {
                NumberAnimation {
                    properties: "y"
                    duration: 250
                    easing.type: Easing.InOutQuad
                }
            }
        }
    }
}

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