qmlprofiler

qmlprofiler récupère les données de traçage QML d’une application. Les données collectées peuvent ensuite être visualisées dans Qt Creator.

Pour permettre à qmlprofiler de profiler une application, veillez à compiler l'application en activant l'infrastructure de débogage QML.

Consultez la QML Profiler pour en savoir plus.

Utilisation
qmlprofiler [options] exécutable [paramètres...]

options

Option	Description
`-a, --attach <hostname>`	Se connecter à une application déjà en cours d'exécution sur <nom_d'hôte>, au lieu de la lancer localement.
`-p, --port <port>`	Se connecter au port TCP <port>. La valeur par défaut est 3768.
`-o, --output <file>`	Enregistrer les données de traçage dans <fichier>. Par défaut, les données sont envoyées vers la sortie standard.
`--record <on\|off>`	Si cette option est définie sur « off », ne démarrez pas immédiatement l'enregistrement des données au lancement du moteur QML, mais lancez plutôt l'enregistrement de manière interactive ou à l'aide de la fonction JavaScript ` `console.profile()` `. Par défaut, l'enregistrement démarre immédiatement.
`--include <feature,...>`	Liste, séparée par des virgules, des fonctionnalités à enregistrer. Par défaut, toutes les fonctionnalités prises en charge par le moteur QML sont enregistrées. Si `--include` est spécifié, seules les fonctionnalités indiquées seront enregistrées. Les fonctionnalités suivantes sont prises en charge par qmlprofiler : `javascript`, `memory`, `pixmapcache`, `scenegraph`, `animations`, `painting`, `compiling`, `creating`, `binding`, `handlingsignal`, `inputevents`, `debugmessages`, `quick3d`.
`--exclude <feature,...>`	Liste séparée par des virgules des fonctionnalités à exclure lors de l'enregistrement. Par défaut, toutes les fonctionnalités prises en charge par le moteur QML sont enregistrées. Consultez `--include` pour connaître les fonctionnalités prises en charge par qmlprofiler.
`--interactive`	Contrôlez manuellement l'enregistrement depuis la ligne de commande. Dans ce cas, le profileur ne se fermera pas automatiquement lorsque l'application s'arrêtera. Les commandes suivantes sont disponibles : `'r', 'record'` Activer ou désactiver l'enregistrement. `'o [file]', 'output [file]'` Envoyer les données de profilage vers `<file>`. Si aucun paramètre `<file>` n’est fourni, l’envoi s’effectue vers la destination indiquée avec `--output`, ou vers la sortie standard. `'c', 'clear'` Effacer de la mémoire les données de profilage enregistrées jusqu’à présent. `'f [file]', 'flush [file]'` Arrête l'enregistrement s'il est en cours, puis affiche les données, et enfin les efface de la mémoire. `'q', 'quit'` Termine le processus cible s’il a été lancé depuis qmlprofiler, ainsi que qmlprofiler lui-même.
`--verbose`	Affiche les informations de débogage.
`-h, --help`	Affiche l'aide sur les options de ligne de commande.
`--help-all`	Affiche l'aide, y compris les options génériques de Qt.
`-v, --version`	Affiche les informations de version.

Arguments

Argument	Description
exécutable	Chemin d'accès au fichier exécutable qui charge un document QML.
paramètres	Arguments de l'exécutable

© 2026 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.