En esta página

Creación Qt Virtual Keyboard

Descripción general

Este documento describe cómo compilar el complemento « Qt Virtual Keyboard ».

El proyecto se divide en los siguientes subproyectos:

examples/virtualkeyboard/basicQt Virtual Keyboard Aplicación de demostración
src/components/Qt Virtual Keyboard Componentes del complemento QML (QtQuick.VirtualKeyboard.Components)
src/plugin/Qt Virtual Keyboard Complemento de contexto de entrada de la plataforma. Este complemento proporciona la interfaz QPlatformInputContext y actúa como una capa entre el contexto de entrada de QML y la plataforma.
src/plugins/Un directorio que contiene los complementos de Qt Virtual Keyboard (QtQuick.VirtualKeyboard.Plugins), que implementan métodos de entrada complejos, como HunspellInputMethod. La configuración en tiempo de compilación especifica qué complementos se compilan y se cargan en tiempo de ejecución.
src/settings/Qt Virtual Keyboard Complemento QML de configuración (QtQuick.VirtualKeyboard.Settings). Este complemento proporciona ajustes configurables por la aplicación para el teclado virtual.
src/styles/Qt Virtual Keyboard Complemento QML «Styles» (QtQuick.VirtualKeyboard.Styles).
src/virtualkeyboard/Qt Virtual Keyboard Módulo y complemento QML.

Opciones de configuración

La tabla siguiente contiene las opciones de nivel superior para configurar las funciones del teclado virtual. Estas opciones se pasan a la herramienta configure.

OpciónArgumentosDescripciónObservaciones
-vkb-enable <code>[,<code>]*"Códigos de idioma admitidos o «all»Activa el idioma especificadoLos idiomas especificados se pueden habilitar explícitamente mediante esta opción. Cada código de idioma tiene el formato idioma[_país], donde:
  • «idioma» es un código de idioma ISO 639 de dos letras en minúsculas
  • país es un código de país ISO 3166 de dos letras en mayúsculas

Esta opción se puede utilizar para definir la compatibilidad con los idiomas según sea necesario. El teclado virtual puede admitir uno o más idiomas a la vez.

Por ejemplo, « -vkb-enable de_DE,fi_FI » habilita la compatibilidad con los idiomas alemán y finés.

El teclado virtual incluye automáticamente todos los idiomas compatibles si no se especifican otros.

-vkb-handwriting[no|ejemplo-hwr|mi-escritura-hwr|cerence-hwr]Activa o desactiva la entrada mediante escritura a manoEsta opción habilita la entrada mediante escritura a mano. Por defecto, el motor se activa automáticamente si se encuentra en la carpeta de complementos adecuada, incluso sin utilizar esta opción. Sin embargo, en caso de que coexistan MyScript y Cerence SDK, se debe configurar una de las siguientes opciones: [no|myscript-hwr|cerence-hwr]. La opción «example-hwr» debe activarse explícitamente. Esto puede hacerse con fines de desarrollo y pruebas.
[-no]-vkb-arrow-keynavigationActiva o desactiva la navegación con las teclas de flecha del tecladoPermite controlar el teclado mediante las teclas de flecha y la tecla de retorno. Esta función está desactivada por defecto.
-vkb-style[standard|retro]Elige el estilo del teclado virtualEl « Qt Virtual Keyboard » admite dos estilos: estándar y retro. Ambos estilos se incluyen en el paquete, pero esta opción te permite cambiar el estilo predeterminado integrado.
[-no]-vkb-sound-effectsActiva o desactiva los efectos de sonidoEsta opción activa o desactiva la compatibilidad con los efectos de sonido. Depende del módulo Multimedia y se activa de forma implícita cuando dicho módulo está disponible. Ten en cuenta que los archivos de efectos de sonido propiamente dichos se definen en el estilo del teclado, por lo que activar solo esta opción no hace que los efectos de sonido sean audibles.
[-no]-vkb-cangjieActiva o desactiva el método de entrada Cangjie para el chino tradicional.Esta opción activa o desactiva el método de entrada Cangjie para el chino tradicional. El método de entrada está activado por defecto si se ha habilitado la compatibilidad con el chino tradicional.
[-no]-vkb-zhuyinActiva o desactiva el método de entrada Zhuyin para el chino tradicional.Esta opción activa o desactiva el método de entrada Zhuyin para el chino tradicional. El método de entrada está activado de forma predeterminada si se ha habilitado la compatibilidad con el chino tradicional.
[-no]-vkb-desktopActiva o desactiva la integración con el escritorioDe forma predeterminada, la integración con el escritorio está activada cuando el entorno de destino es X11 o el escritorio de Windows. Con esta opción, se puede desactivar la integración con el escritorio.

