Ruby Language
Gem Creation / Management
Sök…
Gemspec-filer
Varje pärla har en fil i formatet <gem name>.gemspec
som innehåller metadata om pärla och dess filer. Formatet för en gemspec är som följer:
Gem::Specification.new do |s|
# Details about gem. They are added in the format:
s.<detail name> = <detail value>
end
Fälten som krävs av RubyGems är:
Antingen author = string
eller authors = array
Använd author =
om det bara finns en författare, och authors =
när det finns flera. För authors=
använd en matris som listar författarnas namn.
files = array
Här array
är en lista över alla filer i pärla. Detta kan också användas med funktionen Dir[]
, till exempel om alla dina filer finns i /lib/
katalogen, kan du använda files = Dir["/lib/"]
.
name = string
Här strängen är bara namnet på din pärla. Rubygems rekommenderar några regler du bör följa när du namnger din pärla.
- Använd understreck, INTE RUMMER
- Använd endast små bokstäver
- Användning hypens för gem förlängning (t.ex. om din pärla heter
example
om förlängning skulle du namnge detexample-extension
) så att det kan krävas när det krävs då förlängning somrequire "example/extension"
.
RubyGems lägger också till "Om du publicerar en pärla på rubygems.org kan den tas bort om namnet är stötande, kränker immateriell egendom eller innehållet i pärla uppfyller dessa kriterier. Du kan rapportera en sådan pärla på RubyGems supportwebbplats."
platform=
Jag vet inte
require_paths=
Jag vet inte
summary= string
String är en sommar av ädelstenens syfte och allt du vill dela om pärla.
version= string
Det aktuella versionnumret för pärla.
De rekommenderade fälten är:
email = string
En e-postadress som kommer att kopplas till pärla.
homepage= string
Webbplatsen där pärla bor.
Antingen license=
eller licenses=
Jag vet inte
Bygga en pärla
När du har skapat din pärla för att publicera den måste du följa några steg:
- Bygg din pärla med
gem build <gem name>.gemspec
(gemspec-filen måste finnas) - Skapa ett RubyGems-konto om du inte redan har ett här
- Kontrollera att det inte finns några ädelstenar som delar ditt ädelstenarnamn
- Publicera din pärla med
gem publish <gem name>.<gem version number>.gem
beroenden
Så här listar du beroendeträdet:
gem dependency
Att lista vilka pärlor som beror på en specifik pärla (till exempel paket)
gem dependency bundler --reverse-dependencies