dh_ruby - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

dh_ruby - hệ thống xây dựng debhelper7 cho phần mềm Ruby

SYNOPSIS

dh_ruby [LỰA CHỌN]

MÔ TẢ

dh_ruby là một hệ thống xây dựng Debhelper 7 cho phần mềm Ruby. Nó sẽ tự động xây dựng và
cài đặt các tệp có trong các gói Ruby, cố gắng hoạt động gần với Rubygems nhất có thể
nhưng tôn trọng các tiêu chuẩn Debian cho các gói Ruby.

dh_ruby có thể tự động chạy các bài kiểm tra của bạn dựa trên tất cả các phiên bản Ruby được hỗ trợ, hãy xem
Phần "FILES" bên dưới.

Xem dh_ruby --help để biết thêm chi tiết.

SOURCE GÓI BỐ TRÍ

dh_ruby hỗ trợ hai kiểu gói nguồn khác nhau: gói nguồn nhị phân đơn và
gói nguồn đa nhị phân.

Nhị phân đơn bố trí
Bố cục mặc định là nhị phân đơn bố trí. Đây là bố cục được hầu hết các Ruby sử dụng
các gói ngược dòng, tức là mã Ruby trong lib/, các chương trình thực thi trong bin/, v.v. Các gói
được nhập từ Rubygems bằng cách sử dụng đá quý2deb(1) sẽ có bố cục này.

Khi sử dụng bố cục này, dh_ruby sẽ cài đặt các tệp (mã Ruby, tệp thực thi, gemspec) để
các Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên nhị phân gói được liệt kê trong debian / control.

Đa nhị phân bố trí
đá quý2deb phiên bản 0.4.0 giới thiệu hỗ trợ cho đa nhị phân bố trí. Bố cục này nên
được sử dụng khi bạn có một tập hợp các gói Ruby khác nhau được duy trì ngược dòng trong một
VCS và bạn quyết định rằng bạn cũng muốn duy trì một gói nguồn duy nhất trong Debian
có các thành phần khác nhau dưới dạng các gói nhị phân riêng biệt.

Trong bố cục này, gói nguồn chứa các thành phần riêng biệt trong các thư mục con
trong đó mỗi người trong số họ sẽ sử dụng bố cục Ruby tiêu chuẩn (lib/, bin/, Vân vân).

Bố cục này không hỗ trợ tạo các gói nhị phân riêng biệt từ cùng một gốc
danh mục. Đối với những trường hợp đó, hãy xem tài liệu về DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
phía dưới.

Để chỉ ra rằng bạn muốn sử dụng bố cục đa nhị phân, chúng tôi phải 1) liệt kê nhiều
gói nhị phân trong debian / control như thường lệ và thêm một trường bổ sung có tên X-DhRuby-Root đến
mỗi khổ gói nhị phân, cho biết thư mục nào phải được sử dụng làm thư mục gốc cho
gói nhị phân.

Một ví dụ:

Nguồn: mymultibinarypackage
[...]

Gói: ruby-foo
X-DhRuby-Root: path / to / foo
[...]

Đóng gói: ruby-bar
X-DhRuby-Root: đường dẫn / đến / thanh

Gói nguồn tương ứng nên được sắp xếp như thế này:

foo /
foo.gemspec
lib /
foo.rb
bin / foo
quán ba/
thanh.gemspec
lib /
thanh.rb
thùng rác/
thanh

Các lưu ý quan trọng về các gói đa nhị phân và việc sử dụng X-DhRuby-Root:

· Nếu gói của bạn sử dụng bố cục đa nhị phân, nó phải bao gồm `đá quý2deb (> = 0.4.0 ~) `trong
Xây dựng-Phụ thuộc.

phiên bản 0.4.0 có a lỗi in các hỗ trợ cho tự nhiên mở rộng trong các gói đa nhị phân,
vì vậy nếu gói của bạn sử dụng tính năng đa nhị phân và ít nhất một trong các
các thành phần có phần mở rộng gốc, bạn phải sử dụng `đá quý2deb (> = 0.4.1 ~) `trong Xây dựng-Phụ thuộc
thay thế.

