dh_ruby - מקוון בענן

תָכְנִית:

שֵׁם

dh_ruby - מערכת בניית debhelper7 עבור תוכנת Ruby

תַקצִיר

dh_ruby [אפשרויות]

תיאור

dh_ruby היא מערכת Debhelper 7 לבנות עבור תוכנת Ruby. זה יבנה אוטומטית ו
להתקין קבצים הכלולים בחבילות Ruby, תוך ניסיון לעבוד קרוב ככל האפשר ל-Rubygems
אך מכבדים את תקני דביאן עבור חבילות רובי.

dh_ruby יכול להריץ אוטומטית את הבדיקות שלך מול כל גרסאות Ruby הנתמכות, ראה את
הקטע "קבצים" למטה.

ראה dh_ruby --עזרה לפרטים.

מקור חֲבִילָה מערך

dh_ruby תומך בשני סגנונות שונים של חבילות מקור: חבילות מקור יחיד-בינאריות, ו
חבילות מקור רב-בינאריות.

יחיד-בינארי פריסה
פריסת ברירת המחדל היא יחיד-בינארי מַעֲרָך. זו הפריסה שבה משתמשים רוב רובי
חבילות במעלה הזרם, כלומר Ruby code in lib/, תוכניות הפעלה ב בן/ וכו' חבילות
מיובא מ-Rubigems באמצעות gem2deb(1) תהיה הפריסה הזו.

בעת שימוש בפריסה זו, dh_ruby יתקין קבצים (קוד רובי, קובצי הפעלה, מפרט ערך) ל
מה היא ראשון בינרי חבילה רשום ב דביאן / שליטה.

רב בינארי פריסה
gem2deb גרסה 0.4.0 הציג תמיכה עבור רב בינארי מַעֲרָך. פריסה זו צריכה
לשמש כאשר יש לך קבוצה של חבילות Ruby שונות המתוחזקות במעלה הזרם ביחיד
VCS, ואתה מחליט שאתה רוצה גם לשמור על חבילת מקור אחת בדביאן
בעל הרכיבים השונים כחבילות בינאריות נפרדות.

בפריסה זו, חבילת המקור מכילה את הרכיבים הנפרדים בספריות המשנה
שבו כל אחד מהם ישתמש בפריסת רובי הסטנדרטית (lib/, בן/, וכו).

פריסה זו אינה תומכת ביצירת חבילות בינאריות נפרדות מאותו שורש
מַדרִיך. למקרים אלה, עיין בתיעוד על DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
לְהַלָן.

כדי לציין שברצונך להשתמש בפריסה רב-בינארית, עלינו 1) לרשום את הכפולה שלך
חבילות בינאריות ב דביאן / שליטה כרגיל, והוסיפו שדה נוסף שנקרא X-DhRuby-Root ל
כל בית חבילה בינארית, המציין באיזו ספרייה יש להשתמש בתור השורש לכך
חבילה בינארית.

דוגמה:

מקור: mymultibinarypackage
[...]

חבילה: רובי-פו
X-DhRuby-Root: path/to/foo
[...]

חבילה: אודם-בר
X-DhRuby-Root: נתיב/to/bar

חבילת המקור המתאימה צריכה להיות פרוסה כך:

foo /
foo.gemspec
lib /
foo.rb
bin/foo
בָּר/
bar.gemspec
lib /
bar.rb
פַּח/
בָּר

הערות חשובות לגבי חבילות רב-בינאריות והשימוש ב X-DhRuby-Root:

· אם החבילה שלך משתמשת בפריסה הרב-בינארית, עליה לכלול `gem2deb (>= 0.4.0~)` in
בנייה תלויה.

גִרְסָה 0.4.0 היה a באג in מה היא תמיכה ל יליד סיומות בחבילות רב בינאריות,
כך שאם החבילה שלך משתמשת בתכונה הרב-בינארית ולפחות אחת מתת-
לרכיבים יש הרחבות מקוריות, עליך להשתמש ב- `gem2deb (>= 0.4.1~)` in בנייה תלויה
במקום.

