Ruby Academy · Lezione

Pubblicare su RubyGems

Rilasciare la propria gem

Pubblicare su RubyGems è una lezione Ruby Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Ruby Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Ruby Academy include 4 lezioni in totale.

Che cos'è RubyGems.org?

RubyGems.org è il servizio pubblico che ospita i gem Ruby pubblicati e scaricati dagli utenti. Quando esegue gem install o bundle install, per impostazione predefinita scarica i pacchetti da lì.

La pubblicazione rende il gem installabile in tutto il mondo.
Ogni nome di gem è univoco e viene assegnato in base all'ordine di arrivo.
Una volta pubblicata, una versione va considerata permanente.

Creare un account

Prima di pubblicare è necessario un account gratuito su RubyGems.org. Dovrà quindi accedere dalla riga di comando, affinché lo strumento gem possa autenticare i caricamenti. Le credenziali vengono memorizzate localmente per i push successivi.

Checklist pre-rilascio

Prima del rilascio, verifichi che:

Il numero di versione sia stato incrementato.
I test superino tutti i controlli.
Il changelog sia aggiornato.
Il gemspec elenchi tutti i file e la licenza corretta.

Alcuni minuti di verifica evitano una pubblicazione non funzionante.

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

Creare il pacchetto

Esegua gem build mygem.gemspec. Questo comando legge il gemspec e produce un file come mygem-0.1.0.gem, che contiene il codice e i metadati. È l'artefatto esatto che verrà caricato.

Testare la build in locale

Installi il file creato in un ambiente pulito con gem install ./mygem-0.1.0.gem e provi a importarlo. In questo modo può individuare file mancanti o errori di caricamento prima che siano visibili a tutti.

Pubblicare su RubyGems

Pubblicare con gem push mygem-0.1.0.gem. Nel giro di pochi istanti la versione apparirà su RubyGems.org e chiunque potrà installarla. Il comando utilizza le credenziali salvate per autorizzare il caricamento.

Rilasciare con Rake

I gem creati tramite lo scaffold di Bundler includono un task rake release. Questo crea il tag della versione in git, compila il gem e lo pubblica in un unico passaggio, così il tag git e la versione pubblicata corrispondono sempre.

Non è possibile ripubblicare una versione

Una volta pubblicata 1.0.0, non è possibile sovrascriverla con codice diverso. Per correggere un problema, deve pubblicare una nuova versione, ad esempio 1.0.1. In questo modo una determinata versione contiene sempre gli stessi byte per ogni utente.

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

Rimuovere una release difettosa

Se una versione è difettosa o non sicura, gem yank mygem -v 1.0.1 la rimuove dalle nuove installazioni. I lockfile esistenti potrebbero continuare a farvi riferimento, quindi la rimozione è l'ultima risorsa, non un pulsante per annullare l'operazione.

Proteggere il proprio account

Protegga il gem dal dirottamento:

Abiliti l'autenticazione a più fattori su RubyGems.org.
Utilizzi chiavi API con ambito limitato e autorizzazioni ridotte.
Aggiunga comproprietari fidati con gem owner, così il gem continuerà a essere gestito anche se dovesse allontanarsi dal progetto.

Dopo la pubblicazione

Una volta online, condivida le istruzioni per l'installazione nel README, annunci la release e controlli la presenza di problemi. Risponda alle segnalazioni di bug con release di correzione. Un gem mantenuto con cura conquista fiducia e diffusione nel tempo.

Verifica rapida

Verifichi la propria comprensione della pubblicazione.

Riepilogo: pubblicazione su RubyGems

Ha appreso il flusso di rilascio:

Creare un account e accedere.
Eseguire una checklist preliminare, quindi gem build.
Testare in locale, quindi eseguire gem push (oppure rake release).
Le versioni sono permanenti: pubblichi le correzioni come nuove versioni oppure utilizzi gem yank.
Proteggere l'account con l'autenticazione a più fattori e i comproprietari.

Con questo si conclude il corso Creare il proprio gem Ruby.

Domande Frequenti

La lezione «Pubblicare su RubyGems» è gratuita?

Sì — il testo completo di «Pubblicare su RubyGems» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Ruby Academy, passa a CoddyKit PRO. Il corso Ruby Academy include 4 lezioni in totale.

Cosa imparerò in «Pubblicare su RubyGems»?

Rilasciare la propria gem Eserciti Ruby Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Ruby Academy?

Non è richiesta alcuna esperienza precedente. Ruby Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Pubblicare su RubyGems»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Ruby Academy?

Sì. Ogni lezione Ruby Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Ruby Academy