Variables d'environnement de Qt pour Android
Activation ou désactivation des solutions de contournement
Qt pour Android utilise certaines variables d'environnement pour activer/désactiver certaines solutions de contournement :
Variables couramment utilisées
| Variable | Description de la variable |
|---|---|
| QT_ANDROID_NO_EXIT_CALL | Dans certains cas, une application Android peut ne pas être en mesure de nettoyer tous les threads en toute sécurité lors de l'appel à exit() et peut se planter. En effet, des threads C++ sont en cours d'exécution et les détruire sans les rejoindre met fin à l'application. Ces threads ne peuvent pas être rejoints car il n'est pas possible de savoir s'ils sont en cours d'exécution. Ce drapeau évite d'appeler exit() et laisse le système Android gérer cela, au prix de ne pas essayer d'exécuter des destructeurs globaux. |
| QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_PREDICTIVE_TEXT | Permet de masquer les suggestions de texte prédictif, principalement dans les champs de mots de passe. Certains appareils ne gèrent pas cela correctement. Pour plus d'informations, voir Texte prédictif. |
| QT_ANDROID_ENABLE_RIGHT_MOUSE_FROM_LONG_PRESS | Interprète un appui long comme un événement de clic droit. |
| QT_ANDROID_DISABLE_ACCESSIBILITY | Désactive l'accessibilité. Cela empêche le traitement des événements d'accessibilité. |
Variables moins couramment utilisées
| Variable | Description de la variable |
|---|---|
| QT_ANDROID_FONT_LOCATION | Définit un chemin personnalisé pour les polices du système. |
| QT_ANDROID_MAX_ASSETS_CACHE_SIZE | Taille du cache pour les actifs dans le dossier assets. |
| QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUND | Voir Mise en cache des glyphes de texte |
| QT_ANDROID_RASTER_IMAGE_DEPTH | |
| QT_ANDROID_MINIMUM_MOUSE_DOUBLE_CLICK_DISTANCE | |
| QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE | Lorsqu'une application Android est en pause ou inactive, elle peut continuer à recevoir des mises à jour de l'interface utilisateur à partir de composants tels qu'un BroadcastReceiver ou un Service. Ces mises à jour sont mises en file d'attente jusqu'à ce que l'application reprenne. La file d'attente peut croître indéfiniment, ce qui entraîne une utilisation supplémentaire de la mémoire et une latence lors du traitement de ces mises à jour une fois que l'application est à nouveau active. Cette variable d'environnement résout ce problème en introduisant une limite de taille pour la file d'attente. Lorsque la limite spécifiée est atteinte, l'entrée la plus ancienne est supprimée pour ajouter l'entrée la plus récente, ce qui permet d'éviter une croissance non liée. Par défaut, la file d'attente n'est pas liée et cette variable d'environnement n'est pas définie. En outre, si elle est définie à un nombre négatif, la file d'attente reste non liée. Par exemple, QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE=100 limite la file d'attente à 100 actions. |
Remarque : bien que liées, ces commandes ne sont pas les mêmes que les commandes ou variables CMake utilisées par Qt For Android, voir Configuration CMake de Qt for 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.
