Correspondance des dépendances
Cette page explique comment la plateforme décide si un composant « peut être rendu » lorsque ses dépendances diffèrent des versions locales.
Pourquoi une correspondance
Lors de l'aperçu sur la plateforme, le composant utilise les dépendances déjà installées dans votre projet local. En pratique, on rencontre souvent :
- le composant exige
echarts@5.2.3 - vous avez installé
echarts@5.0.0
Exiger une version strictement identique rendrait de nombreux composants inutilisables. La plateforme propose donc cinq niveaux de correspondance, et c'est vous qui décidez du degré de tolérance.
Les cinq règles
Dans « Paramètres → Règles d'aperçu → Dépendances », vous pouvez définir une règle pour chaque paquet de dependencies et de devDependencies :
| Règle | Critère | Cas d'usage | Couleur |
|---|---|---|---|
| Auto | Aucune limite de version, utilise la version installée localement | Valeur par défaut, priorité au rendu | Gris |
| Installation seule | Il suffit que le paquet soit installé localement, sans tenir compte de la version | Aperçu rapide, hors validation de production | Vert |
| Majeure | Même version majeure | Équilibre entre compatibilité et stabilité | Bleu |
| Majeure et mineure | Même version majeure et même version mineure | Pour les cas sensibles aux versions | Orange |
| Strictement identique | Numéro de version strictement identique | Contrôle de version strict | Rouge |
Plus on descend dans le tableau, plus la règle est stricte. Chaque élément de la page de paramètres est précédé d'un point de la couleur correspondante, pour une identification rapide.
Exemple de comparaison de versions
Supposons un composant qui dépend de echarts@5.2.3 :
| Version locale | Auto | Installation seule | Majeure | Majeure et mineure | Strictement identique |
|---|---|---|---|---|---|
| 5.0.0 | Utilisé | Utilisé | Utilisé | Ignoré | Ignoré |
| 5.2.0 | Utilisé | Utilisé | Utilisé | Ignoré | Ignoré |
| 5.2.3 | Utilisé | Utilisé | Utilisé | Utilisé | Utilisé |
| 6.0.0 | Utilisé | Utilisé | Ignoré | Ignoré | Ignoré |
| Non installé | Ignoré | Ignoré | Ignoré | Ignoré | Ignoré |
Comportement par défaut
- Une dépendance sans configuration spécifique utilise Auto.
- Une dépendance totalement absente en local ne correspond à aucune règle : il faut d'abord l'installer.
- Le framework est déterminé par le code source : importer
vuerend en Vue, importerreactrend en React ; importer les deux empêche le rendu.
Diagnostic en quatre étapes
1. Passer à « Tout »
Confirmez que le composant existe bien, et qu'il n'a pas été filtré par la liste.
2. Consulter l'état des dépendances
Dans la page de détail :
- Vert : correspondance réussie
- Jaune : écart de version, une exécution peut être tentée
- Rouge : non correspondance ou absence
3. Installer les dépendances manquantes
npm install <package-name>Après l'installation, rafraîchissez la page pour relancer la détection.
4. Assouplir la règle
Lorsque l'écart de version n'affecte pas le fonctionnement, passez de « Strictement identique » à « Majeure » ou à « Auto ».
Portée des règles
La correspondance des dépendances n'affecte que l'aperçu en ligne. Après téléchargement, l'exécution utilise les dépendances de votre projet, indépendamment de ces règles.
Prochaines étapes
- Préparer la publication de votre composant : Spécification des composants
- Erreur de dépendance après la publication : FAQ et glossaire