Ruby Language
Gem Kreation / Management

Gemspec-Dateien

Jeder Edelstein hat eine Datei im Format <gem name>.gemspec die Metadaten über den Edelstein und seine Dateien enthält. Das Format einer Gemspec lautet wie folgt:

Gem::Specification.new do |s|
  # Details about gem. They are added in the format:
  s.<detail name> = <detail value>
end

Die von RubyGems benötigten Felder sind:

Entweder author = string oder authors = array

Verwenden Sie author = wenn es nur einen Autor gibt, und authors = wenn mehrere vorhanden sind. Für authors= verwenden Sie ein Array, das die Namen der Autoren aufführt.

files = array

Hier ist das array eine Liste aller Dateien im Gem. Dies kann auch mit der Funktion Dir[] werden. Wenn sich beispielsweise alle Ihre Dateien im Verzeichnis /lib/ , können Sie files = Dir["/lib/"] .

name = string

Hier ist String nur der Name Ihres Edelsteins. Rubygems empfiehlt einige Regeln, die Sie bei der Benennung Ihres Edelsteins beachten sollten.

1. Verwenden Sie Unterstriche, keine Leerzeichen
2. Verwenden Sie nur Kleinbuchstaben
3. Verwenden Sie Hypens für die Gem-Erweiterung (z. B. wenn Ihr Edelstein example für eine Erweiterung genannt wird, würde Sie sie als example-extension ), so dass, wenn dann eine Erweiterung erforderlich ist, dies als require "example/extension" erforderlich sein kann.

RubyGems fügt außerdem hinzu: "Wenn Sie einen Edelstein auf rubygems.org veröffentlichen, wird er möglicherweise entfernt, wenn der Name unzulässig ist, das geistige Eigentum verletzt oder der Inhalt des Edelsteins diesen Kriterien entspricht. Sie können einen solchen Edelstein auf der RubyGems-Support-Site melden."

platform=

Ich weiß es nicht

require_paths=

Ich weiß es nicht

summary= string

String ist eine Zusammenfassung des Edelsteins und alles, was Sie über das Juwel mitteilen möchten.

version= string

Die aktuelle Versionsnummer des Edelsteins.

Die empfohlenen Felder sind:

email = string

Eine E-Mail-Adresse, die dem Edelstein zugeordnet wird.

homepage= string

Die Website, auf der der Edelstein lebt.

Entweder license= oder licenses=

Ich weiß es nicht

Einen Edelstein bauen

Nachdem Sie Ihren Edelstein erstellt haben, um ihn zu veröffentlichen, müssen Sie einige Schritte ausführen:

1. Bauen Sie Ihren Edelstein mit gem build <gem name>.gemspec (die gemspec-Datei muss vorhanden sein)
2. Erstellen Sie ein RubyGems - Konto , wenn Sie nicht bereits eine haben hier
3. Vergewissern Sie sich, dass keine Edelsteine ​​vorhanden sind, die Ihren Edelsteinnamen teilen
4. Veröffentlichen Sie Ihren Edelstein mit gem publish <gem name>.<gem version number>.gem

Abhängigkeiten

So listen Sie den Abhängigkeitsbaum auf:

gem dependency

Auflisten, welche Edelsteine ​​von einem bestimmten Edelstein abhängen (z. B. Bundler)

gem dependency bundler --reverse-dependencies