Nota: Para la integración integrada, en la que la aplicación instancía el objeto ` InputPanel `, no es necesario utilizar esta opción de forma explícita. El teclado virtual no creará el panel de entrada del escritorio si la aplicación crea un objeto ` InputPanel ` antes de que el foco se establezca en un campo de entrada.

[-no]-vkb-layoutsActiva o desactiva las distribuciones integradasPor defecto, el complemento del teclado virtual contiene la distribución de teclado en inglés. Al especificar -no-vkb-layouts, se excluyen las distribuciones integradas del complemento del teclado virtual.

Nota: En este caso, la variable de entorno « QT_VIRTUALKEYBOARD_LAYOUT_PATH » debe establecerse en el directorio del sistema de archivos que contenga las distribuciones de teclado personalizadas antes de ejecutar la aplicación.

-vkb-hunspell[no|3rdparty|system]Seleccionar la integración de HunspellFuerza el método de integración de Hunspell a la opción especificada. La opción «3rdparty» selecciona la compilación local del código fuente de Hunspell utilizando los archivos de proyecto del repositorio del teclado virtual. Esta opción requiere que el repositorio Git de Hunspell se haya clonado en el directorio «src/plugins/hunspell/3rdparty/hunspell ». La opción «system» selecciona el paquete del sistema a través de pkg-config. La opción «no» desactiva el complemento de Hunspell.
-vkb-no-bundle-pinyinn/aDesactiva la inclusión de los recursos de pinyinEsta opción excluye los recursos de pinyin del binario del complemento. Esta opción puede utilizarse para reducir el tamaño del binario del complemento.
-vkb-no-bundle-tcimen/aDesactiva la inclusión de recursos tcimeEsta opción excluye los recursos de tcime del binario del complemento. Esta opción puede utilizarse para reducir el tamaño del binario del complemento.
-vkb-cerence-sdkruta/a/cerence/sdkConfigura la ubicación del SDK de Cerence y habilita las integraciones de Cerence Handwriting y XT9.El archivo zip del SDK de Cerence debe descomprimirse utilizando el script src/plugins/cerence/unpack.py. Por defecto, el SDK se descomprime en src/plugins/cerence/sdk, donde los scripts de compilación pueden recuperarlo automáticamente. Sin embargo, utilizando el segundo parámetro del script unpack.py, es posible utilizar una ubicación diferente para el SDK. En ese caso, la ubicación debe pasarse al script de compilación mediante el parámetro de línea de comandos -vkb-cerence-sdk.
-vkb-cerence-statichandwritingHabilita la vinculación estática del motor de escritura a mano de Cerence.El motor de escritura a mano de Cerence se enlaza dinámicamente de forma predeterminada. Utiliza -vkb-cerence-static para forzar el enlace estático.
-vkb-bundle-cerence-hwr o -vkb-bundle-cerencen/aHabilita la inclusión de los recursos de Cerence HandwritingEsta opción agrupa los recursos de Cerence Handwriting en el binario del complemento.
-vkb-bundle-xt9 o -vkb-bundle-cerencen/aHabilita la inclusión de los recursos de XT9Esta opción incluye los recursos de XT9 en el binario del complemento.
-vkb-myscript-sdkruta/a/myscript/sdkConfigura la ubicación del SDK de MyScript Text y habilita la integración de MyScript Handwriting.El SDK de MyScript Text (zip), que se descomprime en src/plugins/myscript/sdk, puede ser detectado automáticamente por los scripts de compilación. No obstante, el SDK puede colocarse en otra ubicación. En ese caso, la ubicación debe indicarse al script de compilación mediante el parámetro de línea de comandos -vkb-myscript-sdk.
-vkb-myscript-arch[x86|x64|armv7hf|armv7|arm64]Configura la arquitectura de CPU de destinoEl MyScript Text SDK ofrece bibliotecas compartidas (dinámicas) para diferentes arquitecturas de CPU: [x86|x64|armv7hf|armv7|arm64] para Linux y [x86|x64] para Windows. Se puede configurar automáticamente. No obstante, el usuario también puede especificar la arquitectura de CPU de destino utilizando el parámetro de línea de comandos « -vkb-myscript-arch ».

