dh_ruby - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

dh_ruby — система збирання debhelper7 для програмного забезпечення Ruby

СИНТАКСИС

dh_ruby [ВАРІАНТИ]

ОПИС

dh_ruby це система збірки Debhelper 7 для програмного забезпечення Ruby. Він автоматично побудує і
інсталювати файли, що містяться в пакетах Ruby, намагаючись працювати якомога ближче до Rubygems
але з дотриманням стандартів Debian для пакетів Ruby.

dh_ruby може автоматично запускати ваші тести для всіх підтримуваних версій Ruby, див
Розділ "ФАЙЛИ" нижче.

Перегляньте dh_ruby --help для деталей.

ДЖЕРЕЛО ПАКЕТ ЗОВНІШНІЙ ВИД

dh_ruby підтримує два різних стилі вихідних пакетів: однобінарні вихідні пакети та
багатобінарні вихідні пакети.

Однобінарні розташування
Типовим макетом є однобінарні макет. Це макет, який використовується більшістю Ruby
пакети вгору, тобто код Ruby in либ/, виконувані програми в Бен/ та ін Пакети
імпортовано з Rubygems за допомогою gem2deb(1) матиме такий макет.

Використовуючи цей макет, dh_ruby встановить файли (код Ruby, виконувані файли, gemspecs) до
перший двійковий пакет вказані в debian / control.

Багатобінарний розташування
gem2deb версія 0.4.0 запровадив підтримку для багатобінарний макет. Цей макет повинен
використовувати, якщо у вас є набір різних пакетів Ruby, які підтримуються в одному пакеті
VCS, і ви вирішуєте, що також бажаєте підтримувати єдиний вихідний пакет у Debian
маючи різні компоненти як окремі двійкові пакети.

У цьому макеті вихідний пакет містить окремі компоненти в підкаталогах
де кожен із них використовуватиме стандартний макет Ruby (либ/, Бен/ тощо).

Цей макет не підтримує створення окремих двійкових пакетів з одного кореня
каталог. Для таких випадків дивіться документацію на DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
нижче.

Щоб вказати, що ви бажаєте використовувати багатобінарну розкладку, ми маємо 1) перерахувати вашу кілька
двійкові пакети в debian / control як зазвичай, і додайте додаткове поле під назвою X-DhRuby-Root до
кожну частину бінарного пакету, вказуючи, який каталог має використовуватись як кореневий для цього
бінарний пакет.

Приклад:

Джерело: mymultibinarypackage
[...]

Пакет: ruby-foo
X-DhRuby-Root: шлях/до/foo
[...]

Упаковка: рубін-бар
X-DhRuby-Root: шлях/до/панелі

Відповідний вихідний пакунок має бути оформлений так:

фу/
foo.gemspec
Бібліотека /
foo.rb
bin/foo
бар/
bar.gemspec
Бібліотека /
бар.рб
смітник /
бар

Важливі зауваження щодо багатобінарних пакетів і використання X-DhRuby-Root:

· Якщо ваш пакунок використовує багатобінарну розкладку, він повинен містити `gem2deb (>= 0.4.0~)` дюйм
Складання-Залежить.

версія 0.4.0 було a помилка in підтримка та цінності рідний Розширення у багатобінарних пакетах,
тому, якщо ваш пакет використовує мультибінарну функцію та принаймні один із під-
компоненти мають власні розширення, ви повинні використовувати `gem2deb (>= 0.4.1~)` дюйм Складання-Залежить
замість цього.

· Шлях, зазначений в X-DhRuby-Root, як ви вже, напевно, здогадалися, має бути
відносно кореня вихідного пакета.

· Якщо будь-який бінарний пакет оголошує a X-DhRuby-Root поле, усі інші двійкові пакети, які
ніхто не буде проігнорований dh_ruby.

ВАРІАНТИ

--чистий, --налаштувати, --будувати, --тест, --встановити
Команди, викликані debhelper на різних етапах процесу збирання.

--print-підтримується
Друкує підтримувані версії Ruby.

-h, --допомога
дисплеї dh_ruby інформації про використання.

-v, -- версія
дисплеї dh_ruby інформація про версію.

--gem-install
Цей параметр вказує на те, що збірка повинна використовувати дорогоцінний камінь команда для встановлення файлів,
замість домашнього інсталятора. Власні пакунки буде встановлено в
/ usr / lib /$ARCH/rubygems-integration/$RUBY_VERSION, тоді як чисті пакети Ruby будуть
встановлено до /usr/share/rubygems-integration/all.

--setuprb
Цей параметр вказує на те, що збірка повинна використовувати setup.rb а не звичайний дорогоцінний камінь-
заснована збірка. Щоб набув чинності, цей параметр має бути першим!

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

DH_RUBY
Використовуйте цю змінну для передачі параметрів командного рядка в dh_ruby. Наприклад в
debian/правила:

експорт DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Це розділений пробілами список тестів, які dh_ruby ігноруватиме під час збирання пакета.
Доступні назви тестів — це назви всіх підтримуваних версій Ruby (ви можете перерахувати
їх за допомогою `dh_ruby --print-supported`).

Якщо встановлено значення «усі», усі тести ігноруватимуться під час збірки пакета.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Якщо цю змінну визначено (для чого завгодно), dh_ruby поважатиме вказаний каталог
by dh_auto_install(1), зазвичай debian/tmp. За замовчуванням gem2deb встановить файли в
debian/пакет, Де пакет є першим бінарним пакетом у списку debian/control.

Це корисно для багатобінарних вихідних пакетів, які не відповідають підтримуваним
компонування (тобто окремі підкаталоги з кожним либ/, Бен/ тощо). Використовуючи це, усі файли
буде встановлено до debian/tmp, і ви можете розподілити їх в окремі двійкові файли
пакетів за допомогою debian/$package.install файли або явні виклики оболонки
debian/правила.

Змішування DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR і багатобінарна розкладка не підтримується.

DH_RUBY_GEMSPEC
Визначає, який файл містить специфікацію gem із метаданими пакета. за
За замовчуванням dh_ruby читатиме метадані з файлу .gemspec у кореневій папці вихідного пакета
каталог. Ви можете використовувати цю змінну, щоб перевизначити це, якщо ви хочете надати користувацький
метадані для пакета Debian.

У випадку, якщо в кореневому корені вихідного пакета є більше одного .gemspec, ви це зробите необхідність
використовувати DH_RUBY_GEMSPEC, щоб вказати dh_ruby, який з них використовувати.

Використовуйте dh_ruby онлайн за допомогою сервісів onworks.net