QML ディスクキャッシュ

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

qmakeを使用する際、CONFIG += qtquickcompiler を指定することで、プロジェクトにリソースとして追加されたQMLファイルやJavaScriptファイルを同様に扱うことができます。 Qt Creatorqmake コマンドラインに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

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

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