Integración con Hunspell

De forma predeterminada, HunspellInputMethod no estará disponible a menos que se encuentren la biblioteca Hunspell y los encabezados de desarrollo. Para los destinos Linux/X11, la biblioteca Hunspell se puede obtener instalando el paquete libhunspell-dev. Como alternativa, se puede clonar el repositorio git de Hunspell en el directorio ` src/plugins/hunspell/3rdparty/hunspell `. qmake detecta automáticamente los fuentes y el proyecto se configurará para utilizar el Hunspell local. Si se utilizan los fuentes de Hunspell, también se deben copiar los archivos de diccionario en el directorio src/plugins/hunspell/3rdparty/hunspell/data.

A continuación se muestra un ejemplo de cómo debería quedar la estructura de directorios tras configurar los archivos fuente de Hunspell y los archivos de diccionario:

3rdparty
└── hunspell
    ├── data
    │   ├── en_GB.aff
    │   └── en_GB.dic
    ├── hunspell <-- Hunspell git repository
    └── CMakeLists.txt

Integración de escritura manuscrita de Cerence

La integración de Cerence Handwriting es compatible con los motores «Alphabetic» y «CJK» (chino, japonés y coreano). Ambos motores se integran a través de T9WriteInputMethod. El método de entrada se inicializa con un motor cada vez. La selección del motor se realiza automáticamente en función de la configuración regional de entrada actual.

Compatibilidad de Cerence Handwriting

Qt Virtual Keyboard es compatible con Cerence Handwriting v8.7 o posterior.

Preparativos para la compilación de Cerence Handwriting

El contenido del SDK debe descomprimirse utilizando el script unpack.py, que se encuentra en el directorio «cerence ». Esto garantiza que la estructura de directorios sea la correcta para que CMake pueda localizar el contenido.

$ cd src/plugins/cerence/
$ python unpack.py filename.zip

Esto descomprimirá el contenido en el directorio src/plugins/cerence/sdk, donde CMake podrá detectarlo automáticamente.

Como alternativa, puedes descomprimirlo en cualquier otro directorio añadiendo un parámetro adicional a la línea de comandos. En este caso, la ubicación del SDK debe indicarse al script configure.

configure ... -vkb-cerence-sdk /path/to/cerence/sdk

Estructura del SDK de Cerence

El contenido extraído del SDK tiene el siguiente aspecto:

sdk
├───t9write
│   ├───api
│   ├───data
│   │   ├───arabic
│   │   ├───hebrew
│   │   └───thai
│   └───lib
│       ├───linux
│       │   ├───arm64
│       │   │   ├───shared
│       │   │   │   ├───alphabetic
│       │   │   │   └───cjk
│       │   │   └───static
│       │   │       ├───alphabetic
│       │   │       └───cjk
│       │   └───x86_64
│       │       ├───shared
│       │       │   ├───alphabetic
│       │       │   └───cjk
│       │       └───static
│       │           ├───alphabetic
│       │           └───cjk
│       └───win32
│           ├───x86
│           │   ├───shared
│           │   │   ├───alphabetic
│           │   │   └───cjk
│           │   └───static
│           │       ├───alphabetic
│           │       └───cjk
│           └───x86_64
│               ├───shared
│               │   ├───alphabetic
│               │   └───cjk
│               └───static
│                   ├───alphabetic
│                   └───cjk
└───xt9
    ├───api
    ├───data
    └───lib
        ├───linux
        │   ├───arm64
        │   │   ├───shared
        │   │   └───static
        │   └───x86_64
        │       ├───shared
        │       └───static
        └───win32
            ├───x86
            │   ├───shared
            │   └───static
            └───x86_64
                ├───shared
                └───static