· הנתיב המצוין ב X-DhRuby-Root, כפי שבטח ניחשתם עד עכשיו, חייב להיות
יחסית לשורש חבילת המקור.

· אם חבילה בינארית כלשהי מצהירה על א X-DhRuby-Root שדה, כל שאר החבילות הבינאריות ש
אין אחד יתעלם על ידי dh_ruby.

אפשרויות

--לְנַקוֹת, --להגדיר, --לִבנוֹת, --מִבְחָן, --להתקין
פקודות שנקראו על ידי debhelper בשלבים שונים של תהליך הבנייה.

-- נתמך בהדפסה
מדפיס את גרסאות רובי הנתמכות.

-h, - עזרה
מציג dh_ruby מידע על השימוש.

-v, --גִרְסָה
מציג dh_ruby מידע על הגרסה.

--gem-install
אפשרות זו מציינת שה-build צריך להשתמש ב- פנינה פקודה להתקנת הקבצים,
במקום המתקין תוצרת בית. חבילות מקוריות יותקנו ב
/ usr / lib /$ARCH/rubygems-integration/$RUBY_VERSION, בעוד חבילות רובי טהורות יהיו
מותקן ל /usr/share/rubygems-integration/all.

--setuprb
אפשרות זו מציינת שה-build צריך להשתמש setup.rb במקום פנינה הרגילה-
בנייה מבוססת. כדי להיכנס לתוקף, אפשרות זו חייבת לבוא קודם!

הסביבה וריאציות

DH_RUBY
השתמש במשתנה זה כדי להעביר פרמטרים של שורת הפקודה ל-dh_ruby. למשל ב
דביאן/כללים:

ייצוא DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
זוהי רשימה מופרדת מרווחים של בדיקות ש-dh_ruby יתעלם מהם במהלך בניית החבילה.
שמות הבדיקות הזמינים הם השמות של כל גרסאות רובי הנתמכות (תוכל לרשום
אותם עם `dh_ruby --תומך בהדפסה`).

אם מוגדר ל"הכל", כל הבדיקות יתעלמו במהלך בניית החבילה.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
אם המשתנה הזה מוגדר (לכל דבר), dh_ruby יכבד את הספרייה המודיעה
by dh_auto_install(1), בדרך כלל debian/tmp. כברירת מחדל, gem2deb יתקין קבצים ל
דביאן/חבילה, שם חבילה היא החבילה הבינארית הראשונה הרשומה ב-debian/control.

זה שימושי עבור חבילות מקור רב-בינאריות שאינן תואמות לחבילות הנתמכות
פריסה (כלומר ספריות משנה נפרדות שכל אחת מהן lib/, בן/ וכו). באמצעות זה, כל הקבצים
יותקן ל debian/tmp, ואתה יכול להפיץ אותם לבינארי נפרד
חבילות באמצעות debian/$package.install קבצים או שיחות מעטפת מפורשות פנימה
דביאן/כללים.

ערבוב DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR ופריסה רב-בינארית אינה נתמכת.

DH_RUBY_GEMSPEC
קובע איזה קובץ מכיל את מפרט החן עם מטא נתונים של החבילה. על ידי
ברירת מחדל, dh_ruby יקרא מטא נתונים מקובץ .gemspec בשורש חבילת המקור
מַדרִיך. אתה יכול להשתמש במשתנה זה כדי לעקוף את זה אם אתה רוצה לספק מותאם אישית
מטא נתונים עבור חבילת דביאן.

במקרה שיש יותר מ-.gemspec אחד בשורש חבילת המקור, תעשה זאת צורך
להשתמש ב-DH_RUBY_GEMSPEC כדי להורות ל-dh_ruby באיזה מהם להשתמש.

השתמש ב-dh_ruby באינטרנט באמצעות שירותי onworks.net