dh - מקוון בענן

תָכְנִית:

שֵׁם

dh - רצף הפקודות של debhelper

תַקצִיר

dh רצף [--עם addon[,addon ...]] [--רשימה] [אפשרויות debhelper]

תיאור

dh מפעיל רצף של פקודות debhelper. הנתמכים רצףs תואם את
מטרות של א דביאן/כללים קובץ: build-arch, בנייה לעומק, לִבנוֹת, לְנַקוֹת, התקנת אינדפ,
install-arch, להתקין, בינארי-קשת, אינדפ בינארי, ו בינרי.

עקוף יעדים

A דביאן/כללים שימוש בקובץ dh יכול לעקוף את הפקודה המופעלת בכל שלב ב-a
רצף, על ידי הגדרת יעד ביטול.

לעקוף dh_command, הוסף יעד בשם לעקוף_dh_command לקובץ הכללים. כשזה
ירוץ בדרך כלל dh_command, dh במקום זאת יקרא למטרה הזו. יעד העקיפה יכול
לאחר מכן הפעל את הפקודה עם אפשרויות נוספות, או הפעל במקום זאת פקודות אחרות לגמרי.
ראה דוגמאות למטה.

ניתן גם להגדיר יעדי עקיפה כך שיפעלו רק כאשר בנייה תלויה באדריכלות או
חבילות עצמאיות לארכיטקטורה. השתמש במטרות עם שמות כמו לעקוף_dh_command-קֶשֶׁת
ו לעקוף_dh_command- אינדפ. (שים לב שכדי להשתמש בתכונה זו, עליך לבנות-תלוי
debhelper 8.9.7 ומעלה.)

אפשרויות

--עם addon[,addon ...]
הוסף את פקודות debhelper שצוינו על ידי התוסף הנתון למקומות המתאימים ב-
רצף הפקודות המופעל. ניתן לחזור על אפשרות זו יותר מפעם אחת, או
ניתן לפרט מספר תוספות, מופרדות בפסיקים. זה משמש כאשר יש א
חבילת צד שלישי המספקת פקודות debhelper. ראה את תִכנוּת עבור
תיעוד על ממשק תוספות הרצף.

--לְלֹא addon
ההפך של --עם, משבית את השימוש בתוסף הנתון. ניתן לחזור על אפשרות זו
יותר מפעם אחת, או שניתן לרשום מספר תוספות להשבתה, מופרדים בפסיקים.

--רשימה, -l
רשום את כל התוספות הזמינות.

--אין מעשה
מדפיס פקודות שיפעלו עבור רצף נתון, אך לא מפעיל אותן.

שים לב שבדרך כלל dh מדלג על פקודות הרצות שהוא יודע שלא יעשו כלום. עם
--no-act, הרשימה המלאה של הפקודות ברצף מודפסת.

אפשרויות אחרות עברו ל dh מועברים לכל פקודה שהיא מריץ. זה יכול לשמש כדי להגדיר
אפשרות כמו -v or -X or -N, כמו גם עבור אפשרויות מיוחדות יותר.

דוגמאות

כדי לראות אילו פקודות נכללות ברצף, מבלי לעשות דבר:

dh בינארי-קשת --ללא מעשה

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

#!/usr/bin/make -f
%:
dh $@

לעתים קרובות תרצה להעביר אפשרות לפקודת debhelper ספציפית. הדרך הקלה לעשות
עם הוא על ידי הוספת יעד ביטול עבור אותה פקודה.

#!/usr/bin/make -f
%:
dh $@

override_dh_strip:
dh_strip -Xfoo

override_dh_auto_configure:
dh_auto_configure -- --with-foo --disable-bar

לפעמים האוטומטי dh_auto_configure(1) ו dh_auto_build(1) לא יכול לנחש מה לעשות
עבור חבילה מוזרה. הנה איך להימנע מריצה ובמקום זאת להפעיל משלך
פקודות.

#!/usr/bin/make -f
%:
dh $@

override_dh_auto_configure:
./mondoconfig

override_dh_auto_build:
לגרום ליקום להתפוצץ בהנאה

מקרה שכיח נוסף הוא רצון לעשות משהו באופן ידני לפני או אחרי מסוים
פקודת debhelper מופעלת.

#!/usr/bin/make -f
%:
dh $@

override_dh_fixperms:
dh_fixperms
chmod 4755 debian/foo/usr/bin/foo

אם החבילה שלך משתמשת בכלים אוטומטיים ואתה רוצה להתרענן config.sub ו config.gueess עם
גרסאות חדשות יותר מ- autotools-dev חבילה בזמן הבנייה, אתה יכול להשתמש בפקודות מסוימות
מסופק ב autotools-dev שעושה את זה אוטומטי, ככה.

#!/usr/bin/make -f
%:
dh $@ --עם autotools_dev

כלי Python אינם מופעלים על ידי dh כברירת מחדל, עקב השינוי המתמיד באזור זה.
(לפני רמת התאימות v9, dh אכן פועל dh_pysupport.) הנה איך להשתמש dh_python2.

#!/usr/bin/make -f
%:
dh $@ --עם python2