El contenido de cada directorio es el siguiente:

DirectorioDescripciónObservaciones
apiEste directorio debe contener todos los archivos de la APILos archivos de la API suelen encontrarse en los directorios «api» y «public» del SDK, aunque a veces también en el directorio «demo».

Cuando se utilizan simultáneamente los motores «Alphabetic» y «CJK», cualquier archivo que se solape puede copiarse desde cualquiera de los dos SDK.

dataEste directorio debe contener todas las bases de datos HWR y, opcionalmente, las bases de datos XT9.Base de datos HWR para el motor de escritura manuscrita alfabética de Cerence:
  • _databas_le.bin

Base de datos HWR para Cerence Handwriting CJK:

  • cjk_HK_std_le.hdb chino de Hong Kong
  • cjk_J_std_le.hdb Japonés
  • cjk_K_mkt_le.hdb Coreano
  • cjk_S_gb18030_le.hdb Chino simplificado
  • cjk_T_std_le.hdb Chino tradicional

Base de datos de idiomas:

  • La extensión del archivo es .ldb o .phd
lib/<destino>/<enlace>/<variante-del-motor>Estructura de directorios que contiene las compilaciones de destino compatibles.Estos directorios deben contener las bibliotecas de destino deseadas. Si se encuentran tanto bibliotecas compartidas como estáticas, se dan preferencia a las bibliotecas compartidas.

El código de integración de Cerence Handwriting y XT9 se activa automáticamente cuando se detecta el SDK de Cerence.

Se deben eliminar todas las demás extensiones del directorio [qtbase]/plugins/virtualkeyboard antes de compilar las extensiones de Cerence para evitar conflictos de comportamiento en tiempo de ejecución. Las extensiones de Cerence no requieren ningún otro complemento de teclado virtual para funcionar.

Las bases de datos de escritura manuscrita y de idiomas para XT9 se instalan en el directorio [qtbase]/qtvirtualkeyboard/cerence. Además, existen otras dos alternativas para localizar estos archivos:

  • Una ubicación de tiempo de ejecución personalizada definida mediante variables de entorno
  • La opción de línea de comandos -vkb-bundle-cerence para integrar recursos en los binarios del complemento

Integración del SDK de MyScript Text

MyScript Text está diseñado para crear aplicaciones que permitan el reconocimiento de texto manuscrito. MyScript Text admite el reconocimiento de caracteres aislados, escritura cursiva, en letra de imprenta y superpuesta. La escritura superpuesta de MyScript está integrada en Qt Virtual Keyboard. Permite el reconocimiento de letras, palabras o partes de palabras escritas unas encima de otras, sin ninguna separación explícita entre fragmentos consecutivos. Es capaz de funcionar en dispositivos con memoria y CPU limitadas.

Estilos de escritura manuscrita admitidos por el SDK de MyScript Text

El usuario final puede escribir un fragmento de palabra sobre otro, o un carácter sobre otro, tal y como se muestra a continuación. El espacio entre dos palabras escritas se añade automáticamente, por lo que no es necesario realizar ningún gesto explícito.

Escribir un carácter encima de otro
Escribir fragmentos de palabra unos sobre otros

Idiomas compatibles con MyScript Text SDK

MyScript Superimposed es compatible con 72 idiomas.

Instalación de los paquetes de MyScript Text SDK

El equipo de distribución de MyScript puede proporcionarte los paquetes en diversos archivos « .zip ». Para acceder a todo el código, las herramientas y los recursos necesarios para crear tu propia aplicación de escritura manuscrita, extrae todos los paquetes en la misma carpeta de destino que src/plugins/myscript/sdk, donde CMake podrá detectarlos automáticamente.

Como alternativa, puede extraer los paquetes en cualquier otro directorio. En este caso, deberá indicar la ubicación del SDK al script de configuración.

