dh - آنلاین در ابر

برنامه:

نام

dh - ترتیب دهنده دستور debhelper

خلاصه

dh دنباله [--با افزونه[,افزونه ...]] [-- لیست] [گزینه های debhelper]

شرح

dh دنباله ای از دستورات debhelper را اجرا می کند. پشتیبانی شده دنبالهs مطابقت دارد
اهداف الف دبیان/قوانین فایل: ساخت-طاق, ساخت مستقل, ساختن, تمیز, install-indep,
نصب-طاق, نصب, باینری-قوس, باینری مستقلو دوتایی.

بیش از حد اهداف

A دبیان/قوانین پرونده با استفاده از dh می تواند دستوری را که در هر مرحله از a اجرا می شود لغو کند
دنباله، با تعریف یک هدف لغو.

نادیده گرفتن dh_command، یک هدف به نام اضافه کنید لغو_dh_command به فایل قوانین زمانی که آن را
به طور معمول اجرا می شود dh_command, dh در عوض آن هدف را فراخوانی خواهد کرد. هدف لغو می تواند
سپس دستور را با گزینه های اضافی اجرا کنید، یا به جای آن دستورات کاملا متفاوت را اجرا کنید.
نمونه های زیر را ببینید.

اهداف لغو را نیز می‌توان برای اجرا فقط در زمانی که معماری وابسته یا وابسته است، تعریف کرد
بسته های مستقل معماری از اهداف با نام هایی مانند استفاده کنید لغو_dh_command-ارشی
و لغو_dh_commandمستقل. (توجه داشته باشید که برای استفاده از این ویژگی باید Build-Depend on را انتخاب کنید
debhelper 8.9.7 یا بالاتر.)

OPTIONS

--با افزونه[,افزونه ...]
دستورات debhelper مشخص شده توسط افزونه داده شده را به مکان های مناسب در اضافه کنید
دنباله ای از دستورات اجرا شده این گزینه را می توان بیش از یک بار تکرار کرد، یا
افزونه های متعددی را می توان فهرست کرد که با کاما از هم جدا می شوند. این زمانی استفاده می شود که یک وجود داشته باشد
بسته شخص ثالث که دستورات debhelper را ارائه می دهد. را ببینید برنامه نويسي پرونده برای
مستندات در مورد رابط افزونه توالی.

--بدون افزونه
معکوس از --با، با استفاده از افزونه داده شده غیرفعال می شود. این گزینه قابل تکرار است
بیش از یک بار، یا افزونه های متعدد برای غیرفعال کردن را می توان لیست کرد، با کاما از هم جدا شدند.

-- لیست, -l
لیست همه افزونه های موجود

-- بدون عمل
دستوراتی را چاپ می کند که برای یک دنباله مشخص اجرا می شوند، اما آنها را اجرا نمی کند.

توجه داشته باشید که dh معمولاً از دستورات اجرائی که می‌داند هیچ کاری انجام نمی‌دهند، صرفنظر می‌کند. با
--no-act، لیست کامل دستورات در یک دنباله چاپ می شود.

گزینه های دیگر به dh به هر دستوری که اجرا می کند منتقل می شود. از این می توان برای تنظیم استفاده کرد
گزینه ای مانند -v or -X or -Nو همچنین برای گزینه های تخصصی تر.

مثال ها

برای اینکه ببینید چه دستوراتی در یک دنباله گنجانده شده است، بدون اینکه واقعاً کاری انجام دهید:

dh biary-arch --no-act

این یک فایل قوانین بسیار ساده است، برای بسته هایی که توالی دستورات پیش فرض در آن ها وجود دارد
بدون هیچ گزینه اضافی کار کنید

#!/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.guess با
نسخه های جدیدتر از autotools-dev بسته در زمان ساخت، می توانید از برخی دستورات استفاده کنید
ارائه شده در autotools-dev که آن را خودکار می کند، مانند این.

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

به دلیل تغییر مداوم در آن ناحیه، ابزارهای پایتون به‌طور پیش‌فرض توسط dh اجرا نمی‌شوند.
(قبل از سطح سازگاری v9، dh اجرا می شود dh_pysupport.) در اینجا نحوه استفاده آمده است dh_python2.

#!/usr/bin/make -f
%:
dh $@ --با پایتون2

در اینجا نحوه استفاده اجباری از Perl's آورده شده است ماژول:: ساخت ساخت سیستم، که می تواند ضروری باشد اگر
debhelper به اشتباه تشخیص می دهد که بسته از MakeMaker استفاده می کند.

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

در اینجا یک مثال از overriding که در آن 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_ پاک حذف می کند.) بنابراین dh می تواند بگوید کدام دستورات دارند
قبلا اجرا شده است، برای کدام بسته ها، و از اجرای دوباره آن دستورات بگذرید.

هر زمان dh اجرا می شود، log را بررسی می کند و آخرین فرمان ثبت شده را پیدا می کند
توالی مشخص شده سپس با دستور بعدی در دنباله ادامه می یابد. در --تا زمان,
--قبل از, --بعد ازو -- باقی مانده گزینه ها می توانند این رفتار را نادیده بگیرند.

یک دنباله همچنین می تواند اهداف وابسته را در دبیان/قوانین اجرا کند. به عنوان مثال، "دودویی"
sequence هدف "نصب" را اجرا می کند.

dh با استفاده از DH_INTERNAL_OPTIONS متغیر محیطی برای انتقال اطلاعات به
دستورات debhelper که در داخل اهداف اجرا می شوند. مطالب (و در واقع،
وجود) این متغیر محیطی، همانطور که از نام ممکن است نشان دهد، ممکن است تغییر کند
هروقت.

دستورات در ساخت مستقل, install-indep و باینری مستقل دنباله ها منتقل می شوند -i
گزینه ای برای اطمینان از اینکه آنها فقط روی بسته های مستقل معماری و دستورات موجود در آن کار می کنند
ساخت-طاق, نصب-طاق و باینری-قوس دنباله ها منتقل می شوند -a گزینه ای برای اطمینان از آنها
فقط روی بسته های وابسته به معماری کار کنید.

منسوخ OPTIONS

گزینه های زیر منسوخ شده اند. خیلی بهتر است به جای آن از اهداف لغو استفاده کنید.
آنها نه در compat 10 موجود است.

--تا زمان CMD
دستورات را به ترتیب تا و شامل اجرا کنید CMD، سپس متوقف شود.

--قبل از CMD
دستورات را به ترتیب قبل اجرا کنید CMD، سپس متوقف شود.

--بعد از CMD
دستورات را به ترتیب بعدی اجرا کنید CMD.

-- باقی مانده
تمام دستوراتی را که هنوز اجرا نشده اند به ترتیب اجرا کنید.

در گزینه های بالا، CMD می تواند نام کامل یک فرمان debhelper یا یک رشته فرعی باشد. خواهد شد
ابتدا دستوری را در دنباله ای که دقیقاً با نام مطابقت دارد جستجو کنید تا از هر گونه فرمانی اجتناب کنید
گنگ. اگر چندین زیررشته منطبق وجود داشته باشد، آخرین مورد در دنباله خواهد بود
استفاده شده.

با استفاده از خدمات onworks.net از dh آنلاین استفاده کنید