Qt für Android Umgebungsvariablen

Aktivieren oder Deaktivieren von Workarounds

Qt for Android verwendet einige Umgebungsvariablen, um bestimmte Umgehungslösungen zu aktivieren/deaktivieren:

Häufig verwendete Variablen

VariableBeschreibung
QT_ANDROID_NO_EXIT_CALLIn manchen Fällen kann eine Android-Anwendung beim Aufruf von exit() nicht alle Threads sicher beenden und stürzt möglicherweise ab. Dies liegt daran, dass C++-Threads laufen und das Zerstören dieser Threads, ohne sie zu verbinden, eine Anwendung beendet. Diese Threads können nicht zusammengeführt werden, da es nicht möglich ist, zu wissen, ob sie noch laufen. Dieses Flag vermeidet den Aufruf von exit() und überlässt es dem Android-System, dies zu handhaben, allerdings auf Kosten des Versuchs, keine globalen Destruktoren auszuführen.
QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_PREDICTIVE_TEXTErmöglicht das Ausblenden von Vorhersagetextvorschlägen, hauptsächlich in Passwortfeldern. Bestimmte Geräte handhaben dies nicht richtig. Weitere Informationen finden Sie unter Prädiktiver Text.
QT_ANDROID_ENABLE_RIGHT_MOUSE_FROM_LONG_PRESSInterpretiert einen langen Tastendruck als einen rechten Mausklick.
QT_ANDROID_DISABLE_ACCESSIBILITYDeaktiviert Barrierefreiheit. Dies verhindert die Verarbeitung von Barrierefreiheitsereignissen.

Weniger häufig verwendete Variablen

VariableBeschreibung
QT_ANDROID_FONT_LOCATIONLegt einen benutzerdefinierten Pfad für Systemschriftarten fest.
QT_ANDROID_MAX_ASSETS_CACHE_SIZECache-Größe für Assets im Assets-Ordner.
QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUNDSiehe Text Glyphen Caching
QT_ANDROID_RASTER_IMAGE_DEPTH
QT_ANDROID_MINIMUM_MOUSE_DOUBLE_CLICK_DISTANCE
QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZEWenn eine Android-App pausiert oder inaktiv ist, kann sie weiterhin UI-Updates von Komponenten wie einem BroadcastReceiver oder Service erhalten. Diese Aktualisierungen werden in eine Warteschlange gestellt, bis die App fortgesetzt wird. Die Warteschlange kann ins Unendliche wachsen, was zu einer zusätzlichen Speichernutzung und Latenz bei der Verarbeitung dieser Aktualisierungen führt, sobald die App wieder aktiv ist. Diese Umgebungsvariable behebt dieses Problem, indem sie eine Größenbegrenzung für die Warteschlange einführt. Sobald die angegebene Grenze erreicht ist, wird der älteste Eintrag verworfen, um den neuesten Eintrag hinzuzufügen, wodurch ein ungebundenes Wachstum verhindert wird. Standardmäßig ist die Warteschlange ungebunden und diese Umgebungsvariable ist nicht gesetzt. Außerdem bleibt die Warteschlange ungebunden, wenn sie auf eine negative Zahl gesetzt wird.

Zum Beispiel begrenzt QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE=100 die Warteschlange auf 100 Aktionen.

Hinweis: Obwohl sie miteinander verwandt sind, entsprechen sie nicht den CMake-Befehlen oder -Variablen, die von Qt für Android verwendet werden, siehe Qt für Android CMake-Konfiguration

© 2025 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.