configure ... -vkb-myscript-sdk /path/to/myscript/sdk

La jerarquía de archivos debería tener el siguiente aspecto:

myscript
└── sdk
    ├─── conf
    ├─── doc
    ├─── edk
    ├─── engine
    │   └─── bin
    │       ├─── lin-arm64
    │       │   └─── *.so
    │       ├─── lin-armv7
    │       │   └─── *.so
    │       ├─── lin-armv7hf
    │       │   └─── *.so
    │       ├─── lin-x64
    │       │   └─── *.so
    │       ├─── lin-x86
    │       │   └─── *.so
    │       ├─── win-x64
    │       │   └─── *.dll
    │       ├─── win-x86
    │       │   └─── *.dll
    │       (etc.)
    ├─── rdk
    ├─── resources
    │   ├─── ar
    │   │   └─── *.res
    │   ├─── en_GB
    │   │   └─── *.res
    │   ├─── ja_JP
    │   │   └─── *.res
    │   ├─── ko_KR
    │   │   └─── *.res
    │   ├─── zh_CN
    │   │   └─── *.res
    │   (etc.)
    ├─── tools
    └─── voim
        ├─── api
        ├─── bin
        │   ├─── lin-arm64
        │   │   └─── *.so
        │   ├─── lin-armv7
        │   │   └─── *.so
        │   ├─── lin-armv7hf
        │   │   └─── *.so
        │   ├─── lin-x64
        │   │   └─── *.so
        │   ├─── lin-x86
        │   │   └─── *.so
        │   ├─── win-x64
        │   │   └─── *.dll
        │   ├─── win-x86
        │   │   └─── *.dll
        │   (etc.)
        └─── conf

A continuación se describe el contenido de cada directorio:

DirectorioDescripción
confContiene los archivos de configuración de idioma que utiliza el motor para configurar los recursos lingüísticos.
docContiene los archivos de documentación HTML. El archivo index.html muestra la página principal.
edkContiene el kit de desarrollo del motor (Engine Development Kit) y elementos de programación de escritura manuscrita para cada API de lenguaje de programación compatible, incluyendo ejemplos de código.
engineContiene las bibliotecas de cada objeto del motor; dependiendo de las plataformas de destino, pueden ser SO, A o DLL.
rdkContiene el kit de desarrollo de recursos (Resource Development Kit), es decir, herramientas y ejemplos para crear recursos personalizados.
recursosContiene archivos de recursos con la extensión /c .res. Se trata de recursos binarios que utilizan en tiempo de ejecución las diferentes tecnologías de MyScript para llevar a cabo las diversas tareas de reconocimiento.
herramientasContiene herramientas útiles para programadores, entre las que se incluye InkTool para realizar pruebas de tinta.
voimContiene bibliotecas del método de entrada de texto de MyScript. Se trata de un SDK de ampliación del sistema de reconocimiento de texto de MyScript, diseñado para crear métodos de entrada mediante el reconocimiento de escritura manuscrita de forma fácil y rápida.

Configuración del certificado del SDK de MyScript Text

Es obligatorio disponer de un certificado válido para utilizar el SDK de MyScript Text. Se trata de una medida de seguridad que te identifica de forma única como cliente legítimo de las tecnologías de MyScript. El certificado ayuda a MyScript a rastrear la identidad de los clientes y los productos que se han adquirido.

El certificado se entrega en el archivo « [your_login].vo.zip package ». Al descomprimir este paquete, el certificado se coloca automáticamente en la ubicación adecuada. Esto garantiza que el certificado funcione al instante en los servicios y los ejemplos de código que se le han proporcionado.

Cómo compilar « Qt Virtual Keyboard » con el SDK de MyScript Text

El código de integración de MyScript se activa automáticamente cuando se detecta el SDK de MyScript Text.

Los recursos de idioma para MyScript Text SDK se instalan en el directorio [qtbase]/qtvirtualkeyboard/myscript.

Compilaciones estáticas

El teclado virtual se puede compilar y vincular de forma estática a la aplicación. Esto implica que Qt también se compila de forma estática (utilizando la opción -static en la línea de comandos configure).

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.