En esta página

QTP0005

Permitir que las palabras clave de dependencia de « qt_add_qml_module() » acepten objetivos de CMake.

Esta política se introdujo en Qt 6.8. Permite pasar objetivos de CMake a qt_add_qml_module() mediante las palabras clave DEPENDENCIES, IMPORTS, OPTIONAL_IMPORTS y DEFAULT_IMPORTS.

Al habilitar esta política, los argumentos pasados a dichas palabras clave pueden ir precedidos del prefijo TARGET, tras lo cual se tratan como un nombre de objetivo de CMake. El URI del módulo QML y la ruta de importación se derivan automáticamente del objetivo.

El comportamiento de « OLD » de esta política consiste en que la secuencia de tokens « TARGET name » se trata como dos URI independientes: « TARGET » y « name ».

El comportamiento « NEW » de esta política es que TARGET es una palabra clave. La URI se extrae del destino del módulo QML que le sigue. Se produce un error grave si el nombre que sigue a TARGET no hace referencia a un destino existente, o si dicho destino no corresponde a un módulo QML.

Tanto en el comportamiento de NEW como en el de OLD, es posible especificar una versión del módulo añadiendo una barra y la versión. Consulta «Declaración de dependencias de módulos » para obtener más detalles.

Antecedentes

Antes de esta política, las dependencias de los módulos QML debían declararse mediante su URI de cadena, por ejemplo, QtQuick o com.example.mymodule. Esto significaba que la URI y, cuando fuera necesario, la ruta de importación de la dependencia debían mantenerse coherentes con el objetivo de CMake que proporciona el módulo.

Con el comportamiento de NEW, en su lugar puedes hacer referencia a una dependencia mediante el nombre de su objetivo CMake. A continuación, el sistema de compilación determina automáticamente el URI y la ruta de importación correctos a partir del objetivo. Esto elimina la necesidad de especificar manualmente entradas IMPORT_PATH para las dependencias que se encuentran fuera de la ruta de importación predeterminada de QML, reduce la redundancia y elimina un tipo de errores derivados del «copiar y pegar».

Ejemplo

Consideremos un módulo que depende de otro módulo definido en el mismo proyecto. Con el comportamiento « OLD » (o antes de Qt 6.8), el URI debe indicarse explícitamente:

qt_add_qml_module(my_module
    URI MyModule
    VERSION 1.0
    DEPENDENCIES
        OtherModule
)

Con el comportamiento « NEW » (política QTP0005 configurada en « NEW »), puedes hacer referencia a la dependencia mediante el nombre de su objetivo CMake:

qt_policy(SET QTP0005 NEW)

qt_add_qml_module(other_module
    URI OtherModule
    VERSION 1.0
)

qt_add_qml_module(my_module
    URI MyModule
    VERSION 1.0
    DEPENDENCIES
        TARGET other_module
)

La misma sintaxis de « TARGET » está disponible para « IMPORTS », « OPTIONAL_IMPORTS » y « DEFAULT_IMPORTS ».

Cuando el objetivo del módulo es un ejecutable y se utilizan dependencias de tipo « TARGET », qt_add_qml_module() genera automáticamente un archivo « qt.conf » junto al ejecutable en el directorio de compilación. Este archivo configura la ruta de importación de QML para que los módulos QML especificados como dependencias de tipo « TARGET » puedan encontrarse en tiempo de ejecución. Utiliza « NO_GENERATE_QTCONF » para suprimir este comportamiento.

Como se muestra arriba, puede establecer la política explícitamente con ` qt_policy(SET QTP0005 NEW) ` antes de llamar a ` qt_add_qml_module()`. Como alternativa, llame a `qt_standard_project_setup()` con una versión de ` REQUIRES ` 6.8 o posterior para habilitar todas las políticas hasta esa versión.

TARGET DEPENDENCIES IMPORTS OPTIONAL_IMPORTS DEFAULT_IMPORTS OLDUtilice el comando «qt_policy()» para suprimir la advertencia estableciendo explícitamente la política en « OLD » o « NEW ».

Nota: El comportamiento « OLD » de una política está en desuso y podría eliminarse en el futuro.

Véase también qt_policy(), qt_standard_project_setup(), qt_cmake_policies y 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.