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/basic | Qt 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ón | Argumentos | Descripción | Observaciones |
|---|---|---|---|
| -vkb-enable <code>[,<code>]*" | Códigos de idioma admitidos o «all» | Activa el idioma especificado | Los idiomas especificados se pueden habilitar explícitamente mediante esta opción. Cada código de idioma tiene el formato idioma[_país], donde:
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, « 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 mano | Esta 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-keynavigation | Activa o desactiva la navegación con las teclas de flecha del teclado | Permite 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 virtual | El « 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-effects | Activa o desactiva los efectos de sonido | Esta 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-cangjie | Activa 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-zhuyin | Activa 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-desktop | Activa o desactiva la integración con el escritorio | De 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-layouts | Activa o desactiva las distribuciones integradas | Por 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 « | |
| -vkb-hunspell | [no|3rdparty|system] | Seleccionar la integración de Hunspell | Fuerza 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-pinyin | n/a | Desactiva la inclusión de los recursos de pinyin | Esta 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-tcime | n/a | Desactiva la inclusión de recursos tcime | Esta 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-sdk | ruta/a/cerence/sdk | Configura 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-static | handwriting | Habilita 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-cerence | n/a | Habilita la inclusión de los recursos de Cerence Handwriting | Esta opción agrupa los recursos de Cerence Handwriting en el binario del complemento. |
| -vkb-bundle-xt9 o -vkb-bundle-cerence | n/a | Habilita la inclusión de los recursos de XT9 | Esta opción incluye los recursos de XT9 en el binario del complemento. |
| -vkb-myscript-sdk | ruta/a/myscript/sdk | Configura 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 destino | El 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.txtIntegració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.zipEsto 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/sdkEstructura 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
└───staticEl contenido de cada directorio es el siguiente:
| Directorio | Descripción | Observaciones |
|---|---|---|
| api | Este directorio debe contener todos los archivos de la API | Los 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. |
| data | Este 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:
Base de datos HWR para Cerence Handwriting CJK:
Base de datos de idiomas:
|
| 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.
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/sdkLa 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.)
└─── confA continuación se describe el contenido de cada directorio:
| Directorio | Descripción |
|---|---|
| conf | Contiene los archivos de configuración de idioma que utiliza el motor para configurar los recursos lingüísticos. |
| doc | Contiene los archivos de documentación HTML. El archivo index.html muestra la página principal. |
| edk | Contiene 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. |
| engine | Contiene las bibliotecas de cada objeto del motor; dependiendo de las plataformas de destino, pueden ser SO, A o DLL. |
| rdk | Contiene el kit de desarrollo de recursos (Resource Development Kit), es decir, herramientas y ejemplos para crear recursos personalizados. |
| recursos | Contiene 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. |
| herramientas | Contiene herramientas útiles para programadores, entre las que se incluye InkTool para realizar pruebas de tinta. |
| voim | Contiene 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.