En esta página

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

VariableDescripción
QT_ANDROID_NO_EXIT_CALLEn 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_TEXTPermite 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_PRESSInterpreta un toque prolongado como un evento de clic con el botón derecho del ratón.
QT_ANDROID_DISABLE_ACCESSIBILITYDesactiva la accesibilidad. Esto impide el procesamiento de eventos de accesibilidad.
QT_ANDROID_NO_FULLSCREEN_KEYBOARDNo 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

VariableDescripción
QT_ANDROID_FONT_LOCATIONEstablece una ruta personalizada para las fuentes del sistema.
QT_ANDROID_MAX_ASSETS_CACHE_SIZETamaño de la caché para los recursos de la carpeta «assets».
QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUNDVé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_SIZECuando 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.