Módulos heredados

Los módulos heredados son módulos 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 ser importado por los clientes con una importación relativa (como módulo heredado localizado). Se recomienda a los clientes que, en la medida de lo posible, eviten utilizar módulos heredados. Los desarrolladores de módulos deben asegurarse de crear módulos identificados y no módulos heredados.

Módulos heredados instalados

El motor 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 directorio se sustituyen por caracteres de punto.

Un módulo no identificado que se instala en la ruta de importación de QML tiene la siguiente semántica

• puede ser importado por los clientes a través del identificador de módulo implícito
• los clientes deben especificar una versión al importar el módulo
• el motor QML resuelve arbitrariamente los nombres de tipos en conflicto, y no se garantiza que la forma en que se resuelven los conflictos sea la misma entre distintas 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 sentencia import de ruta de directorio relativa es cargado por el motor como módulo heredado localizado. A los módulos heredados localizados se les aplica la siguiente semántica

• pueden ser importados por los clientes a través de 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 indica una versión de importación en la sentencia import, el motor QML no ofrece garantías sobre qué versión de la definición de un determinado nombre de tipo se importará
• el motor QML resuelve arbitrariamente los nombres de tipo en conflicto, y no se garantiza que la forma en que se resuelven los conflictos sea la misma entre distintas 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 la red.