Le cache disque QML

Vous devez définir vos modules QML en utilisant qt_add_qml_module, ce qui garantit que le compilateurQt Quick traite vos fichiers QML et JavaScript à l'avance. Cela garantit également des performances optimales au moment de l'exécution. Le compilateurQt Quick génère un code d'octets pour chaque fonction et chaque liaison. Ce code peut être utilisé par l'interprète QML et le compilateur Just-in-time (JIT) dans le moteur QML. En outre, le compilateurQt Quick génère du code natif pour les fonctions et les liaisons appropriées. Le code natif peut être exécuté directement, ce qui permet d'obtenir de meilleures performances que l'interprétation ou la compilation juste à temps du code byte. Le code byte et le code natif sont ensuite compilés dans votre binaire.

Lorsque vous utilisez qmake, vous pouvez spécifier CONFIG += qtquickcompiler pour donner un traitement similaire aux fichiers QML et JavaScript ajoutés en tant que ressources à votre projet. Qt Creator a un paramètre qui permet de passer CONFIG += qtquickcompiler à la ligne de commande de qmake. Par défaut, cette option est activée pour les versions release et profile. qmake ne peut pas transmettre autant d'informations au compilateurQt Quick que CMake. Par conséquent, la compilation contiendra moins de code natif.

Dans la mesure du possible, veillez à charger vos documents QML à partir du système de fichiers de ressources. Sinon, le moteur QML ne pourra pas trouver le code compilé à l'avance.

Si aucun code byte ou code natif ne peut être trouvé pour un document QML au moment de l'exécution, ou si le code est trouvé mais ne peut pas être utilisé, le moteur QML compile le document en une représentation de code byte à la volée. Le processus de compilation peut prendre du temps et le résultat ne contiendra que du code à octets. Les chargements ultérieurs du même document produiront le même code d'octets. Le moteur QML peut optimiser cette étape en mettant en cache le résultat de la compilation. Il stocke l'octet de code dans un fichier cache et charge ultérieurement le fichier cache au lieu de procéder à une nouvelle compilation lorsque le même document QML est redemandé. En général, les fichiers de cache sont stockés dans un sous-répertoire qmlcache du répertoire de cache du système, désigné par QStandardPaths::CacheLocation.

Des contrôles sont en place pour s'assurer que les fichiers de cache et tout code compilé à l'avance ne sont chargés que si toutes les conditions suivantes sont remplies :

• la version de Qt n'a pas changé
• Le code source du fichier original n'a pas changé.
• Le débogueur QML n'est pas en cours d'exécution

Seule la variable QML_FORCE_DISK_CACHE (voir ci-dessous) ne modifie que la condition relative au débogueur QML. Les autres variables d'environnement n'influencent pas ces conditions.

La variable d'environnement QML_DISK_CACHE est le principal moyen d'affiner le comportement concernant le code compilé à l'avance et la mise en cache. Cette variable prend une liste d'options séparées par des virgules, par exemple :

QML_DISK_CACHE=aot,qmlc-read

Les options disponibles sont les suivantes :

En outre, vous pouvez utiliser les variables d'environnement suivantes :