dh_ruby - Online nel cloud

PROGRAMMA:

NOME

dh_ruby - sistema di compilazione debhelper7 per il software Ruby

SINOSSI

dh_rubino [VERSIONI]

DESCRIZIONE

dh_rubino è un sistema di compilazione Debhelper 7 per software Ruby. Compila e
installare i file contenuti nei pacchetti Ruby, cercando di lavorare il più vicino possibile a Rubygems
ma rispettando gli standard Debian per i pacchetti Ruby.

dh_ruby può eseguire automaticamente i test su tutte le versioni di Ruby supportate, vedere
Sezione "FILE" qui sotto.

Per i dettagli, vedere dh_ruby --help.

FONTE PACCHETTO LAYOUT

dh_rubino supporta due diversi stili di pacchetti sorgente: pacchetti sorgente binari singoli e
pacchetti sorgente multi-binari.

Singolo binario disposizione
Il layout predefinito è il singolo binario layout. Questo è il layout utilizzato dalla maggior parte dei Ruby
pacchetti upstream, ovvero codice Ruby in lib/, programmi eseguibili in bidone/, ecc. Pacchetti
importato da Rubygems utilizzando gem2deb(1) avrà questo layout.

Quando si utilizza questo layout, dh_rubino installerà i file (codice Ruby, eseguibili, gemspecs) per
, il prima di tutto binario pacchetto elencati in debian / control.

Multi-binario disposizione
gem2deb versione 0.4.0 ha introdotto il supporto per il multi-binario layout. Questo layout dovrebbe
essere utilizzato quando si dispone di un set di diversi pacchetti Ruby mantenuti a monte in un unico
VCS e decidi che vuoi anche mantenere un singolo pacchetto sorgente in Debian
avendo i diversi componenti come pacchetti binari separati.

In questo layout, il pacchetto sorgente contiene i componenti separati nelle sottodirectory
dove ognuno di essi utilizzerà il layout Ruby standard (lib/, bidone/, ecc.).

Questo layout non supporta la creazione di pacchetti binari separati dalla stessa radice
directory. Per questi casi, vedere la documentazione su DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
qua sotto.

Per indicare che si desidera utilizzare un layout multi-binario, dobbiamo 1) elencare i tuoi multipli
pacchetti binari in debian / control come al solito, e aggiungi un campo extra chiamato X-DhRuby-Root a
ogni stanza del pacchetto binario, che indica quale directory deve essere utilizzata come radice per quello
pacchetto binario.

Un esempio:

Fonte: mymultibinarypackage
[...]

Pacchetto: ruby-foo
X-DhRuby-Root: percorso/verso/foo
[...]

Pacchetto: ruby-bar
X-DhRuby-Root: percorso/verso/barra

Il pacchetto sorgente corrispondente dovrebbe essere strutturato in questo modo:

pippo/
foo.gemspec
lib /
foo.rb
bin/foo
sbarra/
bar.gemspec
lib /
bar.rb
bidone /
bar

Note importanti sui pacchetti multi-binari e sull'utilizzo di X-DhRuby-Root:

· Se il tuo pacchetto utilizza il layout multi-binario, deve includere `gem2deb (>= 0.4.0~)` in
Build-dipende.

Versione 0.4.0 ha avuto a insetto in , il supporto da nativo estensioni in pacchetti multi-binari,
quindi se il tuo pacchetto utilizza la funzionalità multi-binaria e almeno uno dei sotto-
i componenti hanno estensioni native, devi usare `gem2deb (>= 0.4.1~)` in Build-dipende
anziché.

· Il percorso indicato in X-DhRuby-Root, come probabilmente avrai già intuito, deve essere
relativo alla radice del pacchetto sorgente.

· Se un pacchetto binario dichiara un X-DhRuby-Root campo, tutti gli altri pacchetti binari che
non ne hai uno verrà ignorato da dh_rubino.

VERSIONI

--pulire, --configurare, --costruire, --test, --installare
Comandi richiamati da debhelper in varie fasi del processo di compilazione.

--supportato dalla stampa
Stampa le versioni di Ruby supportate.

-h, --Aiuto
Displays dh_rubino informazioni d'uso.

-v, --versione
Displays dh_rubino informazioni sulla versione.

--gemma-installazione
Questa opzione indica che la build dovrebbe utilizzare gemma comando per installare i file,
invece dell'installer homegrown. I pacchetti nativi verranno installati su
/ usr / lib /$ARCH/rubygems-integration/$RUBY_VERSION, mentre i pacchetti Ruby puri saranno
installato su /usr/share/rubygems-integration/all.

--setuprb
Questa opzione indica che la build dovrebbe utilizzare configurazione.rb piuttosto che la solita gemma-
build basata. Per avere effetto, questa opzione deve essere visualizzata per prima!

AMBIENTE VARIABILI

DH_RUBY
Utilizzare questa variabile per passare i parametri della riga di comando a dh_ruby. Ad esempio in
debian/regole:

esporta DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Questo è un elenco separato da spazi dei test che dh_ruby ignorerà durante la compilazione del pacchetto.
I nomi dei test disponibili sono i nomi di tutte le versioni Ruby supportate (è possibile elencare
con `dh_ruby --print-supported`).

Se impostato su "all", tutti i test verranno ignorati durante la compilazione del pacchetto.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Se questa variabile è definita (per qualsiasi cosa), dh_ruby rispetterà la directory informata
by dh_auto_install(1), di solito debian/tmpPer impostazione predefinita, gem2deb installerà i file in
Debian/pacchettoDurante la serata, pacchetto è il primo pacchetto binario elencato in debian/control.

Ciò è utile per i pacchetti sorgente multi-binari che non sono conformi al supporto
layout (cioè sottodirectory separate ciascuna con lib/, bidone/ ecc). Utilizzando questo, tutti i file
verrà installato su debian/tmpe puoi distribuirli in binari separati
pacchetti utilizzando debian/$package.install file o chiamate shell esplicite in
debian/regole.

Miscelazione DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR e il layout multi-binario non è supportato.

DH_RUBY_GEMSPEC
Determina quale file contiene la specifica gem con i metadati del pacchetto. Da
per impostazione predefinita, dh_ruby leggerà i metadati da un file .gemspec nella radice del pacchetto sorgente
directory. È possibile utilizzare questa variabile per sovrascriverla se si desidera fornire impostazioni personalizzate
metadati per il pacchetto Debian.

Nel caso in cui ci siano più di un .gemspec nella radice del pacchetto sorgente, sarà necessario bisogno
per usare DH_RUBY_GEMSPEC per indicare a dh_ruby quale usare.

Utilizzare dh_ruby online utilizzando i servizi onworks.net