Qt for Android の環境変数

回避策の有効化・無効化

Qt for Android では、いくつかの環境変数を使用して、特定の回避策を有効/無効にします:

よく使われる変数

変数説明
qt_android_no_exit_call場合によっては、Android アプリがexit() を呼び出している間にすべてのスレッドを安全にクリーンアップできず、クラッシュすることがあります。これは、実行中のC++スレッドがあり、それらを結合せずに破棄するとアプリケーションが終了するためです。これらのスレッドは、実行中かどうかを知ることができないため、参加させることができない。このフラグは、exit() の呼び出しを回避し、Androidシステムにこの処理を任せます。その代償として、グローバル・デストラクタを実行しようとしません。
qt_android_enable_workaround_to_disable_predictive_text主にパスワードフィールドの予測入力候補を非表示にできるようにします。一部のデバイスでは、この機能が正しく処理されません。詳しくはPredictive Text を参照してください。
qt_android_enable_right_mouse_from_long_pressタッチの長押しをマウスの右クリックイベントとして解釈します。
qt_android_disable_accessibilityアクセシビリティを無効にします。アクセシビリティイベントを処理しないようにします。

あまり使われない変数

変数説明
qt_android_font_locationシステムフォントのカスタムパスを設定します。
qt_android_max_assets_cache_sizeassets フォルダ下のアセットのキャッシュサイズ。
qt_android_disable_glyph_cache_workaroundテキストグリフキャッシュを参照。
qt_android_raster_image_depth
qt_android_minimum_mouse_double_click_distance
qt_android_background_actions_queue_sizeAndroidアプリが一時停止中または非アクティブのとき、BroadcastReceiverやServiceなどのコンポーネントからUIの更新を受信し続けることがあります。これらの更新は、アプリが再開するまでキューに入れられます。キューは無限に増える可能性があり、アプリが再びアクティブになると、これらの更新を処理するときに余分なメモリ使用量と待ち時間が発生します。この環境変数は、キューのサイズ制限を導入することで、この問題に対処する。指定された上限に達すると、最も古いエントリが破棄されて最新のエントリが追加され、その結果、キューが無制限に大きくなるのを防ぐことができます。デフォルトでは、キューはバインドされておらず、この環境変数は設定されていません。さらに、任意の負の数を設定した場合、キューは束縛されないままとなります。

例えば、QT_ANDROID_BACKGROUND_ACTIONS_QUEUE_SIZE=100は、キューを100アクションに制限します。

注意: これらは関連していますが、QtFor Android で使用される 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.