So erstellen Sie einen Ruby Gem

Ruby Gems oder “gem” ist ein Paketmanager für die Programmiersprache Ruby, der ein Standardformat für die Verteilung von Ruby-Programmen und -Bibliotheken bietet. Er ist einfach zu verwalten und auf Ihrem System zu installieren und kann von verschiedenen Rails-Anwendungen verwendet werden.

Jeder RoR-Entwickler hat vielleicht mindestens einmal in seiner Karriere ein Gem angepasst, aber nicht jeder von ihnen hat tatsächlich ein Gem erstellt. Hier werde ich eine grundlegende Idee darüber geben, wie man einen neuen Edelstein erstellt und wie man ihn veröffentlicht.

Beginnen

Bevor Sie beginnen, stellen Sie bitte sicher, dass Sie die neueste Ruby-Version verwenden. RVM ist in diesem Fall wirklich nützlich;

Wie benennt man seinen Edelstein?

Vergeben Sie nicht blindlings einen zufälligen Namen für Ihren Edelstein. Achten Sie bitte auf Folgendes;
Alle Der Strich stellt eine Struktur dar (Ordner, Modul) Eintauchen
Alle Der Unterstrich stellt eine Verknüpfung im Klassennamen dar

Einige Beispiele:

gem new_test_gem

• benötige 'new_test_gem'
• Modul/Klasse NewTestGem

Und:

gem gem-structure-neu_test_gem

• require 'gem/structure/new_test_gem
• Modul/Klasse Gem::Structure::NewTestGem

Wie erstellt man einen Edelstein?

Ein Juwel erschaffen;
$-Bundle-Gem new_test_gem
Es werden einige grundlegende Dateien und Verzeichnisse erstellt.

Wo Sie Ihren Code oder Auftrag hinzufügen können
Ihr schöner Code geht hier
# lib/new_test_gem.rb

Sobald Sie Ihren Code in die lib-Datei eingefügt haben, müssen Sie die gemspec-Datei aktualisieren;
# new_test_gem.gemspec

Was ist Gem Versioning?

# lib/new_test_gem/version.rb
Modul NewTestGem
VERSION = “0.1.0”
Ende

Ein paar Dinge über das, was Sie schaffen

• Eine Gem-Version ist eine Folge von 3 Zahlen – „XYZ“.
• Inkrementieren von X, Y, Z

Inkrementierung von Z, eine kleine Änderung, die als ‘Build’-Nummer bezeichnet wird (z. B. Änderung der Beschriftung/des Textes) und keine Änderung der Funktionalität.
Inkrementierung von Y, eine neue Funktionsänderung, die als ‘Minor’-Nummer bezeichnet wird. Aber keine Kompatibilitätsprobleme mit den zuvor veröffentlichten Versionen.
Inkrementierung von X, schwerwiegende Änderung und es ist die ‘Major’-Nummer genannt und die Änderung nicht mehr kompatibel mit den vorherigen Versionen.
Das folgende Gem (Gem-release) hilft Ihnen, Ihr Gem mit einem einfachen ‘bump’-Befehl zu versionieren.
Gem-Release-Edelstein:
https://github.com/svenfuchs/gem-release

Wie baut man einen Edelstein?

Sobald wir unsere Gemspec haben, müssen wir daraus einen Gem bauen. Wir können es dann lokal installieren, um es zu testen.

Installation und Test
Sobald Ihr Edelstein erstellt ist, müssen Sie ihn auf Ihrem System installieren.
Und natürlich müssen Sie es richtig testen.
$ gem install ./new_test_gem-0.1.0.gem

Wie pusht man seinen Edelstein?

Dazu müssen wir ein Konto erstellen RubyGems.org.
Dann wird es den anderen Rubyisten auf der ganzen Welt über rubygems.org zur Verfügung stehen.
Dies geschieht durch;
$ gem push new_test_gem-0.0.1.gem

Um dies zu überprüfen, wird Ihr Edelstein in RubyGems.org hinzugefügt
$ Gem-Liste -r new_test_gem

Das Ende
Mehr braucht es nicht, um ein Schmuckstück zu schaffen!
Wenn Sie einen Ruby-Gem erstellen möchten, können Sie die folgenden Beiträge lesen;
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