안드로이드용 Qt 환경 변수

해결 방법 활성화 또는 비활성화하기

안드로이드용 Qt는 일부 환경 변수를 사용하여 특정 해결 방법을 활성화/비활성화합니다:

일반적으로 사용되는 변수

변수	설명
QT_ANDROID_NO_EXIT_CALL	경우에 따라 안드로이드 앱이 `exit()` 을 호출하는 동안 모든 스레드를 안전하게 정리하지 못해 충돌이 발생할 수 있습니다. 이는 실행 중인 C++ 스레드가 있고 이를 조인하지 않고 파괴하면 애플리케이션이 종료되기 때문입니다. 이러한 스레드는 실행 중인지 알 수 없으므로 조인할 수 없습니다. 이 플래그를 사용하면 `exit()` 호출을 피하고 안드로이드 시스템에서 이를 처리할 수 있지만, 전역 소멸자를 실행하지 않는 대가를 치릅니다.
QT_ANDROID_ENABLE_WORKAROUND_TO_DISABLE_Predictive_text	주로 비밀번호 필드에서 예측 텍스트 제안을 숨길 수 있습니다. 특정 디바이스에서는 이 기능이 제대로 처리되지 않습니다. 자세한 내용은 예측 텍스트를 참조하세요.
QT_ANDROID_ENABLE_RIGHT_MOUSE_From_LONG_PRESS	길게 누른 터치를 마우스 오른쪽 클릭 이벤트로 해석합니다.
QT_ANDROID_DISABLE_ACCESSIBILITY	접근성을 비활성화합니다. 접근성 이벤트 처리를 방지합니다.

덜 일반적으로 사용되는 변수

변수	설명
QT_ANDROID_FONT_LOCATION	시스템 글꼴의 사용자 정의 경로를 설정합니다.
QT_ANDROID_MAX_ASSETS_CACHE_SIZE	에셋 폴더에 있는 에셋의 캐시 크기.
QT_ANDROID_DISABLE_GLYPH_CACHE_WORKAROUND	텍스트 글리프 캐싱을 참조하십시오.
QT_ANDROID_RASTER_IMAGE_DEPTH
QT_ANDROID_최소_마우스_두번_클릭_거리
QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE	안드로이드 앱이 일시 중지되거나 비활성 상태일 때, 브로드캐스트 리시버 또는 서비스와 같은 컴포넌트로부터 UI 업데이트를 계속 수신할 수 있습니다. 이러한 업데이트는 앱이 다시 시작될 때까지 대기열에 대기합니다. 대기열이 무한정 늘어날 수 있으므로 앱이 다시 활성화되면 이러한 업데이트를 처리할 때 추가 메모리 사용량과 지연 시간이 발생할 수 있습니다. 이 환경 변수는 대기열에 크기 제한을 도입하여 이 문제를 해결합니다. 지정된 제한에 도달하면 가장 오래된 항목이 삭제되고 최신 항목이 추가되므로 무제한 증가를 방지할 수 있습니다. 기본적으로 큐는 바인딩되지 않으며 이 환경 변수는 설정되지 않습니다. 또한 음수로 설정하면 큐는 바인딩되지 않은 상태로 유지됩니다. 예를 들어 QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE=100은 대기열을 100개의 작업으로 제한합니다.

참고: 관련성이 있지만, 이는 안드로이드용 Qt에서 사용하는 CMake 명령이나 변수와 동일하지 않으므로, 안드로이드용 Qt CMake 구성을 참조하십시오.

명령줄에서 프로젝트 빌드하기 CMake 구성

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