En esta página

qmlprofiler

qmlprofiler recupera datos de seguimiento de QML de una aplicación. Los datos recopilados se pueden visualizar posteriormente en Qt Creator.

Para que qmlprofiler pueda perfilar una aplicación, asegúrate de compilarla con la infraestructura de depuración de QML activada.

Consulta la QML Profiler para obtener más información.

Uso
qmlprofiler [opciones] ejecutable [parámetros...]

opciones

OpciónDescripción
-a, --attach <hostname>Conectarse a una aplicación que ya se esté ejecutando en <nombre de host>, en lugar de iniciarla localmente.
-p, --port <port>Conectarse al puerto TCP <puerto>. El valor predeterminado es 3768.
-o, --output <file>Guardar los datos de seguimiento en <archivo>. Por defecto, los datos se envían a la salida estándar.
--record <on|off>Si se establece en «off», no se inicia inmediatamente la grabación de datos al arrancar el motor QML, sino que la grabación se inicia de forma interactiva o mediante la función JavaScript console.profile(). Por defecto, la grabación se inicia inmediatamente.
--include <feature,...>Lista separada por comas de las características que se van a registrar. Por defecto, se registran todas las características compatibles con el motor QML. Si se especifica --include, solo se registrarán las características indicadas. qmlprofiler reconoce las siguientes características: javascript, memory, pixmapcache, scenegraph, animations, painting, compiling, creating, binding, handlingsignal, inputevents, debugmessages, quick3d.
--exclude <feature,...>Lista separada por comas de las características que se deben excluir durante la grabación. Por defecto, se graban todas las características compatibles con el motor QML. Consulte --include para conocer las características que reconoce qmlprofiler.
--interactiveControla manualmente la grabación desde la línea de comandos. En este caso, el perfilador no se cerrará automáticamente cuando lo haga la aplicación. Están disponibles los siguientes comandos:
  • 'r', 'record'

    Activar o desactivar la grabación.

  • 'o [file]', 'output [file]'

    Enviar los datos de perfilado a <file>. Si no se especifica el parámetro <file>, se enviarán a la dirección indicada con --output o a la salida estándar.

  • 'c', 'clear'

    Borrar de la memoria los datos de perfilado registrados hasta el momento.

  • 'f [file]', 'flush [file]'

    Detiene la grabación si está en marcha, a continuación muestra los datos y, por último, los borra de la memoria.

  • 'q', 'quit'

    Cierra el proceso de destino si se ha iniciado desde qmlprofiler, y también el propio qmlprofiler.

--verboseMuestra la salida de depuración.
-h, --helpMuestra la ayuda sobre las opciones de la línea de comandos.
--help-allMuestra la ayuda, incluidas las opciones genéricas de Qt.
-v, --versionMuestra información sobre la versión.

Argumentos

ArgumentoDescripción
ejecutableLa ruta del archivo ejecutable que carga un documento QML.
parámetrosArgumentos del ejecutable

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