Ruby Language
Gem Creatie / Beheer
Zoeken…
Gemspec-bestanden
Elke edelsteen heeft een bestand in de indeling <gem name>.gemspec
van <gem name>.gemspec
die metagegevens bevat over de edelsteen en zijn bestanden. Het formaat van een gemspec is als volgt:
Gem::Specification.new do |s|
# Details about gem. They are added in the format:
s.<detail name> = <detail value>
end
De velden vereist door RubyGems zijn:
Of author = string
of authors = array
Gebruik author =
als er slechts één auteur is, en author authors =
wanneer er meerdere zijn. Voor authors=
gebruik een array met de namen van de auteurs.
files = array
Hier array
is een lijst van alle bestanden in de edelsteen. Dit kan ook worden gebruikt met de functie Dir[]
, bijvoorbeeld als al uw bestanden zich in de /lib/
directory bevinden, dan kunt u files = Dir["/lib/"]
.
name = string
Hier is de string gewoon de naam van je edelsteen. Rubygems beveelt een aantal regels aan die u moet volgen bij het benoemen van uw edelsteen.
- Gebruik onderstrepingstekens, GEEN RUIMTEN
- Gebruik alleen kleine letters
- Gebruik hypens voor edelsteenverlenging (bijvoorbeeld als je edelsteen
example
wordt genoemd voor een verlenging, zou je hetexample-extension
noemen) zodat wanneer dan verlenging vereist is, het kan vereist zijn zoalsrequire "example/extension"
.
RubyGems voegt ook toe: "Als u een edelsteen op rubygems.org publiceert, kan deze worden verwijderd als de naam aanstootgevend is, intellectueel eigendom schendt of de inhoud van de edelsteen aan deze criteria voldoet. U kunt zo'n edelsteen melden op de RubyGems-ondersteuningssite."
platform=
Ik weet het niet
require_paths=
Ik weet het niet
summary= string
String is een zomers doel van de edelstenen en alles wat u over de edelsteen wilt delen.
version= string
Het huidige versienummer van de edelsteen.
De aanbevolen velden zijn:
email = string
Een e-mailadres dat aan het juweel wordt gekoppeld.
homepage= string
De website waar het juweeltje woont.
Ofwel license=
of licenses=
Ik weet het niet
Een juweel bouwen
Nadat je je juweel hebt gemaakt om het te publiceren, moet je een paar stappen volgen:
- Bouw je edelsteen met
gem build <gem name>.gemspec
(het gemspec-bestand moet bestaan) - Maak een RubyGems-account als je niet al een hebt hier
- Controleer of er geen edelstenen bestaan die de naam van je edelsteen delen
- Publiceer uw edelsteen met
gem publish <gem name>.<gem version number>.gem
afhankelijkheden
De afhankelijkheidsstructuur weergeven:
gem dependency
Om te vermelden welke edelstenen afhankelijk zijn van een specifieke edelsteen (bijvoorbeeld bundler)
gem dependency bundler --reverse-dependencies