Notes sur la plateforme Android

Cette page contient des informations spécifiques à la création et à l'exécution d'applications Qt sur Android. Voir Versions d'Android prises en charge pour connaître les versions d'Android et les niveaux d'API pris en charge.

Considérations spéciales concernant les plugins et les importations

Si une application utilise des plugins qui dépendent d'autres modules, ces modules doivent être listés dans les dépendances de l'application. Pour plus d'informations, voir Détection des dépendances.

Qt GUI Dépendances

Étant donné que les applications Android incluent généralement des éléments d'interface graphique, le plugin Qt GUI pour Android est principalement conçu pour fournir une interface graphique, et met donc en œuvre les différentes abstractions QPA. Par conséquent, le déploiement d'une application Qt pour Android devrait impliquer une dépendance à l'égard de Qt GUI. De plus, il est intéressant de noter que Qt Creator ne supporte que les constructions et les déploiements Gradle, ce qui signifie que les exécutions en ligne de commande ou en shell ne sont pas supportées d'emblée.

Considérations spéciales sur OpenGL

Les appareils modernes supportent souvent OpenGL ES 3.0 ou 3.1 en plus de 2.0. Pour obtenir un contexte OpenGL approprié, définissez la version requise via QSurfaceFormat::setVersion().

Problèmes connus

Qt Creator Problèmes de débogage

Voir Qt Creator Debugging Issues on Android pour plus d'informations.

Texte prédictif

En raison d'un bogue sur certains appareils, lorsque vous désactivez le texte prédictif avec ImhNoPredictiveText, cette propriété est ignorée et le texte prédictif reste activé. Pour contourner ce problème, définissez la variable d'environnement QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_PREDICTIVE_TEXT sur 1. Cependant, cette variable d'environnement peut poser un problème avec d'autres claviers tels que Gboard. Si vous utilisez une langue comme le japonais, avec Gboard, seul un clavier QWERTY est affiché. Cette variable d'environnement est interrogée à chaque fois que le clavier est affiché, de sorte qu'il est possible d'activer ou de désactiver la solution de contournement, selon les besoins.

Mise en cache des glyphes de texte

En raison d'un bogue dans certains pilotes OpenGL, le mécanisme utilisé par Qt pour mettre en cache les glyphes de texte ne fonctionne pas comme prévu sur tous les appareils Android, ce qui fait que le texte apparaît brouillé. Pour remédier à ce problème, une solution de contournement a été mise en place, mais elle peut augmenter la consommation de mémoire et affecter les performances de rendu du texte. La solution de contournement est désormais utilisée par défaut sur tous les appareils.

Vous pouvez désactiver cette solution en donnant à la variable d'environnement QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUND la valeur 1 ou true. Cependant, vous ne devez le faire qu'après avoir vérifié que le texte s'affiche correctement sur tous les appareils ciblés.

Limitations

Certains modules ou outils Qt peuvent avoir des fonctionnalités qui ne sont pas prises en charge sur Android ou qui ont des limitations. Consultez la documentation d' un module spécifique pour connaître les éventuelles limitations de la plateforme.