Mise à jour et versions

Cette page explique comment modifier un composant après sa publication, comment publier une nouvelle version, et quand le numéro de version doit impérativement changer.

Deux voies de mise à jour

Voie	Adaptée à	Ce qui peut être modifié
Page de mise à jour (Web)	Itérations courantes après la première publication	Code, configuration d'aperçu, description, étiquettes
comphub upload	Modifier uniquement le code, sans passer par l'interface	Publie le code uniquement, sans toucher aux métadonnées

La première publication passe toujours par la page de téléversement, car c'est là que __id__ est écrit.

Utiliser la page de mise à jour

1. Télécharger la version actuelle : dans « Mes composants », trouvez le composant, cliquez sur « Mettre à jour » et téléchargez d'abord la version en ligne comme base.
2. Modifier en local : modifiez le code et complétez la documentation dans le projet.
3. Valider en local : prévisualisez avec le service local pour vérifier l'absence de régression sur les fonctionnalités existantes.
4. Soumettre la mise à jour : revenez à la page de mise à jour, sélectionnez le dossier modifié, incrémentez la version, ajustez l'aperçu et la description si besoin, puis cliquez sur « Mettre à jour ».

Si vous ne modifiez que la description, les étiquettes ou la configuration d'aperçu, inutile d'incrémenter la version.

Mettre à jour avec la CLI

comphub login                                  # Une fois par machine
cd src/components/MyComponent
comphub upload -m "Correction du positionnement du tooltip"

Vous pouvez aussi spécifier explicitement le répertoire :

comphub upload src/components/MyComponent -m "Correction du positionnement du tooltip"

Différences avec la page de mise à jour :

• La version doit être incrémentée : si le version du comp.json local n'est pas supérieur à la version en ligne, la CLI refuse directement.
• La description, les étiquettes et la configuration d'aperçu ne sont pas modifiées : elles ne passent que par la page de mise à jour.

Avant de soumettre, vous pouvez faire une simulation :

comphub upload -m "Correction du positionnement du tooltip" --dry-run

--dry-run affiche le chemin du projet, l'ID du composant, la version en ligne et la version à publier, puis s'arrête sans rien soumettre.

Versionnage sémantique

majeure.mineure.correctif

Type	Changement	Exemple
Correctif	Correction de bug, rétrocompatible	1.0.0 → 1.0.1
Mineure	Nouvelle fonctionnalité, rétrocompatible	1.0.0 → 1.1.0
Majeure	Changement incompatible	1.0.0 → 2.0.0

Incrémentation obligatoire : modification du code du composant, de l'interface des props ou de la logique de comportement.

Incrémentation facultative : modification de la description, des étiquettes ou de la configuration d'aperçu uniquement.

Deux façons de modifier le numéro de version

Page de mise à jour : modifiez directement le champ de version dans la zone de configuration ; la plateforme l'écrit dans comp.json.

Modification manuelle en local :

{
  "name": "MyComponent",
  "version": "1.1.0"
}

Pensez à enregistrer : c'est ce fichier que lit la CLI.

Coexistence de plusieurs versions

La plateforme conserve les versions historiques. Les utilisateurs peuvent :

• basculer entre versions dans la page d'aperçu pour comparer les différences ;
• télécharger n'importe quelle version historique ;
• verrouiller la version utilisée dans leur propre projet.

Une ancienne version déjà téléchargée ne change pas automatiquement lors de la publication d'une nouvelle version.

Journal des modifications

Il est conseillé de le tenir à jour dans README.md :

## Journal des modifications

### 1.1.0 (2026-10-26)

- Ajout : prise en charge d'une couleur de thème personnalisée
- Optimisation : performances de rendu sur de grands volumes de données

### 1.0.1 (2026-10-20)

- Correction : le tooltip ne s'affichait pas dans certains cas

Pour les utilisateurs, lire le README permet de mieux juger de l'opportunité d'une mise à niveau que le seul numéro de version.

En cas de résultat de soumission incertain

Si la CLI affiche Submit result cannot be confirmed ou expire, il est possible que le serveur ait déjà enregistré la soumission. Ne réessayez pas directement : vérifiez d'abord la dernière version sur la page de détail du composant :

• Version mise à jour : inutile de réessayer.
• Version inchangée : relancez le téléversement.

Prochaines étapes

• Documentation complète de la ligne de commande : Utiliser la CLI
• Rencontrer une erreur lors d'une mise à jour : FAQ et glossaire