Avertissements survenus lors de l'importation

Cette catégorie d'avertissement est orthographiée [import] par qmllint.

Échec de l'importation du module

Qu'est-ce qui s'est passé ?

Le module importé via l'instruction import n'a pas été trouvé.

Cela peut être dû, par exemple, à

• une faute de frappe dans la déclaration d'importation, ou
• un module défini par l'utilisateur qui n'a pas été construit, ou
• un mauvais chemin d'importation, ou
• un module manquant

Pourquoi est-ce mauvais ?

L'application ne peut pas fonctionner parce qu'elle ne trouve pas un module sur lequel elle s'appuie.

Exemples d'erreurs

Faute de frappe dans la déclaration d'importation

import QtQuicky // not ok: typo in module name

Item {
}

Pour corriger cet avertissement, corrigez la faute de frappe :

import QtQuick // ok: no typo in module name

Item {
}

Module défini par l'utilisateur qui n'a pas été construit

Certains outils comme QML Language Server ou qmllint ne peuvent pas trouver les modules définis par l'utilisateur lorsqu'ils ne sont pas construits. Si votre projet définit le module QML que vous essayez d'importer, l'outil QML ne le trouvera pas tant que vous ne l'aurez pas construit.

Chemin d'importation incorrect

Veuillez vous référer à la documentation sur le chemin d'importation QML et à la documentation sur l'importation du module de débogage pour plus d'informations sur les chemins d'importation.

Module manquant

Si les sections précédentes n'ont pas permis de trouver le module importé, il se peut qu'il soit manquant. Cela peut être dû à une dépendance manquante. Lorsque vous utilisez des bibliothèques externes, vérifiez qu'elles sont effectivement installées et que leurs modules se retrouvent dans un chemin d'importation.

Le composant n'a pas été trouvé

Que s'est-il passé ?

Un composant n'a pas été trouvé.

Pourquoi est-ce mauvais ?

L'application ne peut pas fonctionner parce qu'elle ne peut pas instancier le composant non trouvé.

Exemples d'erreurs

Faute de frappe dans le nom du composant

import QtQuick

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

Pour remédier à cet avertissement, corrigez la faute de frappe :

import QtQuick

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

Déclaration d'importation manquante

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

Pour corriger cet avertissement, ajoutez l'importation manquante du module :

import QtQuick

Item { // ok: was imported from QtQuick
}

Le qualificatif d'importation doit commencer par une majuscule

Qu'est-ce qui s'est passé ?

Un module importé a un qualificatif invalide.

Pourquoi est-ce mauvais ?

Le module importé avec ce qualificatif invalide ne peut pas être utilisé.

Exemples

import QtQuick as qq

qq.Item {
}

Pour corriger cet avertissement, faites en sorte que le qualificatif d'importation commence par une lettre majuscule :

import QtQuick as Qq

Qq.Item {
}

Syntaxe d'importation inconnue

Que s'est-il passé ?

Une instruction d'importation utilise une syntaxe d'importation non valide.

Pourquoi est-ce mauvais ?

L'application ne peut pas fonctionner parce qu'elle ne peut pas importer un module dont elle dépend.

Exemples

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

Item {
}

Pour corriger cet avertissement, utilisez des URL qui ont un schéma autorisé :

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

Item {
}