FAQ et glossaire
Démarrage et service local
Port déjà utilisé / changement de port sans effet
-p ne prend effet que si le master n'est pas démarré. Exécutez d'abord comphub kill, puis comphub -p 8080.
La commande comphub n'existe pas
Utilisez npx comp-hub, ou installez globalement puis rouvrez le terminal : npm install comp-hub@latest -g.
Le démarrage demande une mise à niveau
Exécutez npm install comp-hub@latest -g, puis redémarrez.
Le terminal affiche des journaux en continu
Ce sont les journaux du service du projet courant. Appuyez sur Ctrl+C pour terminer et désinscrire le projet ; le service n'affecte pas les autres projets.
Marché des composants et aperçu
Composant introuvable dans Recommandé / Récent / Populaire
Les trois premières listes filtrent les composants dont les dépendances ne correspondent pas. Passez à « Tout » pour confirmer, puis traitez le problème via Correspondance des dépendances.
Message de dépendance manquante alors qu'elle est installée
Vérifiez successivement : l'orthographe du nom du paquet, si la dépendance est installée dans le node_modules du sous-répertoire, et s'il faut rafraîchir la page pour relancer la détection.
L'aperçu fonctionne, mais pas après téléchargement
L'aperçu utilise les dépendances correspondantes de la plateforme ; après téléchargement, ce sont les versions de votre projet qui sont utilisées. Comparez avec les exigences de dépendances du README et mettez à niveau les paquets locaux si nécessaire.
Téléversement et publication
Pourquoi mon composant n'entre-t-il pas dans la liste publique
Il a peut-être été identifié comme doublon, ou l'état de ses dépendances ne remplit pas les conditions de recommandation. Les composants en double ne sont visibles que dans « Mes composants ».
Peut-on écrire comp.json à la main
Ce n'est pas conseillé. Il est généré par la plateforme et __id__ sert à identifier le composant. Une modification manuelle incorrecte empêchera de retrouver le composant lors des mises à jour.
Message de dépassement de limite de fichiers au téléversement
Fichier unique ≤ 3 Mo, taille totale ≤ 10 Mo, nombre de fichiers ≤ 30. Compressez les ressources statiques ou scindez le composant.
Un composant React signale no default export
L'entrée doit utiliser export default. Avec seulement des exports nommés, il n'y a aucun composant à rendre.
Versions et mises à jour
L'upload CLI est refusé
La version locale n'est pas supérieure à la version en ligne. Incrémentez le version de comp.json ; pour ne changer que la description ou la configuration d'aperçu, passez par la page de mise à jour.
Les anciennes versions restent-elles utilisables après une mise à jour
Oui. La plateforme conserve les versions historiques, et les utilisateurs peuvent continuer à télécharger les anciennes.
Faut-il réessayer après un délai dépassé
Vérifiez d'abord la dernière version sur la plateforme. Si elle est déjà à jour, ne réessayez pas, afin d'éviter une version en double.
Studio
Aperçu blanc
Attendez d'abord la fin de l'installation des dépendances, puis vérifiez le fichier d'entrée et le default export. Pour un Web Component, vérifiez que <script type="module"> se trouve bien dans <body> dans le HTML.
L'IA ne répond pas
Le modèle intégré nécessite une connexion ; pour une clé personnelle, vérifiez que la clé et le modèle sont disponibles.
L'espace de travail est vide après un rafraîchissement
Vérifiez que vous n'avez pas supprimé l'espace de travail. Les données de Studio sont stockées par espace de travail dans l'IndexedDB du navigateur local et ne sont pas synchronisées entre appareils.
Commande bloquée dans le terminal
Le terminal n'autorise que npm install / npm i / npm add ; les autres commandes ne sont pas exécutées.
Aide-mémoire des messages d'erreur
| Message | Signification | Traitement |
|---|---|---|
comp-hub must be upgraded before it can start | La version actuelle de la CLI doit être mise à niveau | Réinstallez la dernière version |
Local version ... is the published version | L'upload CLI n'a pas incrémenté la version | Modifiez le numéro de version |
Component has no default export | L'entrée React manque d'un export par défaut | Utilisez export default |
Proxy not found | La requête ne correspond à aucune règle de proxy | Vérifiez la configuration proxy et le chemin /__proxy__ |
Aucun <script type="module"> trouvé dans le fichier d'aperçu | Le HTML d'aperçu du Web Component n'a pas de script de module | Ajoutez-le dans <body> |
| Dépendance manquante / dependency missing | Les dépendances du composant ne sont pas installées localement | Installez-les à la racine du projet |
Glossaire
| Terme | Signification |
|---|---|
| Composant | Un dossier contenant un fichier d'entrée et des ressources ; le nom du dossier est celui du composant |
| Espace de travail | Un jeu indépendant de fichiers et d'historique de conversation dans Studio |
| Correspondance des dépendances | Règles déterminant si la version locale d'une dépendance satisfait les exigences d'un composant |
| Précompilation | La plateforme précompile les dépendances pour qu'elles se chargent directement lors de l'aperçu |
| mini / full | Aperçu en petite fenêtre dans la carte de liste / aperçu en plein écran dans la page de détail |
comp.json | Métadonnées du composant : __id__, name, version |
| ID du composant | La valeur de __id__, utilisée pour identifier un même composant lors des mises à jour et des imports |
| Versionnage sémantique | majeure.mineure.correctif, correspondant respectivement aux changements incompatibles, aux nouvelles fonctionnalités et aux correctifs |
Environnement et limites
| Élément | Limite |
|---|---|
| Node.js | 16.0.0 ou supérieur |
| npm | 8.0.0 ou supérieur |
| Taille d'un fichier | 3 Mo |
| Taille totale du composant | 10 Mo |
| Nombre de fichiers | 30 |
| Nom du composant | PascalCase ou kebab-case, unique dans l'espace |
| Nombre d'étiquettes | 5 au maximum |
Toujours bloqué
Rassemblez les informations dans cet ordre pour localiser rapidement le problème :
- L'erreur complète du terminal (pas seulement le résumé de la dernière ligne).
- La première erreur de la console du navigateur.
- Le framework du composant et le nom du fichier d'entrée.
- La cohérence entre les versions des dépendances locales et les exigences du README.