Compilador de scripts QML
El compilador de scripts QML compila funciones y expresiones de los archivos QML y JavaScript en un código byte que el motor QML puede interpretar o compilar «just-in-time».
Además, compila algunas funciones y expresiones de los archivos QML en código C++, dentro de las limitaciones impuestas por la naturaleza de JavaScript. Genera código C++ para aquellas funciones que pueden analizarse de forma exhaustiva. El siguiente diagrama de flujo explica el proceso de compilación.

El compilador de scripts QML está disponible en dos versiones. Una es qmlcachegen, que forma parte del compiladorQt Quick . La otra es qmlsc, que forma parte del complemento de uso exclusivamente comercial «Qt Quick Compiler Extensions».
qmlcachegen
qmlcachegen utiliza el sistema de metaobjetos, genera consultas y las almacena en un lugar central: una unidad de compilación. La unidad de compilación contiene una representación de la estructura del documento, una representación compacta en código byte para cada función y expresión, y código nativo para funciones y enlaces que el compilador comprende por completo. El código de bytes de una unidad de compilación puede ser utilizado por el motor QML para evitar la recompilación y acelerar la ejecución.
qmlsc
qmlsc, por su parte, amplía la funcionalidad básica de qmlcachegen al ofrecer dos modos adicionales.
modo estático
En el modo estático, qmlsc asume que ninguna propiedad de ningún tipo expuesta a C++ puede quedar enmascarada por tipos derivados. Elimina el mecanismo de comprobación de enmascaramiento y permite que se compile más código JavaScript a C++, lo que, en última instancia, genera un código más rápido.
Para habilitar el modo estático en qmlsc, debes pasar ` --static ` mediante ` QT_QMLCACHEGEN_ARGUMENTS ` a ` qt_add_qml_module`.
qt_add_qml_module(someTarget
...
)
set_target_properties(someTarget PROPERTIES
QT_QMLCACHEGEN_ARGUMENTS "--static"
)Advertencia: el modo estático deqmlsc genera código no válido si alguna propiedad queda enmascarada en el documento QML.
Modo directo
En el modo directo, qmlsc asume que todos los tipos de C++ utilizados en tu código QML están disponibles y pueden incluirse como encabezados de C++ en el código generado. De este modo, el código generado accede a las propiedades o las modifica llamando directamente a los getter, setter y funciones invocables de esos encabezados, lo que agiliza aún más la ejecución. Esto implica que debes vincularte a las API privadas de Qt en CMake.
Advertencia: Las APIprivadas de Qt cambian con frecuencia. Tendrás que recompilar Qt para cada nueva versión.
Advertencia: Si un tipo solo está definido en un complemento o no tiene encabezado, no podrás utilizarlo en modo directo.
Para habilitar el modo directo, debes tener en cuenta lo siguiente:
- debes pasar `
--direct-calls` a través de `QT_QMLCACHEGEN_ARGUMENTS` a ` qt_add_qml_module`.qt_add_qml_module(someTarget ... ) set_target_properties(someTarget PROPERTIES QT_QMLCACHEGEN_ARGUMENTS "--direct-calls" ) - Enlaza todos los módulos privados de Qt relevantes en lugar de sus equivalentes públicos.
find_package(Qt6 COMPONENTS QmlPrivate QuickPrivate) qt_add_qml_module(someTarget ... ) target_link_libraries(someTarget PRIVATE Qt::QmlPrivate Qt::QuickPrivate ... ) - No establezcas el «
PLUGIN_TARGET» para que sea el mismo que el objetivo de la biblioteca de soporte.# direct mode will not function in this setup. qt_add_qml_module(someTarget PLUGIN_TARGET someTarget ... )
Limitaciones al compilar JavaScript a C++
Muchas construcciones de JavaScript no pueden representarse de forma eficiente en C++. El compilador de scripts de QML omite la generación de código C++ para las funciones que contienen dichas construcciones y solo genera código de bytes para ser interpretado o ejecutado mediante el compilador «just-in-time». Las expresiones QML más comunes son bastante sencillas: consultas de valores en QObjects, operaciones aritméticas, construcciones simples «if/else» o de bucle. Estas se pueden expresar fácilmente en C++, y hacerlo hace que tu aplicación se ejecute más rápido.
Obtención de estadísticas sobre la compilación de funciones y enlaces
El compilador de scripts de QML registra estadísticas al compilar QML a C++. Estas pueden ofrecer información sobre la compilación de funciones y enlaces. Incluyen el tiempo que tardó la compilación, si se completó con éxito y, en caso contrario, qué error provocó el fallo. Además de mostrar estos resultados por enlace o función, las estadísticas también se resumen por archivo, por módulo y a nivel de proyecto. Esto puede ofrecer una visión general rápida del rendimiento de la compilación de un proyecto.
Para mostrar las estadísticas, ejecuta el objetivo de CMake «all_aotstats ».
La recopilación de estadísticas de compilación está habilitada por defecto. Para desactivarla, establece la variable de CMake QT_QML_GENERATE_AOTSTATS en OFF antes de la primera llamada a qt_add_qml_module.
Nota: Estas estadísticas solo están disponibles para los módulos registrados a través de la API de CMake ` qt_add_qml_module `
© 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.