Ruby Academy · Leçon

Publier sur RubyGems

Publiez votre gem

Publier sur RubyGems est une leçon Ruby Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Ruby Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Ruby Academy comprend 4 leçons au total.

Qu’est-ce que RubyGems.org ?

RubyGems.org est la plateforme publique où les gemmes Ruby sont publiées et téléchargées. Lorsque vous exécutez gem install ou bundle install, les paquets y sont récupérés par défaut.

La publication rend votre gemme installable partout dans le monde.
Chaque nom de gemme est unique et est attribué selon le principe du premier arrivé, premier servi.
Une fois publiée, une version doit être considérée comme définitive.

Créer un compte

Avant de publier, vous avez besoin d’un compte RubyGems.org gratuit. Vous vous connectez ensuite depuis la ligne de commande afin que l’outil gem puisse authentifier vos téléversements. Les identifiants sont stockés localement pour les publications ultérieures.

Liste de vérification avant publication

Avant de publier, vérifiez les points suivants :

Le numéro de version a été incrémenté.
Les tests réussissent.
Le journal des modifications est à jour.
Le fichier de spécification de gemme répertorie tous les fichiers et la licence correcte.

Quelques minutes de vérification suffisent à éviter une publication publique défectueuse.

checklist = ["version bumped", "tests pass", "changelog updated", "gemspec valid"]
checklist.each { |item| puts "[ ] " + item }

Compiler le paquet

Exécutez gem build mygem.gemspec. Cette commande lit le fichier gemspec et produit un fichier tel que mygem-0.1.0.gem, contenant votre code et vos métadonnées. Il s’agit de l’artefact exact qui sera téléversé.

Tester la compilation localement

Installez le fichier compilé dans un environnement propre avec gem install ./mygem-0.1.0.gem, puis essayez de le charger. Cela permet de détecter les fichiers manquants ou les erreurs de chargement avant qu’ils ne soient visibles de tous.

Publier sur RubyGems

Publiez avec gem push mygem-0.1.0.gem. En quelques instants, la version apparaît sur RubyGems.org et n’importe qui peut l’installer. La commande utilise vos identifiants enregistrés pour autoriser le téléversement.

Publier avec Rake

Les paquets générés par Bundler incluent une tâche rake release. Celle-ci crée une étiquette pour la version dans git, compile le paquet et le publie en une seule étape, afin que l’étiquette git et la version publiée correspondent toujours.

Vous ne pouvez pas republier une version

Une fois que 1.0.0 est publiée, vous ne pouvez pas la remplacer par un code différent. Pour corriger un problème, vous devez publier une nouvelle version, telle que 1.0.1. Cela garantit qu’une version donnée correspond toujours aux mêmes octets pour chaque utilisateur.

published = "1.0.0"
fix = "1.0.1"
puts "Cannot overwrite " + published
puts "Publish " + fix + " instead"

Retirer une version défectueuse

Si une version est défectueuse ou dangereuse, gem yank mygem -v 1.0.1 la retire des nouvelles installations. Les fichiers de verrouillage existants peuvent encore la référencer ; le retrait est donc une solution de dernier recours, et non un bouton d’annulation.

Sécuriser votre compte

Protégez votre paquet contre le détournement :

Activez l’authentification multifacteur sur RubyGems.org.
Utilisez des clés API avec des autorisations limitées.
Ajoutez des copropriétaires de confiance avec gem owner afin que le paquet reste disponible si vous cessez de vous en occuper.

Après la publication

Une fois votre paquet en ligne, partagez les instructions d’installation dans votre README, annoncez la publication et surveillez les problèmes. Répondez aux rapports de bogues avec des versions correctives. Un paquet bien entretenu gagne progressivement la confiance et des utilisateurs.

Vérification rapide

Vérifiez votre compréhension de la publication.

Récapitulatif : publication sur RubyGems

Vous avez appris le processus de publication :

Créez un compte et connectez-vous.
Exécutez une liste de contrôle préalable, puis gem build.
Testez localement, puis exécutez gem push ou rake release.
Les versions sont permanentes ; publiez les corrections dans de nouvelles versions ou utilisez gem yank.
Sécurisez votre compte avec MFA et des copropriétaires.

Le cours Créer votre propre paquet Ruby est maintenant terminé.

Questions Fréquemment Posées

La leçon « Publier sur RubyGems » est-elle gratuite ?

Oui — le texte complet de « Publier sur RubyGems » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Ruby Academy, passe à CoddyKit PRO. Le cours Ruby Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Publier sur RubyGems » ?

Publiez votre gem Tu pratiques Ruby Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Ruby Academy ?

Aucune expérience préalable n'est requise. Ruby Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Publier sur RubyGems » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Ruby Academy ?

Oui. Chaque leçon Ruby Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Ruby Academy