dh_ruby - Dalam talian di Awan

JADUAL:

NAMA

dh_ruby - sistem binaan debhelper7 untuk perisian Ruby

SINOPSIS

dh_ruby [PILIHAN]

DESCRIPTION

dh_ruby ialah sistem binaan Debhelper 7 untuk perisian Ruby. Ia secara automatik akan membina dan
pasang fail yang terkandung dalam pakej Ruby, cuba berfungsi sedekat mungkin dengan Rubygems
tetapi menghormati piawaian Debian untuk pakej Ruby.

dh_ruby boleh menjalankan ujian anda secara automatik terhadap semua versi Ruby yang disokong, lihat
bahagian "FAIL" di bawah.

Lihat dh_ruby --help untuk mendapatkan butiran.

SUMBER PAKEJ LAYOUT

dh_ruby menyokong dua gaya pakej sumber yang berbeza: pakej sumber binari tunggal, dan
pakej sumber berbilang binari.

Perduaan tunggal susun atur
Susun atur lalai ialah binari tunggal susun atur. Ini adalah reka letak yang digunakan oleh kebanyakan Ruby
pakej huluan, iaitu kod Ruby masuk lib/, program boleh laksana dalam bin/, dsb. Pakej
diimport dari Rubygems menggunakan gem2deb(1) akan mempunyai susun atur ini.

Apabila menggunakan susun atur ini, dh_ruby akan memasang fail (kod Ruby, executable, gemspecs) ke
yang pertama perduaan pakej disenaraikan dalam debian / kawalan.

Berbilang binari susun atur
gem2deb versi 0.4.0 memperkenalkan sokongan untuk berbilang binari susun atur. Susun atur ini sepatutnya
digunakan apabila anda mempunyai satu set pakej Ruby berbeza yang dikekalkan di hulu dalam satu
VCS, dan anda memutuskan bahawa anda juga mahu mengekalkan pakej sumber tunggal dalam Debian
mempunyai komponen yang berbeza sebagai pakej binari yang berasingan.

Dalam susun atur ini, pakej sumber mengandungi komponen berasingan dalam subdirektori
di mana setiap daripada mereka akan menggunakan susun atur Ruby standard (lib/, bin/, dan lain-lain).

Reka letak ini tidak menyokong membuat pakej binari yang berasingan daripada akar yang sama
direktori. Untuk kes tersebut, lihat dokumentasi pada DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
di bawah.

Untuk menunjukkan bahawa anda ingin menggunakan susun atur berbilang binari, kami perlu 1) menyenaraikan berbilang anda
pakej binari dalam debian / kawalan seperti biasa, dan tambah medan tambahan yang dipanggil X-DhRuby-Root kepada
setiap bait pakej binari, menunjukkan direktori mana yang perlu digunakan sebagai punca untuk itu
pakej binari.

Satu contoh:

Sumber: mymultibinarypackage
[...]

Pakej: ruby-foo
X-DhRuby-Root: laluan/ke/foo
[...]

Pakej: ruby-bar
X-DhRuby-Root: laluan/ke/bar

Pakej sumber yang sepadan hendaklah dibentangkan seperti ini:

foo/
foo.gemspec
lib /
foo.rb
tong/foo
bar/
bar.gemspec
lib /
bar.rb
tong sampah/
bar

Nota penting tentang pakej berbilang binari dan penggunaan X-DhRuby-Root:

· Jika pakej anda menggunakan susun atur berbilang binari, ia mesti termasuk `gem2deb (>= 0.4.0~)` dalam
Bina-Bergantung.

versi 0.4.0 mempunyai a pepijat in yang menyokong Untuk asli sambungan dalam pakej berbilang binari,
jadi jika pakej anda menggunakan ciri berbilang binari dan sekurang-kurangnya satu daripada sub-
komponen mempunyai sambungan asli, anda mesti menggunakan `gem2deb (>= 0.4.1~)` dalam Bina-Bergantung
sebaliknya.

· Laluan yang ditunjukkan dalam X-DhRuby-Root, seperti yang anda mungkin telah meneka sekarang, mesti begitu
relatif kepada akar pakej sumber.

· Jika mana-mana pakej binari mengisytiharkan a X-DhRuby-Root medan, semua pakej binari lain yang
tidak mempunyai satu akan diabaikan oleh dh_ruby.

PILIHAN

--bersih, --konfigurasi, --bina, --ujian, --pasang
Perintah yang dipanggil oleh debhelper pada pelbagai langkah proses binaan.

--cetak-disokong
Mencetak versi Ruby yang disokong.

-h, - membantu
memaparkan dh_ruby maklumat penggunaan.

-v, --versi
memaparkan dh_ruby maklumat versi.

--pasang-permata
Pilihan ini menunjukkan bahawa binaan harus menggunakan permata arahan untuk memasang fail,
bukannya pemasang buatan sendiri. Pakej asli akan dipasang ke
/ usr / lib /$ARCH/rubygems-integration/$RUBY_VERSION, manakala pakej Ruby tulen akan
dipasang ke /usr/share/rubygems-integration/all.

--setuprb
Pilihan ini menunjukkan bahawa binaan harus digunakan persediaan.rb daripada permata biasa-
binaan berasaskan. Untuk berkuat kuasa, pilihan ini mesti diutamakan!

PERSEKITARAN PELBAGAI

DH_RUBY
Gunakan pembolehubah ini untuk menghantar parameter baris arahan kepada dh_ruby. Contohnya dalam
debian/peraturan:

eksport DH_RUBY = --permata-pasang

DH_RUBY_IGNORE_TESTS
Ini ialah senarai ujian yang dipisahkan oleh ruang yang dh_ruby akan abaikan semasa membina pakej.
Nama ujian yang tersedia ialah nama semua versi Ruby yang disokong (anda boleh menyenaraikan
mereka dengan `dh_ruby --print-supported`).

Jika ditetapkan kepada "semua", semua ujian akan diabaikan semasa pembinaan pakej.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Jika pembolehubah ini ditakrifkan (kepada apa-apa), dh_ruby akan menghormati direktori yang dimaklumkan
by dh_auto_install(1), biasanya debian/tmp. Secara lalai, gem2deb akan memasang fail ke
debian/pakej, Di mana pakej ialah pakej binari pertama yang disenaraikan dalam debian/kawalan.

Ini berguna untuk pakej sumber berbilang binari yang tidak mematuhi yang disokong
susun atur (iaitu subdirektori berasingan masing-masing dengan lib/, bin/ dan lain-lain). Menggunakan ini, semua fail
akan dipasang ke debian/tmp, dan anda boleh mereka mengedarkannya ke dalam binari yang berasingan
pakej dengan menggunakan debian/$package.install fail atau panggilan shell eksplisit masuk
debian/peraturan.

Mencampur DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR dan susun atur berbilang binari tidak disokong.

DH_RUBY_GEMSPEC
Tentukan fail yang mengandungi spesifikasi permata dengan metadata pakej. Oleh
lalai, dh_ruby akan membaca metadata daripada fail .gemspec dalam akar pakej sumber
direktori. Anda boleh menggunakan pembolehubah ini untuk mengatasinya jika anda ingin memberikan tersuai
metadata untuk pakej Debian.

Sekiranya terdapat lebih daripada satu .gemspec dalam akar pakej sumber, anda akan melakukannya perlu
untuk menggunakan DH_RUBY_GEMSPEC untuk mengarahkan dh_ruby tentang yang mana satu untuk digunakan.

Gunakan dh_ruby dalam talian menggunakan perkhidmatan onworks.net