Tipo no resuelto
qmllint denomina esta categoría de advertencia « [unresolved-type] ».
Esta categoría contiene las siguientes advertencias:
- Se utiliza un tipo, pero no está resuelto
- No se ha encontrado el tipo para el tipo de retorno del método
- No se ha encontrado el tipo para el tipo de parámetro del método
- La propiedad tiene un tipo incompleto; es posible que falte una importación
- No se ha encontrado el tipo de la propiedad; probablemente se deba a que falta una entrada de dependencia o a que el tipo no se ha expuesto de forma declarativa
- El tipo de la propiedad no se ha resuelto por completo; probablemente se deba a que falta una entrada de dependencia o a que un tipo no se ha expuesto de forma declarativa
- No se ha encontrado el tipo en el espacio de nombres
Estas advertencias suelen indicar que faltan importaciones o que hay módulos QML defectuosos, dependiendo de si estás utilizando o escribiendo un módulo QML.
Para los usuarios de módulos QML
¿Qué ha pasado?
Has utilizado un tipo que las herramientas de QML no han podido encontrar. Suele indicar un posible error tipográfico, una importación que falta o rutas de importación configuradas incorrectamente.
¿Por qué es un problema?
Las herramientas de QML no pueden encontrar el tipo y, muy probablemente, tampoco lo hará el motor de QML.
Ejemplos
Error tipográfico
import QtQuick
Itme { ... } // misspelling of ItemPara solucionar esta advertencia, corrige el error tipográfico:
import QtQuick
Item { ... }Falta la declaración de importación
Item { ... }Para solucionar esta advertencia, importa el módulo que expone Item:
import QtQuick
Item { ... }Si añadir la declaración de importación no soluciona el problema, revisa tus rutas de importación.
Si recibes esta advertencia a través de QML Language Server, es posible que tu configuración esté incompleta.
Para los autores de módulos QML
¿Qué ha pasado?
Las herramientas de QML no pueden encontrar un tipo en tu módulo QML. Puede tratarse de un tipo que expones a QML de forma directa o indirecta al utilizarlo como:
- Tipo base
- Tipo de propiedad
- Tipo de señal, ranura o parámetro de «
Q_INVOKABLE» Q_INVOKABLETipo de retorno
Es posible que falte un registro declarativo del tipo si el tipo no resuelto lo expone tu módulo.
De lo contrario, es posible que tu módulo QML tenga dependencias no declaradas con respecto al módulo QML que expone el tipo sin resolver.
¿Por qué es un problema?
Las herramientas de QML no funcionarán con tus tipos y los usuarios de tu módulo QML recibirán advertencias erróneas que no podrán solucionar.
Ejemplos
Falta el registro de tipos
Consulta «Definición de tipos QML desde C++» para saber cómo registrar tus tipos de forma declarativa. Asegúrate de que todos los tipos y enumeraciones expuestos directa e indirectamente a QML estén registrados.
Falta de dependencia del módulo QML
Supongamos que MyItem es un tipo de C++ en tu módulo QML:
class MyItem: public QQuickItem {
...
QML_ELEMENT
...
Q_PROPERTY(SomeType someProperty READ someProperty WRITE setSomeProperty NOTIFY somePropertyChanged)
...
}Las herramientas de QML no pueden resolver correctamente MyItem si no pueden resolver primero QQuickItem o SomeType. Si QQuickItem se encuentra en el módulo QML QtQuick y SomeType en SomeModule, entonces debes indicar estas dependencias de C++ en la definición del módulo QML.
Para ello, añade las dependencias a la definición del módulo QML. Esto se puede hacer con ` DEPENDENCIES`, por ejemplo:
qt_add_qml_module(
...
DEPENDENCIES
QtQuick # for QQuickItem to be resolved
SomeModule # for SomeType to be resolved
)Consulta la sección sobre cómo declarar dependencias de C++ entre módulos QML para obtener más información.
© 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.