Notas sobre la plataforma Android

Esta página contiene información particular para construir y ejecutar aplicaciones Qt en Android. Consulte Versiones de Android compatibles para conocer las versiones de Android y los niveles de API compatibles.

Consideraciones especiales sobre plugins e importaciones

Si una aplicación utiliza plugins que dependen de otros módulos, estos módulos deben estar listados en las dependencias de la aplicación. Para obtener más información, consulte Detección de dependencias.

Qt GUI Dependencia

Dado que las aplicaciones Android suelen incluir elementos GUI, el plugin Qt para Android se ha creado principalmente para proporcionar una GUI, por lo que implementa las distintas abstracciones QPA. Como resultado, se espera que el despliegue de una aplicación Qt para Android implique una dependencia de Qt GUI. Además, vale la pena señalar que Qt Creator sólo soporta compilaciones y despliegues Gradle, lo que significa que la línea de comandos o ejecuciones de shell no son compatibles fuera de la caja.

Consideraciones especiales sobre OpenGL

Los dispositivos modernos a menudo soportan OpenGL ES 3.0 o 3.1 además de 2.0. Para obtener un contexto OpenGL adecuado, establezca la versión solicitada a través de QSurfaceFormat::setVersion().

Problemas conocidos

Qt Creator Problemas de depuración

Consulte Qt Creator Problemas de depuración en Android para obtener más información.

Texto predictivo

Debido a un error en algunos dispositivos, cuando desactivas el texto predictivo con ImhNoPredictiveText, esta propiedad se ignora y el texto predictivo sigue activado. Para solucionar este problema, establezca la variable de entorno QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_PREDICTIVE_TEXT en 1. Sin embargo, un efecto secundario es que esta variable de entorno puede causar un problema con otros teclados como Gboard. Si utilizas un idioma como el japonés, con Gboard sólo se muestra un teclado QWERTY. Esta variable de entorno se consulta cada vez que se muestra el teclado, por lo que es posible activar y desactivar la solución, según sea necesario.

Almacenamiento en caché de glifos de texto

Debido a un error en algunos controladores OpenGL, el mecanismo utilizado por Qt para almacenar en caché los glifos de texto no funciona como se espera en todos los dispositivos Android, haciendo que el texto aparezca mezclado. Para remediarlo, existe una solución alternativa, pero puede aumentar el consumo de memoria y afectar al rendimiento del renderizado de texto. La solución se utiliza ahora por defecto en todos los dispositivos.

Puede desactivar esta solución estableciendo la variable de entorno QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUND en 1 o true. Sin embargo, sólo debe hacerlo después de comprobar que el texto aparece correctamente en todos los dispositivos.

Limitaciones

Algunos de los módulos o herramientas Qt pueden tener características no compatibles con Android o tener limitaciones. Consulte la documentación de un módulo específico para conocer las limitaciones de la plataforma.