Der QML-Festplatten-Cache

Sie sollten Ihre QML-Module mit qt_add_qml_module definieren, um sicherzustellen, dass der Qt Quick Compiler Ihre QML- und JavaScript-Dateien schon vor der Zeit verarbeitet. Außerdem garantiert dies eine optimale Leistung zur Laufzeit. Die Qt Quick Compiler generiert Bytecode für jede Funktion und Bindung. Dieser Bytecode kann vom QML-Interpreter und dem Just-in-Time-Compiler (JIT) in der QML-Engine verwendet werden. Darüber hinaus erzeugt der Qt Quick Compiler generiert nativen Code für geeignete Funktionen und Bindungen. Der native Code kann direkt ausgeführt werden, was zu einer besseren Leistung führt als das Interpretieren oder Just-in-Time-Kompilieren des Byte-Codes. Sowohl der Bytecode als auch der native Code werden dann in Ihre Binärdatei kompiliert.

Wenn Sie qmake verwenden, können Sie CONFIG += qtquickcompiler angeben, um QML- und JavaScript-Dateien, die als Ressourcen zu Ihrem Projekt hinzugefügt werden, ähnlich zu behandeln. Qt Creator hat eine Einstellung, die es erlaubt, CONFIG += qtquickcompiler an die qmake-Kommandozeile zu übergeben. Standardmäßig ist dies für Release- und Profil-Builds aktiviert. qmake kann nicht so viele Informationen an die Qt Quick Compiler wie CMake. Daher wird die Kompilierung weniger nativen Code enthalten.

Sie sollten darauf achten, dass Sie Ihre QML-Dokumente möglichst aus dem Ressource-Dateisystem laden. Andernfalls wird die QML-Engine nicht in der Lage sein, den zuvor kompilierten Code zu finden.

Wenn zur Laufzeit kein Bytecode oder nativer Code für ein QML-Dokument gefunden werden kann oder wenn der Code zwar gefunden wird, aber nicht verwendet werden kann, kompiliert die QML-Engine das Dokument im laufenden Betrieb in eine Bytecode-Darstellung. Der Kompilierungsprozess kann zeitaufwändig sein, und das Ergebnis enthält nur Bytecode. Nachfolgende Ladevorgänge desselben Dokuments werden denselben Bytecode ergeben. Die QML-Engine kann diesen Schritt optimieren, indem sie das Ergebnis der Kompilierung zwischenspeichert. Sie speichert den Bytecode in einer Cachedatei und lädt die Cachedatei später, wenn dasselbe QML-Dokument erneut angefordert wird, anstatt es neu zu kompilieren. Normalerweise werden die Cache-Dateien in einem Unterverzeichnis qmlcache des Cache-Verzeichnisses des Systems gespeichert, das mit QStandardPaths::CacheLocation bezeichnet ist.

Es gibt Überprüfungen, die sicherstellen, dass Cache-Dateien und im Voraus kompilierter Code nur geladen werden, wenn alle folgenden Bedingungen erfüllt sind:

• Die Qt-Version hat sich nicht geändert
• Der Quellcode in der Originaldatei hat sich nicht geändert
• Der QML-Debugger läuft nicht

Nur die Variable QML_FORCE_DISK_CACHE (siehe unten) setzt nur die Bedingung bezüglich des QML-Debuggers außer Kraft. Die anderen Umgebungsvariablen haben keinen Einfluss auf diese Bedingungen.

Die primäre Möglichkeit zur Feinabstimmung des Verhaltens in Bezug auf vorzeitig kompilierten Code und Zwischenspeicherung ist die Umgebungsvariable QML_DISK_CACHE. Diese Variable nimmt eine durch Komma getrennte Liste von Optionen auf, zum Beispiel:

QML_DISK_CACHE=aot,qmlc-read

Die verfügbaren Optionen sind wie folgt:

Außerdem können Sie die folgenden Umgebungsvariablen verwenden: