qmlprofiler

Der „ qmlprofiler “ ruft QML-Tracing-Daten aus einer Anwendung ab. Die gesammelten Daten können anschließend in „ Qt Creator “ visualisiert werden.

Damit der „ qmlprofiler “ eine Anwendung profilieren kann, stellen Sie sicher, dass die Anwendung mit aktivierter QML-Debugging-Infrastruktur kompiliert wurde.

Weitere Informationen finden Sie QML Profiler , um mehr zu erfahren.

Verwendung
qmlprofiler [Optionen] ausführbare Datei [Parameter...]

Optionen

Option	Beschreibung
`-a, --attach <hostname>`	An eine bereits auf <hostname> laufende Anwendung anbinden, anstatt sie lokal zu starten.
`-p, --port <port>`	Stellt eine Verbindung zum TCP-Port <port> her. Der Standardwert ist 3768.
`-o, --output <file>`	Speichert die Trace-Daten in <file>. Standardmäßig werden die Daten an die Standardausgabe gesendet.
`--record <on\|off>`	Wenn auf „off“ gesetzt, wird die Datenaufzeichnung nicht sofort beim Start der QML-Engine begonnen, sondern entweder interaktiv oder mit der JavaScript-Funktion ` `console.profile()` ` gestartet. Standardmäßig beginnt die Aufzeichnung sofort.
`--include <feature,...>`	Durch Kommas getrennte Liste der zu erfassenden Funktionen. Standardmäßig werden alle von der QML-Engine unterstützten Funktionen erfasst. Wenn „ `--include` “ angegeben ist, werden nur die angegebenen Funktionen erfasst. Die folgenden Funktionen werden von „qmlprofiler“ erkannt: „ `javascript` “, „ `memory` “, „ `pixmapcache` “, „ `scenegraph` “, „ `animations` “, „ `painting` “, „ `compiling` “, „ `creating` “, „ `binding` “, „ `handlingsignal` “, „ `inputevents` “, „ `debugmessages` “, „ `quick3d` “.
`--exclude <feature,...>`	Durch Kommas getrennte Liste der Funktionen, die bei der Aufzeichnung ausgeschlossen werden sollen. Standardmäßig werden alle von der QML-Engine unterstützten Funktionen aufgezeichnet. Unter `--include` finden Sie eine Übersicht über die von qmlprofiler unterstützten Funktionen.
`--interactive`	Manuelle Steuerung der Aufzeichnung über die Befehlszeile. In diesem Fall beendet sich der Profiler nicht automatisch, wenn die Anwendung beendet wird. Folgende Befehle stehen zur Verfügung: `'r', 'record'` Aufzeichnung ein- oder ausschalten. `'o [file]', 'output [file]'` Profiling-Daten an `<file>` ausgeben. Wenn kein Parameter „ `<file>` “ angegeben ist, erfolgt die Ausgabe an die mit „ `--output` “ angegebene Adresse oder an die Standardausgabe. `'c', 'clear'` Bisher aufgezeichnete Profiling-Daten aus dem Speicher löschen. `'f [file]', 'flush [file]'` Beendet die Aufzeichnung, falls diese läuft, gibt anschließend die Daten aus und löscht sie schließlich aus dem Speicher. `'q', 'quit'` Beenden Sie den Zielprozess, falls dieser über den qmlprofiler gestartet wurde, sowie den qmlprofiler selbst.
`--verbose`	Debugging-Ausgabe anzeigen.
`-h, --help`	Zeigt eine Hilfe zu den Befehlszeilenoptionen an.
`--help-all`	Zeigt eine Hilfe an, einschließlich allgemeiner Qt-Optionen.
`-v, --version`	Zeigt Versionsinformationen an.

Argumente

Argument	Beschreibung
ausführbare Datei	Der Pfad zur ausführbaren Datei, die ein QML-Dokument lädt.
Parameter	Argumente der ausführbaren Datei

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