dart pub publish vers pub.dev

Lorsque votre paquet est prêt, une seule commande l’envoie au monde entier. La publication place votre bibliothèque sur pub.dev afin que chacun puisse en dépendre. 🌍

Définissez une version claire dans pubspec.yaml en suivant le versionnage sémantique. Les numéros majeur, mineur et de correctif indiquent précisément aux utilisateurs l’ampleur des changements.

Chaque publication doit comporter une entrée correspondante dans votre CHANGELOG. Les utilisateurs le consultent pour décider s’ils doivent mettre à niveau leur dépendance et de quelle manière : décrivez donc clairement les changements.

Un paquet publié doit inclure un fichier LICENSE. Il indique les droits légaux des utilisateurs, et pub.dev reconnaît automatiquement les licences libres courantes.

Exécutez publish avec l’option dry-run pour tout valider sans rien téléverser. Cette simulation signale les fichiers manquants ou les avertissements alors que les modifications restent faciles à effectuer.

Votre première publication ouvre un navigateur pour vous connecter. pub.dev associe l’envoi à votre compte, puis vous pouvez ajouter d’autres personnes comme responsables des envois.

Lorsque la simulation est correcte, retirez l’option pour publier. La commande publish téléverse vos fichiers et rend la version disponible en quelques secondes.

Une fois publiée, une version ne peut pas être supprimée, mais seulement retirée afin de décourager toute nouvelle utilisation. Vérifiez attentivement vos fichiers, car une erreur reste dans l’historique.

Évitez d’inclure vos secrets et vos fichiers superflus dans l’envoi. Dart ignore les fichiers correspondant à votre .gitignore ; une bonne hygiène de validation permet donc de garder votre archive publiée propre.

Publiez sous un éditeur vérifié associé à un domaine dont vous êtes propriétaire. Le badge inspire confiance et regroupe tous vos paquets sous une même identité. 🛡️

À chaque mise à jour, augmentez le numéro de version, ajoutez une entrée à CHANGELOG, relancez les vérifications, puis publiez à nouveau. Ce cycle fluide se répète indéfiniment.

Vous avez appris à gérer le numéro de version, le journal des modifications, la licence et la simulation, puis enfin à exécuter dart pub publish. Votre paquet fait désormais partie de l’écosystème. 🎉