QML ディスクキャッシュ

qt_add_qml_module を使ってQML モジュールを定義する必要があります。このモジュールは、Qt Quick Compilerが QML と JavaScript ファイルを先に処理するようにします。また、実行時に最適なパフォーマンスが保証されます。Qt Quick Compilerは各関数とバインディングのバイトコードを生成します。このバイトコードは QML インタープリタや QML エンジンの JIT コンパイラで利用することができます。さらに、Qt Quick Compilerは適切な関数やバインディングのネイティブコードを生成します。ネイティブコードは直接実行できるため、バイトコードの解釈やジャストインタイムコンパイルよりもパフォーマンスが向上します。その後、バイトコードとネイティブコードの両方がバイナリにコンパイルされます。

qmake を使用する際、CONFIG += qtquickcompiler を指定することで、プロジェクトにリソースとして追加された QML や JavaScript ファイルを同様に扱うことができます。Qt Creatorには、qmake のコマンドラインにCONFIG += qtquickcompiler を渡す設定があります。デフォルトでは、リリースビルドとプロファイルビルドで有効になっています。qmake はCMake ほど多くの情報をQt Quick Compilerに渡すことができません。そのため、コンパイル時に含まれるネイティブコードは少なくなります。

QMLドキュメントは、可能な限りリソースファイルシステムから読み込むようにしてください。そうしないと、QMLエンジンは先にコンパイルされたコードを見つけることができません。

QML文書の実行時にバイトコードもネイティブコードも見つからない場合、あるいは見つかったが使用できない場合、QMLエンジンはその場で文書をバイトコード表現にコンパイルします。このコンパイル処理には時間がかかり、その結果、バイトコードのみが生成されます。同じドキュメントを続けてロードすると、同じバイトコードが出力されます。QMLエンジンはコンパイルの結果をキャッシュすることで、このステップを最適化することができます。バイトコードをキャッシュファイルに保存し、同じQML文書が再度要求されたときに再コンパイルする代わりにキャッシュファイルをロードします。通常、キャッシュファイルはシステムのキャッシュディレクトリQStandardPaths::CacheLocation のサブディレクトリqmlcache に保存されます。

キャッシュファイルや先にコンパイルされたコードは、以下の条件がすべて満たされた場合にのみ読み込まれるようにチェックが行われます：

• Qt のバージョンが変更されていない。
• 元のファイルのソースコードが変更されていない。
• QMLデバッガが起動していない

QML_FORCE_DISK_CACHE 変数（後述）のみが QML デバッガに関する条件のみを上書きします。他の環境変数はこれらの条件に影響を与えません。

先にコンパイルされたコードとキャッシュに関する動作を微調整する主な方法は、環境変数QML_DISK_CACHE を使うことです。この変数はカンマで区切られたオプションのリストを取ります：

QML_DISK_CACHE=aot,qmlc-read

使用可能なオプションは以下のとおりです：

さらに、以下の環境変数を使うことができます：