En esta página

Qt Qml Compilador

El módulo « Qt Qml » contiene la funcionalidad compartida que necesitan las herramientas de QML, como el compilador «Qt Quick » y «qmllint». También proporciona el marco « QQmlSA », que se puede utilizar para ampliar las capacidades de análisis integradas en las herramientas.

Uso del módulo

Para utilizar la API de C++ de un módulo de Qt es necesario enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete Qt6:

find_package(Qt6 REQUIRED COMPONENTS QmlCompiler)
target_link_libraries(mytarget PRIVATE Qt6::QmlCompiler)

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Compilación con qmake

Para configurar el módulo para la compilación con qmake, añade el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:

QT += QmlCompiler

Uso del marco QQmlSA

El módulo Qt Qml Compiler ofrece el marco QQmlSA, que proporciona herramientas para el análisis estático del código QML. Estas herramientas pueden ayudar a garantizar la validez sintáctica y advertir sobre los antipatrones de QML.

Para añadir análisis estático a un programa QML hay que escribir complementos. Estos ejecutarán una serie de pasadas de análisis sobre los elementos y propiedades del código QML. Las pasadas se pueden registrar en un PassManager, que las almacena y al que se puede llamar para analizar un elemento y sus hijos. Una pasada es una comprobación de una determinada regla o condición que se evalúa en elementos o propiedades. Si se cumple la condición, la pasada puede advertir al usuario de un problema identificado en el código y tal vez incluso sugerir una solución. Se denomina «pasada» porque el análisis realizado sobre los elementos y propiedades se lleva a cabo ejecutando sucesivamente una serie de pasadas sobre ellos. Cada «pass» debe encargarse de identificar únicamente un problema específico. La combinación de un conjunto de «passes» permite realizar análisis más complejos y, en conjunto, formar un complemento. Los «passes» de elementos se definen mediante dos componentes principales: shouldRun() y run(). Al realizar el análisis, el gestor de «passes» ejecutará el «pass» sobre cada elemento que encuentre al recorrer los elementos secundarios del elemento raíz. Para cada elemento, si la expresión shouldRun() evaluada en dicho elemento devuelve true, entonces se ejecuta en él la expresión run().

Las pasadas sobre propiedades se activan en tres eventos diferentes: cuando la propiedad se vincula, cuando se lee y cuando se escribe en ella. Estos se pueden implementar sobrescribiendo las funciones ` onBinding()`, ` onRead() ` y ` onWrite() `, respectivamente.

A medida que el código crece, también lo hace el número de elementos y propiedades. Realizar las pasadas de análisis estático en todos ellos puede resultar costoso. Por eso es recomendable ser preciso a la hora de decidir qué elementos y propiedades analizar. En el caso de los elementos, la función ` shouldRun() ` está pensada como una comprobación sencilla para determinar si debe ejecutarse ` run()`, que es la que realiza el cálculo real. En cuanto a las propiedades, la selección se realiza al registrar las pasadas con el gestor. La función registerPropertyPass() toma como argumentos las cadenas moduleName, typeName y propertyName. Estas se utilizan para filtrar el conjunto de propiedades afectadas por la pasada registrada.

Ejemplos

El tutorial de análisis estático de QML muestra cómo utilizar el marco QQmlSA para crear una pasada personalizada de qmllint.

Referencia

Licencias

Qt Qml El compilador está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General de GNU, versión 3, con la excepción Qt GPL 1.0. Consulta «Licencias de Qt» para obtener más detalles.

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