Versions et canaux

Publier un package crée une version : un instantané de son nom, de son résumé et de son contenu à ce moment-là, avec sa date, les plateformes sur lesquelles elle fonctionne et des notes de version facultatives. Une version publiée ne change jamais ; modifier le package prépare la suivante.

Deux canaux

Canal	Numéro	Exemple	Pour
Stable	MAJOR.MINOR.PATCH	1.2.0	Toutes les plateformes : la mise à jour qui leur est proposée.
Développement	MAJOR.MINOR.PATCH-dev.N	1.3.0-dev.2	Les tests : une préversion de la prochaine version stable.

Les versions de développement sont toujours présentées à part : un badge orange, leur propre carte En développement et leur bouton Télécharger la version de développement sur la page du package.

Choisir le numéro

Vous ne saisissez jamais de numéro de version : vous choisissez un palier, et la fenêtre affiche le numéro qui en résulte (Publie la version 1.1.0.).

Stable : le palier s’applique à la version stable la plus élevée.

Palier	Quand	À partir de 1.2.3
Correctif	Corrections : une faute dans une description, une ligne de script corrigée	1.2.4
Mineure	Ajouts : de nouveaux modèles, un nouveau profil	1.3.0
Majeure	Changements incompatibles : éléments retirés ou réorganisés	2.0.0

La toute première version stable est Majeure 1.0.0, ou Développement initial 0.1.0 si le package n’est pas encore prêt pour la production.

Développement : le palier désigne la version stable vers laquelle vous travaillez, et le numéro est cette cible suivie de -dev.N, N étant incrémenté pour cette cible.

Exemple de séquence

Action	Version
Première publication, Stable, Majeure	1.0.0
Ajout d’un nouveau modèle, Développement, Mineure	1.1.0-dev.1
Correction d’un script, Développement, Mineure	1.1.0-dev.2
Prêt pour tout le monde, Stable, Mineure	1.1.0
Correction d’une faute, Stable, Correctif	1.1.1
Réorganisation des profils, Développement, Majeure	2.0.0-dev.1

Les versions sont ordonnées comme dans le Semantic Versioning : une version de développement précède la version stable à laquelle elle mène, 1.0.0 < 1.1.0-dev.1 < 1.1.0-dev.2 < 1.1.0.

Dernière version et version de développement

• La dernière version d’un package (badge Dernière) est sa version stable la plus élevée.
• Sa version de développement est sa version de développement la plus élevée, lorsqu’elle est supérieure à la dernière. Une fois 1.1.0 publiée, 1.1.0-dev.2 n’est plus présentée comme la version de développement.

L’en-tête de l’éditeur affiche les deux, et Modifications non publiées lorsque le contenu en diffère.

Quand un canal peut être publié

• Stable peut être publié lorsque le nom, le résumé ou le contenu ont changé depuis la version stable la plus élevée (même si une version de développement contient déjà le même contenu).
• Développement peut être publié lorsque quelque chose a changé depuis la dernière version, quel qu’en soit le canal.

Un canal qui n’a rien à publier ne peut pas être choisi (Rien n’a changé pour ce canal depuis sa dernière version.). Lorsqu’aucun ne le peut, la page Versions indique Rien n’a changé depuis la dernière version.

Ce que les plateformes font des versions

• Une plateforme installe un package et le tient à jour avec ses versions stables.
• Les versions de développement sont destinées aux plateformes de test : installez-les délibérément, en téléchargeant le fichier de développement ou en le choisissant sur une plateforme connectée. Voir Versions et canal de développement dans le guide de la plateforme.
• Chaque élément du contenu conserve son identité d’une version à l’autre : une mise à jour modifie donc les éléments que la plateforme possède déjà au lieu de les dupliquer, et supprime ceux que vous avez retirés.
• Installer une version inférieure à celle installée est un retour arrière : la plateforme demande confirmation avant de revenir en arrière.