Come creare una gemma di rubino

Ruby Gems o “gem” è un gestore di pacchetti per il linguaggio di programmazione Ruby che fornisce un formato standard per la distribuzione di programmi e librerie Ruby. È facile da gestire e da installare nel sistema e può essere utilizzato da diverse applicazioni rails.

Ogni sviluppatore di RoR potrebbe aver personalizzato una gemma almeno una volta nella sua carriera, ma non tutti hanno effettivamente creato una gemma. Qui darò un'idea di base su come creare una nuova gemma e su come pubblicarla.

Calcio d'inizio

Prima di iniziare assicurati di utilizzare l'ultima versione di Ruby. RVM è davvero utile in questo caso;

Come dare un nome alla vostra Gemma?

Non date un nome a caso alla vostra gemma. Fate attenzione a quanto segue;
Ogni il trattino rappresenta una struttura (cartella, modulo) immersione
Ogni il carattere di sottolineatura rappresenta un'unione nel nome della classe

Alcuni esempi:

gemma new_test_gem

• richiedono 'new_test_gem'
• modulo/classe NewTestGem

E:

gemma gemma-struttura-nuova_prova_gem

• richiedono 'gem/structure/new_test_gem
• modulo/classe Gem::Struttura::NewTestGem

Come creare la vostra Gemma?

Per creare una gemma;
Gemma in bundle $ new_test_gem
Creerà alcuni file e directory di base.

Dove aggiungere il codice o il lavoro
Il vostro bellissimo codice va qui
#lib/new_test_gem.rb

Una volta aggiunto il codice nel file lib, dovrai aggiornare il file gemspec;
# new_test_gem.gemspec

Che cos'è il versionamento delle gemme?

# lib/new_test_gem/version.rb
modulo NewTestGem
VERSIONE = “0.1.0”
FINE

Un paio di cose su ciò che create

• Una versione gemma è una stringa di 3 numeri: "XYZ".
• Incremento X, Y, Z

incrementando Z, una piccola modifica viene chiamata numero di ‘build’ (ad esempio, modifica dell'etichetta/testo) e non cambia alcuna funzionalità.
incrementando la Y, una nuova funzionalità cambiata e chiamata numero ‘minore’. Ma non ci sono problemi di compatibilità con le versioni rilasciate in precedenza.
incrementando X, il cambiamento è grave e si chiama numero ‘maggiore’ e il cambiamento non è più compatibile con le versioni precedenti.
La gemma sottostante (Gem-release) aiuta a versionare la propria gemma con un semplice comando ‘bump’.
Gemma di rilascio della gemma:
https://github.com/svenfuchs/gem-release

Come costruire la vostra Gemma?

Una volta ottenuto il nostro gemspec, dobbiamo costruire una gemma da esso. Possiamo, quindi, installarlo localmente per testarlo.

Installazione e test
Una volta costruita la gemma, è necessario installarla nel sistema.
E, naturalmente, è necessario testarlo correttamente.
Installazione gemma $ ./new_test_gem-0.1.0.gem

Come spingere la vostra Gemma?

Per farlo, dovremo creare un account su RubyGems.org.
Poi, sarà disponibile per gli altri rubyisti di tutto il mondo attraverso rubygems.org.
Questo viene fatto da;
La gemma $ spinge new_test_gem-0.0.1.gem

Per verificarlo, la tua gemma viene aggiunta a RubyGems.org
$ elenco gemme -r new_test_gem

Fine
Basta questo per creare un gioiello!
Se volete creare una gemma Ruby, potete leggere i seguenti articoli;
http://guides.rubygems.org/make-your-own-gem/
http://railscasts.com/episodes/135-making-a-gem
https://gorails.com/episodes/creating-gems-for-frontend-javascript-libraries