dh_ruby - Online di Cloud

PROGRAM:

NAMA

dh_ruby - debhelper7 membangun sistem untuk perangkat lunak Ruby

RINGKASAN

dh_ruby [PILIHAN]

DESKRIPSI

dh_ruby adalah sistem pembangunan Debhelper 7 untuk perangkat lunak Ruby. Ini akan secara otomatis membangun dan
instal file yang terdapat dalam paket Ruby, coba bekerja sedekat mungkin dengan Rubygem
tetapi menghormati standar Debian untuk paket Ruby.

dh_ruby dapat secara otomatis menjalankan pengujian Anda terhadap semua versi Ruby yang didukung, lihat
bagian "FILES" di bawah.

Lihat dh_ruby --help untuk detailnya.

SOURCE PAKET LAYOUT

dh_ruby mendukung dua gaya paket sumber yang berbeda: paket sumber biner tunggal, dan
paket sumber multi-biner.

Biner tunggal tata ruang
Tata letak default adalah biner tunggal tata letak. Ini adalah tata letak yang digunakan oleh sebagian besar Ruby
paket upstream, yaitu kode Ruby di lib/, program yang dapat dieksekusi di bin/, dll. Paket
diimpor dari Rubygems menggunakan permata2deb(1) akan memiliki tata letak ini.

Saat menggunakan tata letak ini, dh_ruby akan menginstal file (kode Ruby, executable, gemspecs) ke
itu pertama biner paket terdaftar di debian / kontrol.

Multi-biner tata ruang
permata2deb versi 0.4.0 memperkenalkan dukungan untuk multi-biner tata letak. Tata letak ini harus
digunakan ketika Anda memiliki satu set paket Ruby berbeda yang dikelola di hulu dalam satu
VCS, dan Anda memutuskan bahwa Anda juga ingin memelihara satu paket sumber di Debian
memiliki komponen yang berbeda sebagai paket biner yang terpisah.

Dalam tata letak ini, paket sumber berisi komponen terpisah di subdirektori
di mana masing-masing akan menggunakan tata letak Ruby standar (lib/, bin/, dll).

Tata letak ini tidak mendukung pembuatan paket biner terpisah dari root yang sama
direktori. Untuk kasus tersebut, lihat dokumentasi di DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
di bawah.

Untuk menunjukkan bahwa Anda ingin menggunakan tata letak multi-biner, kami harus 1) mencantumkan kelipatan Anda
paket biner di debian / kontrol seperti biasa, dan tambahkan bidang ekstra yang disebut X-DhRuby-Root untuk
setiap bait paket biner, menunjukkan direktori mana yang harus digunakan sebagai root untuk itu
paket biner.

Sebuah contoh:

Sumber: mymultibinarypackage
[...]

Paket: ruby-foo
X-DhRuby-Root: jalur/ke/foo
[...]

Paket: ruby-bar
X-DhRuby-Root: jalur/ke/bar

Paket sumber yang sesuai harus ditata seperti ini:

foo/
foo.gemspec
lib /
foo.rb
tempat sampah/foo
batang/
bar.gemspec
lib /
bar.rb
tempat sampah/
bar

Catatan penting tentang paket multi-biner dan penggunaan X-DhRuby-Root:

· Jika paket Anda menggunakan tata letak multi-biner, paket tersebut harus menyertakan `permata2deb (>= 0.4.0~)` dalam
Membangun-Tergantung.

Versi 0.4.0 memiliki a kesalahan in itu mendukung untuk asli ekstensi dalam paket multi-biner,
jadi jika paket Anda menggunakan fitur multi-biner dan setidaknya salah satu sub-
komponen memiliki ekstensi asli, Anda harus menggunakan `permata2deb (>= 0.4.1~)` dalam Membangun-Tergantung
sebagai gantinya.

· Jalur yang ditunjukkan dalam X-DhRuby-Root, seperti yang mungkin sudah Anda duga sekarang, pasti
relatif terhadap root dari paket sumber.

· Jika ada paket biner yang mendeklarasikan a X-DhRuby-Root bidang, semua paket biner lainnya yang
tidak memilikinya akan diabaikan oleh dh_ruby.

PILIHAN

--membersihkan, --konfigurasi, --membangun, --tes, --Install
Perintah dipanggil oleh debhelper di berbagai langkah proses build.

--didukung cetak
Mencetak versi Ruby yang didukung.

-h, --membantu
menampilkan dh_ruby informasi penggunaan.

-v, --Versi: kapan
menampilkan dh_ruby informasi versi.

--permata-instal
Opsi ini menunjukkan bahwa build harus menggunakan batu permata perintah untuk menginstal file,
alih-alih penginstal buatan sendiri. Paket asli akan diinstal ke
/ usr / lib /$ARCH/rubygems-integrasi/$RUBY_VERSION, sedangkan paket Ruby murni adalah
dipasang ke /usr/share/rubygems-integration/all.

--setuprb
Opsi ini menunjukkan bahwa build harus menggunakan pengaturan.rb daripada permata biasa-
membangun berbasis. Agar berlaku, opsi ini harus didahulukan!

LINGKUNGAN VARIABEL

DH_RUBY
Gunakan variabel ini untuk meneruskan parameter baris perintah ke dh_ruby. Misalnya di
debian/aturan:

ekspor DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Ini adalah daftar pengujian yang dipisahkan oleh spasi yang akan diabaikan oleh dh_ruby selama pembuatan paket.
Nama pengujian yang tersedia adalah nama semua versi Ruby yang didukung (Anda dapat mencantumkan
mereka dengan `dh_ruby --print-supported`).

Jika disetel ke "semua", semua pengujian akan diabaikan selama pembuatan paket.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Jika variabel ini didefinisikan (untuk apa saja), dh_ruby akan menghormati direktori yang diinformasikan
by dh_auto_install(1), biasanya debian/tmp. Secara default, gem2deb akan menginstal file ke
debian/paket, Di mana paket adalah paket biner pertama yang terdaftar di debian/control.

Ini berguna untuk paket sumber multi-biner yang tidak sesuai dengan yang didukung
layout (yaitu memisahkan subdirektori masing-masing dengan lib/, bin/ dll). Menggunakan ini, semua file
akan dipasang ke debian/tmp, dan Anda dapat mendistribusikannya ke dalam biner terpisah
paket dengan menggunakan debian/$paket.install file atau panggilan shell eksplisit di
debian/aturan.

Percampuran DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR dan tata letak multi-biner tidak didukung.

DH_RUBY_GEMSPEC
Menentukan file mana yang berisi spesifikasi permata dengan metadata paket. Oleh
default, dh_ruby akan membaca metadata dari file .gemspec di root paket sumber
direktori. Anda dapat menggunakan variabel ini untuk menggantinya jika Anda ingin memberikan custom
metadata untuk paket Debian.

Jika ada lebih dari satu .gemspec di root paket sumber, Anda akan perlu
untuk menggunakan DH_RUBY_GEMSPEC untuk menginstruksikan dh_ruby tentang mana yang akan digunakan.

Gunakan dh_ruby online menggunakan layanan onworks.net