Variables d'environnement 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 |
|---|---|
| QT_ANDROID_NO_EXIT_CALL | Dans certains cas, une application Android peut ne pas être en mesure de nettoyer en toute sécurité tous les threads lors de l'appel à ` exit() `, ce qui peut entraîner un plantage. Cela s'explique par la présence de threads C++ en cours d'exécution : les détruire sans les joindre provoque la fermeture de l'application. Ces threads ne peuvent pas être joints, car il est impossible de savoir s'ils sont en cours d'exécution. Cet indicateur évite d'appeler ` exit() ` et laisse le système Android gérer cela, au prix de ne pas tenter d'exécuter les destructeurs globaux. |
| QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_PREDICTIVE_TEXT | Permet de masquer les suggestions de texte prédictif, principalement dans les champs de mot de passe. Certains appareils ne gèrent pas correctement cette fonctionnalité. Pour plus d’informations, consultez la section Texte prédictif. |
| QT_ANDROID_ENABLE_RIGHT_MOUSE_FROM_LONG_PRESS | Interprète un appui prolongé comme un clic droit de la souris. |
| QT_ANDROID_DISABLE_ACCESSIBILITY | Désactive l'accessibilité. Cela empêche le traitement des événements d'accessibilité. |
| QT_ANDROID_NO_FULLSCREEN_KEYBOARD | Empêche Android d'afficher le clavier IME en plein écran. Remarque : cette variable n'est valide que pour Qt 6.8.8, 6.11.1, 6.12 ou une version plus récente. Pour Qt 6.12 et les versions plus récentes, il est recommandé d'utiliser plutôt Qt::ImhNoFullscreen. |
Variables moins couramment utilisées
| Variable | Description |
|---|---|
| QT_ANDROID_FONT_LOCATION | Définit un chemin d'accès personnalisé pour les polices système. |
| QT_ANDROID_MAX_ASSETS_CACHE_SIZE | Taille du cache pour les ressources situées 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 mise en pause ou inactive, elle peut continuer à recevoir des mises à jour de l'interface utilisateur provenant de composants tels qu'un BroadcastReceiver ou un Service. Ces mises à jour sont mises en file d'attente jusqu'à ce que l'application reprenne son activité. La file d'attente peut s'allonger indéfiniment, ce qui entraîne une consommation de mémoire supplémentaire 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 imposant une limite de taille à la file d’attente. Une fois la limite spécifiée atteinte, l’entrée la plus ancienne est supprimée pour permettre l’ajout de la plus récente, empêchant ainsi une croissance illimitée. Par défaut, la file d’attente est illimitée et cette variable d’environnement n’est pas définie. De plus, si elle est définie sur un nombre négatif, la file d’attente reste illimitée. Par exemple, QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE=100 limite la file d’attente à 100 actions. |
Remarque : bien qu’ elles soient liées, ces commandes et variables ne sont pas identiques à celles utilisées par Qt pour Android ; voir Configuration CMake de Qt pour 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.
