Advertencias ocurridas durante la importación

Esta categoría de advertencia se escribe [import] por qmllint.

Fallo al importar módulo

¿Qué ha ocurrido?

No se ha encontrado el módulo importado mediante la sentencia import.

Esto puede ser causado, por ejemplo, por

• un error tipográfico en la sentencia import, o
• un módulo definido por el usuario que no se ha creado, o
• una ruta de importación incorrecta, o
• un módulo que falta

¿Por qué es malo?

La aplicación no puede ejecutarse porque no puede encontrar un módulo del que depende.

Ejemplos

Error tipográfico en la sentencia Import

import QtQuicky // not ok: typo in module name

Item {
}

Para corregir esta advertencia, corrija el error:

import QtQuick // ok: no typo in module name

Item {
}

Módulo definido por el usuario que no fue construido

Algunas herramientas como QML Language Server o qmllint no pueden encontrar módulos definidos por el usuario cuando no están construidos. Si su proyecto define el módulo QML que está intentando importar, las herramientas QML no lo encontrarán hasta que lo construya.

Ruta de importación incorrecta

Consulte la documentación sobre rutas de importación de QML y la documentación sobre importación de módulos de depuración para obtener más información sobre rutas de importación.

Falta un módulo

Si las secciones anteriores no han ayudado a encontrar el módulo importado, es posible que falte. Esto puede deberse a la falta de una dependencia. Cuando utilice bibliotecas externas, compruebe que están realmente instaladas y que sus módulos terminan en una ruta de importación.

No se ha encontrado el componente

¿Qué ha ocurrido?

No se ha encontrado algún componente.

¿Por qué es malo?

La aplicación no puede ejecutarse porque no puede instanciar el componente no encontrado.

Ejemplos

Error tipográfico en el nombre del componente

import QtQuick

Item {
    Itemy {} // not ok: typo in name
}

Para solucionar este problema, corrija la errata:

import QtQuick

Item {
    Item {} // ok: no typo in name
}

Falta la sentencia import

Item { // not ok: must be imported from QtQuick first
}

Para corregir esta advertencia, añada la importación del módulo que falta:

import QtQuick

Item { // ok: was imported from QtQuick
}

El calificador de importación debe empezar por mayúscula

¿Qué ha ocurrido?

Algún módulo importado tiene un calificador inválido.

¿Por qué es malo?

El módulo importado con este calificador inválido no puede ser utilizado.

Ejemplos

import QtQuick as qq

qq.Item {
}

Para corregir esta advertencia, haga que el calificador de importación comience con una letra mayúscula:

import QtQuick as Qq

Qq.Item {
}

Sintaxis de importación desconocida

¿Qué ha ocurrido?

Una sentencia import está utilizando una sintaxis de importación no válida.

¿Por qué es malo?

La aplicación no puede ejecutarse porque no puede importar un módulo del que depende.

Ejemplos

import "¯\(ツ)/¯:/path/to/Module"
import QtQuick

Item {
}

Para corregir esta advertencia, utilice URLs que tengan un esquema permitido:

import "qrc:/path/to/Module"
import QtQuick

Item {
}