Módulos heredados
Los módulos heredados son aquellos cuyo archivo de especificación qmldir no contiene una directiva de identificador de módulo. Un módulo heredado puede instalarse en la ruta de importación de QML (como módulo heredado instalado) o importarse por parte de los clientes mediante una importación relativa (como módulo heredado localizado). Se recomienda a los clientes que eviten utilizar módulos heredados siempre que sea posible. Los desarrolladores de módulos deben asegurarse de crear módulos identificados y no módulos heredados.
Módulos heredados instalados
El motor de QML asigna automáticamente un identificador a un módulo instalado no identificado. Este identificador definido implícitamente es igual a la ruta de instalación del módulo (relativa a la ruta de importación de QML), en la que los caracteres separadores de directorios se sustituyen por puntos.
Un módulo no identificado que se instala en la ruta de importación de QML tiene la siguiente semántica:
- los clientes pueden importarlo mediante el identificador implícito del módulo
- los clientes deben especificar una versión al importar el módulo
- los nombres de tipos que entran en conflicto son resueltos de forma arbitraria por el motor QML, y no se garantiza que la forma de resolver los conflictos sea la misma entre diferentes versiones de QML
- otros módulos heredados pueden modificar o anular las definiciones de tipos proporcionadas por el módulo heredado instalado
Módulos heredados localizados
Un módulo no identificado que se importa mediante una instrucción de importación con una ruta de directorio relativa es cargado por el motor como un módulo heredado localizado. A los módulos heredados localizados se les aplica la siguiente semántica:
- pueden ser importados por los clientes mediante una ruta de importación relativa
- no es obligatorio que los clientes especifiquen una versión al importar el módulo
- si el cliente no proporciona ninguna versión de importación en la instrucción de importación, el motor QML no ofrece ninguna garantía sobre qué versión de la definición de un nombre de tipo determinado se importará
- los nombres de tipos que entran en conflicto son resueltos de forma arbitraria por el motor QML, y no se garantiza que la forma en que se resuelven los conflictos sea la misma entre diferentes versiones de QML
- otros módulos heredados pueden modificar o anular las definiciones de tipos proporcionadas por el módulo heredado localizado
Un módulo heredado localizado puede residir en el sistema de archivos local o en la red, y se puede hacer referencia a él mediante una URL que especifique la ruta del sistema de archivos o la URL de red.
Véase también Modernización de módulos QML y Portar módulos QML a CMake.
© 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.