· Đường dẫn được chỉ ra trong X-DhRuby-Root, như bạn có thể đã đoán bây giờ, phải
so với gốc của gói nguồn.

· Nếu bất kỳ gói nhị phân nào khai báo X-DhRuby-Root trường, tất cả các gói nhị phân khác
không có một cái sẽ bị bỏ qua bởi dh_ruby.

LỰA CHỌN

--dọn dẹp, --cấu hình, --xây dựng, --kiểm tra, --Tải về
Các lệnh được debhelper gọi ở các bước khác nhau của quá trình xây dựng.

- hỗ trợ in
In các phiên bản Ruby được hỗ trợ.

-h, --Cứu giúp
Hiển thị dh_ruby thông tin sử dụng.

-v, --phiên bản
Hiển thị dh_ruby thông tin phiên bản.

--gem-cài đặt
Tùy chọn này chỉ ra rằng bản dựng nên sử dụng đá quý lệnh để cài đặt các tệp,
thay vì trình cài đặt cây nhà lá vườn. Các gói gốc sẽ được cài đặt để
/ usr / lib /$ ARCH / rubygems-integration / $ RUBY_VERSION, trong khi các gói Ruby thuần túy sẽ
cài đặt vào / usr / share / rubygems-integration / all.

--setuprb
Tùy chọn này chỉ ra rằng bản dựng nên sử dụng thiết lập.rb chứ không phải là đá quý thông thường-
xây dựng dựa trên. Để có hiệu lực, tùy chọn này phải đến trước!

MÔI TRƯỜNG BIẾN

DH_RUBY
Sử dụng biến này để chuyển các tham số dòng lệnh cho dh_ruby. Ví dụ trong
debian / quy tắc:

xuất DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Đây là danh sách các bài kiểm tra được phân tách bằng dấu cách mà dh_ruby sẽ bỏ qua trong quá trình xây dựng gói.
Các tên thử nghiệm có sẵn là tên của tất cả các phiên bản Ruby được hỗ trợ (bạn có thể liệt kê
chúng với `dh_ruby - print-support`).

Nếu được đặt thành "tất cả", tất cả các thử nghiệm sẽ bị bỏ qua trong quá trình xây dựng gói.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Nếu biến này được xác định (cho bất kỳ thứ gì), dh_ruby sẽ tôn trọng thư mục được thông báo
by dh_auto_install(1), thường là debian / tmp. Theo mặc định, gem2deb sẽ cài đặt các tệp để
debian /gói, Nơi gói là gói nhị phân đầu tiên được liệt kê trong debian / control.

Điều này hữu ích cho các gói nguồn đa nhị phân không phù hợp với
bố cục (nghĩa là các thư mục con riêng biệt, mỗi thư mục có lib/, bin/ Vân vân). Sử dụng cái này, tất cả các tệp
sẽ được cài đặt vào debian / tmpvà bạn có thể phân phối chúng thành các tệp nhị phân riêng biệt
gói bằng cách sử dụng debian / $ package.install các tệp hoặc các cuộc gọi trình bao rõ ràng trong
debian / quy tắc.

Trộn DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR và bố cục đa nhị phân không được hỗ trợ.

DH_RUBY_GEMSPEC
Xác định tệp nào chứa đặc tả đá quý bằng siêu dữ liệu gói. Qua
mặc định, dh_ruby sẽ đọc siêu dữ liệu từ tệp .gemspec trong thư mục gốc của gói nguồn
danh mục. Bạn có thể sử dụng biến này để ghi đè biến nếu bạn muốn cung cấp
siêu dữ liệu cho gói Debian.

Trong trường hợp có nhiều hơn một .gemspec trong gốc gói nguồn, bạn sẽ nhu cầu
sử dụng DH_RUBY_GEMSPEC để hướng dẫn dh_ruby về việc sử dụng cái nào.

Sử dụng dh_ruby trực tuyến bằng các dịch vụ onworks.net