Variables de entorno de Qt para Android
Activación o desactivación de soluciones provisionales
Qt para Android utiliza algunas variables de entorno para activar o desactivar determinadas soluciones alternativas:
Variables de uso habitual
| Variable | Descripción |
|---|---|
| QT_ANDROID_NO_EXIT_CALL | En algunos casos, es posible que una aplicación de Android no pueda limpiar de forma segura todos los hilos al llamar a ` exit() ` y que, por ello, se cuelgue. Esto se debe a que hay hilos de C++ en ejecución y, al destruirlos sin esperar a que finalicen, se cierra la aplicación. No es posible esperar a que estos hilos finalicen porque no se sabe si están en ejecución. Este indicador evita llamar a ` exit() ` y permite que el sistema Android se encargue de ello, a costa de no intentar ejecutar los destructores globales. |
| QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_PREDICTIVE_TEXT | Permite ocultar las sugerencias de texto predictivo, principalmente en los campos de contraseña. Algunos dispositivos no gestionan esto correctamente. Para obtener más información, consulta Texto predictivo. |
| QT_ANDROID_ENABLE_RIGHT_MOUSE_FROM_LONG_PRESS | Interpreta un toque prolongado como un evento de clic con el botón derecho del ratón. |
| QT_ANDROID_DISABLE_ACCESSIBILITY | Desactiva la accesibilidad. Esto impide el procesamiento de eventos de accesibilidad. |
| QT_ANDROID_NO_FULLSCREEN_KEYBOARD | No permite que Android muestre el IME a pantalla completa. Nota: Esta variable solo es válida para Qt 6.8.8, 6.11.1, 6.12 o versiones posteriores. Para Qt 6.12 y versiones posteriores, se recomienda utilizar en su lugar ` Qt::ImhNoFullscreen `. |
Variables menos utilizadas
| Variable | Descripción |
|---|---|
| QT_ANDROID_FONT_LOCATION | Establece una ruta personalizada para las fuentes del sistema. |
| QT_ANDROID_MAX_ASSETS_CACHE_SIZE | Tamaño de la caché para los recursos de la carpeta «assets». |
| QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUND | Véase «Almacenamiento en caché de glifos de texto» |
| QT_ANDROID_RASTER_IMAGE_DEPTH | |
| QT_ANDROID_MINIMUM_MOUSE_DOUBLE_CLICK_DISTANCE | |
| QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE | Cuando una aplicación de Android está en pausa o inactiva, puede seguir recibiendo actualizaciones de la interfaz de usuario procedentes de componentes como un BroadcastReceiver o un Service. Estas actualizaciones se ponen en cola hasta que la aplicación se reanuda. La cola puede crecer indefinidamente, lo que provoca un consumo adicional de memoria y latencia al procesar estas actualizaciones una vez que la aplicación vuelve a estar activa. Esta variable de entorno resuelve este problema estableciendo un límite de tamaño para la cola. Una vez alcanzado el límite especificado, se descarta la entrada más antigua para añadir la más reciente, evitando así un crecimiento ilimitado. Por defecto, la cola no tiene límite y esta variable de entorno no está configurada. Además, si se establece en cualquier número negativo, la cola sigue sin tener límite. Por ejemplo, QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE=100 limita la cola a 100 acciones. |
Nota: Aunque están relacionadas, estas variables no son lo mismo que los comandos o variables de CMake utilizados por Qt para Android; véase Configuración de CMake para Qt en Android
© 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.