Umgebungsvariablen für Qt auf Android
Workarounds aktivieren oder deaktivieren
Qt für Android verwendet einige Umgebungsvariablen, um bestimmte Workarounds zu aktivieren bzw. zu deaktivieren:
Häufig verwendete Variablen
| Variable | Beschreibung |
|---|---|
| QT_ANDROID_NO_EXIT_CALL | In manchen Fällen kann eine Android-App möglicherweise nicht alle Threads sicher bereinigen, während „ exit() “ aufgerufen wird, was zu einem Absturz führen kann. Dies liegt daran, dass C++-Threads ausgeführt werden und deren Beendigung ohne vorheriges Abwarten zum Beenden der Anwendung führt. Diese Threads können nicht abgewartet werden, da nicht festgestellt werden kann, ob sie noch laufen. Dieses Flag verhindert den Aufruf von ` exit() ` und überlässt die Behandlung dieses Problems dem Android-System – allerdings auf Kosten des Verzichts auf die Ausführung globaler Destruktoren. |
| QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_PREDICTIVE_TEXT | Ermöglicht das Ausblenden von Textvorschlägen, vor allem in Passwortfeldern. Bestimmte Geräte verarbeiten dies nicht korrekt. Weitere Informationen finden Sie unter „Textvorschläge“. |
| QT_ANDROID_ENABLE_RIGHT_MOUSE_FROM_LONG_PRESS | Interpretiert einen langen Fingerdruck als Rechtsklick-Ereignis. |
| QT_ANDROID_DISABLE_ACCESSIBILITY | Deaktiviert die Barrierefreiheit. Dadurch wird die Verarbeitung von Barrierefreiheitsereignissen verhindert. |
| QT_ANDROID_NO_FULLSCREEN_KEYBOARD | Verhindert, dass Android eine Vollbild-IME anzeigt. Hinweis: Diese Variable gilt nur für Qt 6.8.8, 6.11.1, 6.12 oder neuer. Für Qt 6.12 und neuer wird empfohlen, stattdessen „ Qt::ImhNoFullscreen “ zu verwenden. |
Weniger häufig verwendete Variablen
| Variable | Beschreibung |
|---|---|
| QT_ANDROID_FONT_LOCATION | Legt einen benutzerdefinierten Pfad für Systemschriftarten fest. |
| QT_ANDROID_MAX_ASSETS_CACHE_SIZE | Cache-Größe für Assets im Ordner „assets“. |
| QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUND | Siehe Text-Glyphen-Caching |
| QT_ANDROID_RASTER_IMAGE_DEPTH | |
| QT_ANDROID_MINIMUM_MOUSE_DOUBLE_CLICK_DISTANCE | |
| QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE | Wenn eine Android-App angehalten oder inaktiv ist, empfängt sie möglicherweise weiterhin UI-Aktualisierungen von Komponenten wie einem BroadcastReceiver oder einem Service. Diese Aktualisierungen werden in einer Warteschlange gespeichert, bis die App wieder aktiv wird. Die Warteschlange kann unbegrenzt anwachsen, was zu zusätzlichem Speicherverbrauch und Latenz bei der Verarbeitung dieser Aktualisierungen führt, sobald die App wieder aktiv ist. Diese Umgebungsvariable behebt dieses Problem, indem sie eine Größenbeschränkung für die Warteschlange einführt. Sobald das festgelegte Limit erreicht ist, wird der älteste Eintrag verworfen, um den neuesten Eintrag hinzuzufügen, wodurch ein unbegrenztes Wachstum verhindert wird. Standardmäßig ist die Warteschlange unbegrenzt und diese Umgebungsvariable ist nicht gesetzt. Wenn sie auf eine beliebige negative Zahl gesetzt wird, bleibt die Warteschlange ebenfalls unbegrenzt. Beispielsweise begrenzt `QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE=100` die Warteschlange auf 100 Aktionen. |
Hinweis: Obwohl sie damit zusammenhängen, sind diese nicht mit den CMake-Befehlen oder -Variablen identisch, die von Qt for Android verwendet werden; siehe „Qt for Android CMake-Konfiguration“
© 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.
