dh_ruby – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

dh_ruby – Debhelper7-Build-System für Ruby-Software

ZUSAMMENFASSUNG

dh_ruby [OPTIONAL]

BESCHREIBUNG

dh_ruby ist ein Debhelper 7-Build-System für Ruby-Software. Es wird automatisch erstellt und
Installieren Sie die in Ruby-Paketen enthaltenen Dateien und versuchen Sie, so nah wie möglich an Rubygems zu arbeiten
aber unter Beachtung der Debian-Standards für Ruby-Pakete.

dh_ruby kann Ihre Tests automatisch für alle unterstützten Ruby-Versionen ausführen, siehe
Abschnitt „DATEIEN“ weiter unten.

Weitere Informationen finden Sie unter dh_ruby --help.

SOURCE PAKET LAYOUT

dh_ruby unterstützt zwei verschiedene Quellpaketstile: Single-Binary-Quellpakete und
Multi-Binär-Quellpakete.

Single-Binär Layout
Das Standardlayout ist das Single-Binär Layout. Dies ist das Layout, das von den meisten Ruby-Programmen verwendet wird
Pakete vorgelagert, also Ruby-Code einbinden lib/, ausführbare Programme in Kasten/ usw. Pakete
importiert aus Rubygems mit gem2deb(1) wird dieses Layout haben.

Wenn Sie dieses Layout verwenden, dh_ruby installiert Dateien (Ruby-Code, ausführbare Dateien, Gemspecs) in
zuerst binär Paket aufgelistet in Debian / Kontrolle.

Multibinär Layout
gem2deb Version 0.4.0 Einführung der Unterstützung für die multibinär Layout. Dieses Layout sollte
kann verwendet werden, wenn Sie eine Reihe verschiedener Ruby-Pakete haben, die vorab in einem einzigen Paket verwaltet werden
VCS, und Sie entscheiden, dass Sie auch ein einzelnes Quellpaket in Debian verwalten möchten
die verschiedenen Komponenten als separate Binärpakete haben.

In diesem Layout enthält das Quellpaket die einzelnen Komponenten in Unterverzeichnissen
wobei jeder von ihnen das Standard-Ruby-Layout verwendet (lib/, Kasten/, usw).

Dieses Layout unterstützt nicht das Erstellen separater Binärpakete aus demselben Stammverzeichnis
Verzeichnis. Informationen zu solchen Fällen finden Sie in der Dokumentation zu DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
unten.

Um anzuzeigen, dass Sie ein Multi-Binär-Layout verwenden möchten, müssen wir 1) Ihr Multiple auflisten
Binärpakete in Debian / Kontrolle wie üblich, und fügen Sie ein zusätzliches Feld namens hinzu X-DhRuby-Root zu
jede Strophe des Binärpakets, die angibt, welches Verzeichnis dafür als Root verwendet werden muss
Binärpaket.

Ein Beispiel:

Quelle: mymultibinarypackage
[...]

Paket: Ruby-Foo
X-DhRuby-Root: Pfad/zu/foo
[...]

Paket: Ruby-Bar
X-DhRuby-Root: Pfad/zu/bar

Das entsprechende Quellpaket sollte wie folgt aufgebaut sein:

foo/
foo.gemspec
lib /
foo.rb
bin/foo
Bar/
bar.gemspec
lib /
bar.rb
Behälter/
Bar

Wichtige Hinweise zu Multi-Binärpaketen und deren Verwendung X-DhRuby-Root:

· Wenn Ihr Paket das Multi-Binär-Layout verwendet, muss es „gem2deb (>= 0.4.0~)` Zoll
Build-Abhängig.

Version 0.4.0 hätten a Fehler in Support für nativen Erweiterungen in Multi-Binärpaketen,
Wenn Ihr Paket also die Multi-Binär-Funktion und mindestens eines der Unterprogramme verwendet,
Komponenten über native Erweiterungen verfügen, müssen Sie „gem2deb (>= 0.4.1~)` Zoll Build-Abhängig
stattdessen.

· Der in angegebene Pfad X-DhRuby-Root, wie Sie wahrscheinlich schon erraten haben, muss es sein
relativ zum Stammverzeichnis des Quellpakets.

· Wenn ein Binärpaket a X-DhRuby-Root Feld, alle anderen Binärpakete, die
Wenn Sie keines haben, wird dies ignoriert dh_ruby.

OPTIONAL

--sauber, --konfigurieren, --bauen, --Prüfung, --Installieren
Von Debhelper in verschiedenen Schritten des Build-Prozesses aufgerufene Befehle.

--print-unterstützt
Druckt die unterstützten Ruby-Versionen.

-h, --help
Schaukasten dh_ruby Nutzungsinformationen.

-v, --Version
Schaukasten dh_ruby Versionsinformation.

--gem-install
Diese Option gibt an, dass der Build das verwenden soll Juwel Befehl zum Installieren der Dateien,
anstelle des selbst entwickelten Installationsprogramms. Native Pakete werden installiert
/ usr / lib /$ARCH/rubygems-integration/$RUBY_VERSION, während reine Ruby-Pakete es sein werden
installiert /usr/share/rubygems-integration/all.

--setuprb
Diese Option gibt an, dass der Build verwendet werden soll setup.rb statt der üblichen Juwelen
basierender Build. Um wirksam zu werden, muss diese Option an erster Stelle stehen!

VARIABLEN

DH_RUBY
Verwenden Sie diese Variable, um Befehlszeilenparameter an dh_ruby zu übergeben. Zum Beispiel in
debian/rules:

export DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Dies ist eine durch Leerzeichen getrennte Liste von Tests, die dh_ruby während der Paketerstellung ignoriert.
Die verfügbaren Testnamen sind die Namen aller unterstützten Ruby-Versionen (Sie können sie auflisten).
sie mit `dh_ruby --print-supported`).

Wenn es auf „all“ gesetzt ist, werden alle Tests während der Paketerstellung ignoriert.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Wenn diese Variable (auf irgendetwas) definiert ist, respektiert dh_ruby das angegebene Verzeichnis
by dh_auto_install(1), normalerweise debian/tmp. Standardmäßig installiert gem2deb Dateien in
debian/Paket, Wobei Paket ist das erste Binärpaket, das in debian/control aufgeführt ist.

Dies ist nützlich für Multi-Binär-Quellpakete, die nicht den unterstützten entsprechen
Layout (d. h. separate Unterverzeichnisse mit jeweils lib/, Kasten/ usw). Verwenden Sie dazu alle Dateien
wird installiert debian/tmp, und Sie können sie in separate Binärdateien verteilen
Pakete durch Verwendung debian/$package.install Dateien oder explizite Shell-Aufrufe in
debian/regeln.

Vermischung DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR und ein multibinäres Layout wird nicht unterstützt.

DH_RUBY_GEMSPEC
Bestimmt, welche Datei die Gem-Spezifikation mit Paketmetadaten enthält. Von
Standardmäßig liest dh_ruby Metadaten aus einer .gemspec-Datei im Stammverzeichnis des Quellpakets
Verzeichnis. Sie können diese Variable verwenden, um dies zu überschreiben, wenn Sie eine benutzerdefinierte Variable bereitstellen möchten
Metadaten für das Debian-Paket.

Falls es mehr als eine .gemspec im Stammverzeichnis des Quellpakets gibt, werden Sie dies tun technische
DH_RUBY_GEMSPEC zu verwenden, um dh_ruby anzuweisen, welches verwendet werden soll.

Verwenden Sie dh_ruby online über die Dienste von onworks.net