Android용 Qt 환경 변수
우회 방법 활성화 또는 비활성화
Android용 Qt는 특정 해결 방법을 활성화하거나 비활성화하기 위해 몇 가지 환경 변수를 사용합니다:
자주 사용되는 변수
| 변수 | 설명 |
|---|---|
| QT_ANDROID_NO_EXIT_CALL | 경우에 따라 Android 앱이 ` exit() `를 호출하는 동안 모든 스레드를 안전하게 정리하지 못해 앱이 강제 종료될 수 있습니다. 이는 C++ 스레드가 실행 중일 수 있으며, 이러한 스레드를 조인(join)하지 않고 강제로 종료하면 애플리케이션이 종료되기 때문입니다. 해당 스레드가 실행 중인지 여부를 알 수 없기 때문에 조인할 수 없습니다. 이 플래그를 사용하면 ` exit() ` 호출을 건너뛰고 Android 시스템이 이를 처리하도록 허용하지만, 그 대가로 전역 소멸자를 실행하지 않게 됩니다. |
| QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_PREDICTIVE_TEXT | 주로 비밀번호 입력란에서 예측 텍스트 제안 사항을 숨길 수 있게 합니다. 일부 기기에서는 이 기능이 제대로 처리되지 않습니다. 자세한 내용은 ‘예측 텍스트’를 참조하십시오. |
| QT_ANDROID_ENABLE_RIGHT_MOUSE_FROM_LONG_PRESS | 길게 터치하는 동작을 마우스 오른쪽 클릭 이벤트로 해석합니다. |
| QT_ANDROID_DISABLE_ACCESSIBILITY | 접근성 기능을 비활성화합니다. 이 설정은 접근성 이벤트 처리를 차단합니다. |
| QT_ANDROID_NO_FULLSCREEN_KEYBOARD | Android가 전체 화면 IME를 표시하지 못하도록 합니다. 참고: 이 변수는 Qt 6.8.8, 6.11.1, 6.12 또는 그 이후 버전에서만 유효합니다. Qt 6.12 및 그 이후 버전에서는 대신 ` Qt::ImhNoFullscreen `를 사용하는 것이 권장됩니다. |
덜 자주 사용되는 변수
| 변수 | 설명 |
|---|---|
| QT_ANDROID_FONT_LOCATION | 시스템 글꼴에 대한 사용자 지정 경로를 설정합니다. |
| QT_ANDROID_MAX_ASSETS_CACHE_SIZE | assets 폴더 내 자산의 캐시 크기입니다. |
| QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUND | '텍스트 글리프 캐싱' 참조 |
| QT_ANDROID_RASTER_IMAGE_DEPTH | |
| QT_ANDROID_MINIMUM_MOUSE_DOUBLE_CLICK_DISTANCE | |
| QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE | Android 앱이 일시 중지되거나 비활성 상태일 때, BroadcastReceiver나 Service와 같은 컴포넌트로부터 UI 업데이트를 계속 수신할 수 있습니다. 이러한 업데이트는 앱이 재개될 때까지 대기열에 쌓입니다. 대기열은 무한정 커질 수 있으며, 이로 인해 앱이 다시 활성화되었을 때 업데이트를 처리하는 과정에서 불필요한 메모리 사용량 증가와 지연 현상이 발생할 수 있습니다. 이 환경 변수는 큐의 크기 제한을 설정하여 이 문제를 해결합니다. 지정된 제한에 도달하면 가장 오래된 항목이 제거되고 가장 새로운 항목이 추가되므로, 큐가 무제한으로 커지는 것을 방지합니다. 기본적으로 큐는 무제한이며 이 환경 변수는 설정되어 있지 않습니다. 또한, 음수 값으로 설정하더라도 큐는 무제한으로 유지됩니다. 예를 들어, QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE=100으로 설정하면 큐의 크기가 100개의 작업으로 제한됩니다. |
참고: 관련은있지만 , 이는 Qt for Android에서 사용하는 CMake 명령어나 변수와는 다릅니다. Qt for Android CMake 구성을 참조하십시오.
© 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.
