dh_ruby - Онлайн в облаке

ПРОГРАММА:

ИМЯ

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

СИНТАКСИС

dh_ruby [ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ]

ОПИСАНИЕ

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

dh_ruby может автоматически запускать ваши тесты для всех поддерживаемых версий Ruby, см.
Раздел «ФАЙЛЫ» ниже.

Подробности смотрите в dh_ruby --help.

ИСТОЧНИК ПАКЕТ Палубы Prestige XXNUMX

dh_ruby поддерживает два разных стиля пакетов исходного кода: пакеты с одним двоичным исходным кодом и
многобинарные пакеты с исходным кодом.

Однобинарный макет
Макет по умолчанию - одинарный двоичный макет. Это макет, используемый большинством Ruby
пакеты вверх по течению, т.е. код Ruby в Lib/, исполняемые программы в бункер/ и др. Пакеты
импортировано из Rubygems с использованием драгоценный камень2деб(1) будет такой макет.

При использовании этого макета dh_ruby установит файлы (код Ruby, исполняемые файлы, gemspecs) в
домен первый двоичный пакет перечислены в debian / control.

Мульти-двоичный макет
драгоценный камень2деб версия 0.4.0 представила поддержку многобинарный макет. Этот макет должен
использоваться, когда у вас есть набор различных пакетов Ruby, поддерживаемых в одной
VCS, и вы решаете, что также хотите поддерживать единый исходный пакет в Debian.
имея разные компоненты как отдельные бинарные пакеты.

В этом макете исходный пакет содержит отдельные компоненты в подкаталогах.
где каждый из них будет использовать стандартный макет Ruby (Lib/, бункер/, так далее).

Этот макет не поддерживает создание отдельных двоичных пакетов из одного корня.
каталог. В таких случаях см. Документацию на DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
внизу.

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

Пример:

Источник: mymultibinarypackage
[...]

Пакет: ruby-foo
X-DhRuby-Root: путь / к / foo
[...]

Пакет: рубиновый батончик
X-DhRuby-Root: путь / к / бару

Соответствующий пакет с исходным кодом должен иметь следующий вид:

foo /
foo.gemspec
Библиотека /
foo.rb
bin / foo
бар/
бар.gemspec
Библиотека /
бар.рб
bin /
бар

Важные примечания о многобинарных пакетах и ​​использовании X-DhRuby-Root:

· Если ваш пакет использует мульти-двоичный макет, он должен включать `драгоценный камень2деб (> = 0.4.0 ~) `дюйм
Зависит от сборки.

Версия 0.4.0 было a ошибка in домен поддержка для родной расширения в мультибинарных пакетах,
поэтому, если ваш пакет использует мульти-двоичную функцию и хотя бы один из под-
компоненты имеют собственные расширения, вы должны использовать `драгоценный камень2деб (> = 0.4.1 ~) `дюйм Зависит от сборки
.

· Путь, указанный в X-DhRuby-Root, как вы уже, наверное, догадались, должно быть
относительно корня исходного пакета.

· Если какой-либо двоичный пакет объявляет X-DhRuby-Root поле, все остальные двоичные пакеты,
нет будет проигнорирован dh_ruby.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--чистый, --конфигурировать, --строить, --тестовое задание, --установить
Команды, вызываемые debhelper на различных этапах процесса сборки.

--печать-поддерживается
Печатает поддерживаемые версии Ruby.

-h, --Помогите
Дисплеи dh_ruby информация об использовании.

-v, --версия
Дисплеи dh_ruby информация о версии.

--gem-установить
Этот параметр указывает, что сборка должна использовать драгоценный камень команда для установки файлов,
вместо собственного установщика. Собственные пакеты будут установлены в
/ usr / lib /$ ARCH / rubygems-integration / $ RUBY_VERSION, а чистые пакеты Ruby будут
установлен в / usr / share / rubygems-integration / все.

--setuprb
Этот параметр указывает, что сборка должна использовать setup.rb а не обычный самоцвет
на основе сборки. Чтобы этот параметр вступил в силу, он должен быть первым!

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

ДХ_РУБИ
Используйте эту переменную для передачи параметров командной строки в 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.

Это полезно для пакетов с несколькими двоичными исходными кодами, которые не соответствуют поддерживаемым
макет (т.е. отдельные подкаталоги, каждый с Lib/, бункер/ так далее). Используя это, все файлы
будет установлен на debian / tmp, и вы можете распределить их в отдельный двоичный файл
пакеты с помощью debian / $ package.install файлы или явные вызовы оболочки в
debian / rules.

Смешивание DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR и мульти-двоичный макет не поддерживается.

DH_RUBY_GEMSPEC
Определяет, какой файл содержит спецификацию драгоценного камня с метаданными пакета. К
по умолчанию dh_ruby будет читать метаданные из файла .gemspec в корне исходного пакета.
каталог. Вы можете использовать эту переменную, чтобы переопределить это, если вы хотите предоставить настраиваемый
метаданные для пакета Debian.

В случае, если в корне исходного пакета имеется более одного .gemspec, вы необходимость
использовать DH_RUBY_GEMSPEC, чтобы указать dh_ruby, какой из них использовать.

Используйте dh_ruby онлайн через сервисы onworks.net