הנה איך לכפות שימוש ב-Perl's מודול :: בנה לבנות מערכת, שיכולה להיות נחוצה אם
debhelper מזהה בטעות שהחבילה משתמשת ב-MakeMaker.

#!/usr/bin/make -f
%:
dh $@ --buildsystem=perl_build

הנה דוגמה לעקוף שבו dh_auto_* פקודות מוצאות את מקור החבילה,
עבור חבילה שבה המקור ממוקם בספריית משנה.

#!/usr/bin/make -f
%:
dh $@ --sourcedirectory=src

והנה דוגמה כיצד לספר את dh_auto_* פקודות לבנות בתיקיית משנה,
אשר יוסר ב לְנַקוֹת.

#!/usr/bin/make -f
%:
dh $@ --builddirectory=build

אם ניתן לבנות את החבילה שלך במקביל, אנא השתמש ב-compat 10 או עבר --מַקְבִּיל
ל-dh. לאחר מכן dpkg-buildpackage -j יעבוד.

#!/usr/bin/make -f
%:
dh $@ --מקביל

אם לא ניתן לבנות את החבילה שלך בצורה מהימנה תוך שימוש במספר שרשורים, אנא עברו
--לא מקביל ל-dh (או הרלוונטי dh_auto_* פקודה):

#!/usr/bin/make -f
%:
dh $@ --לא מקביל

הנה דרך למנוע dh מהפעלת מספר פקודות שאינך רוצה שיפעלו,
על ידי הגדרת יעדי עקיפה ריקים עבור כל פקודה.

#!/usr/bin/make -f
%:
dh $@

# פקודות לא לרוץ:
override_dh_auto_test override_dh_compress override_dh_fixperms:

תהליך בנייה ארוך עבור חבילת תיעוד נפרדת ניתן להפריד באמצעות
עקיפות בלתי תלויות בארכיטקטורה. אלה ידלגו בעת הפעלת build-arch ו
רצפי קשת בינארית.

#!/usr/bin/make -f
%:
dh $@

override_dh_auto_build-indep:
$(MAKE) -C מסמכים

# אין צורך בבדיקות למסמכים
override_dh_auto_test-indep:

override_dh_auto_install-indep:
$(MAKE) -C התקנת מסמכים

הוספת לדוגמא שלמעלה, נניח שאתה צריך chmod קובץ, אבל רק בעת בניית
חבילה תלוית ארכיטקטורה, מכיוון שהיא אינה קיימת בעת בניית תיעוד בלבד.

override_dh_fixperms-arch:
dh_fixperms
chmod 4755 debian/foo/usr/bin/foo

פנימיות

אם אתה סקרן לגבי dhהפנימיות של, הנה איך זה עובד מתחת למכסה המנוע.

כל פקודת debhelper תתעד כשהיא מופעלת בהצלחה
debian/package.debhelper.log. (איזה dh_clean מוחק.) אז dh יכול לדעת אילו פקודות יש
כבר הופעל, עבור אילו חבילות, ודלג על הפעלת הפקודות הללו שוב.

בכל פעם dh מופעל, הוא בוחן את היומן ומוצא את הפקודה האחרונה שנרשמה ב-
רצף שצוין. לאחר מכן הוא ממשיך עם הפקודה הבאה ברצף. ה --עד,
--לפני, --לאחר, ו --נוֹתָר אפשרויות יכולות לעקוף התנהגות זו.

רצף יכול גם להריץ יעדים תלויים בדביאן/כללים. לדוגמה, ה"בינארי"
רצף מריץ את יעד ה"התקנה".

dh משתמש DH_INTERNAL_OPTIONS משתנה סביבה להעביר אליו מידע
פקודות debhelper המופעלות בתוך מטרות עוקפות. התוכן (ואכן,
existence) של משתנה סביבה זה, כפי שהשם עשוי לרמוז, נתון לשינוי
בכל זמן.

פקודות ב בנייה לעומק, התקנת אינדפ ו אינדפ בינארי רצפים מועברים את -i
אפשרות להבטיח שהם עובדים רק על חבילות עצמאיות בארכיטקטורה, ופקודות ב-
build-arch, install-arch ו בינארי-קשת רצפים מועברים את -a אפשרות להבטיח אותם
עובד רק על חבילות תלויות ארכיטקטורה.

הוחלש אפשרויות

האפשרויות הבאות הוצאו משימוש. הרבה יותר טוב להשתמש ביעדי עקיפה במקום זאת.
הם לֹא זמין ב-compat 10.

--עד cmd
הפעל פקודות ברצף עד וכולל cmd, ואז תפסיק.

--לפני cmd
הפעל פקודות ברצף שלפני cmd, ואז תפסיק.

--לאחר cmd
הפעל פקודות ברצף שבא לאחר מכן cmd.

--נוֹתָר
הפעל את כל הפקודות ברצף שטרם הופעלו.

באפשרויות לעיל, cmd יכול להיות שם מלא של פקודת debhelper, או מחרוזת משנה. זה יהיה
חפש תחילה פקודה ברצף התואם בדיוק את השם, כדי להימנע מכל
דו משמעות. אם יש התאמת מחרוזת משנה מרובת, האחרונה ברצף תהיה
מְשׁוּמָשׁ.

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