dh - Online sa Cloud

PROGRAMA:

NAME

dh - debhelper command sequencer

SINOPSIS

dh pagkakasunud-sunod [--kasama addon[,addon ...]] [--listahan] [mga pagpipilian sa debhelper]

DESCRIPTION

dh nagpapatakbo ng isang sequence ng debhelper command. Ang suportado pagkakasunud-sunods tumutugma sa
mga target ng a debian/mga panuntunan file: build-arch, build-indep, magtayo, linisin, install-indep,
install-arch, install, binary-arch, binary-indep, at doble.

OVERRIDE MGA TARGET

A debian/mga panuntunan file gamit ang dh maaaring i-override ang command na pinapatakbo sa anumang hakbang sa a
sequence, sa pamamagitan ng pagtukoy ng override na target.

Upang i-override dh_command, magdagdag ng target na pinangalanan override_dh_command sa file ng mga patakaran. Kapag ito
ay karaniwang tatakbo dh_command, dh sa halip ay tatawagin ang target na iyon. Ang override na target ay maaari
pagkatapos ay patakbuhin ang command na may mga karagdagang opsyon, o magpatakbo na lang ng ganap na magkakaibang mga command.
Tingnan ang mga halimbawa sa ibaba.

Ang mga target na i-override ay maaari ding tukuyin na tatakbo lamang kapag ang pagbuo ng arkitektura ay nakasalalay o
mga independiyenteng pakete ng arkitektura. Gumamit ng mga target na may mga pangalan tulad ng override_dh_command-arko
at override_dh_command-indep. (Tandaan na para magamit ang feature na ito, dapat kang Mag-Build-Depend sa
debhelper 8.9.7 o mas mataas.)

Opsyon

--kasama addon[,addon ...]
Idagdag ang mga utos ng debhelper na tinukoy ng ibinigay na addon sa mga naaangkop na lugar sa
pagkakasunud-sunod ng mga utos na pinapatakbo. Ang pagpipiliang ito ay maaaring ulitin nang higit sa isang beses, o
maraming mga addon ang maaaring ilista, na pinaghihiwalay ng mga kuwit. Ito ay ginagamit kapag mayroong a
third-party na package na nagbibigay ng mga debhelper command. Tingnan ang PROGRAMMING file para sa
dokumentasyon tungkol sa sequence addon interface.

--nang wala addon
Ang kabaligtaran ng --kasama, hindi pinapagana gamit ang ibinigay na addon. Ang pagpipiliang ito ay maaaring ulitin
higit sa isang beses, o maraming addon na idi-disable ay maaaring ilista, na pinaghihiwalay ng mga kuwit.

--listahan, -l
Ilista ang lahat ng magagamit na mga addon.

--walang-kilos
Nagpi-print ng mga command na tatakbo para sa isang naibigay na sequence, ngunit hindi pinapatakbo ang mga ito.

Tandaan na karaniwang nilalaktawan ni dh ang pagpapatakbo ng mga utos na alam nitong walang magagawa. Sa
--no-act, ang buong listahan ng mga command sa isang sequence ay naka-print.

Ang iba pang mga opsyon ay ipinasa sa dh ay ipinapasa sa bawat utos na pinapatakbo nito. Ito ay maaaring gamitin upang itakda
isang pagpipilian tulad ng -v or -X or -N, pati na rin para sa mas espesyal na mga opsyon.

HALIMBAWA

Upang makita kung anong mga utos ang kasama sa isang pagkakasunud-sunod, nang hindi aktwal na gumagawa ng anuman:

dh binary-arch --no-act

Ito ay isang napaka-simpleng file ng mga panuntunan, para sa mga pakete kung saan ang mga default na pagkakasunud-sunod ng mga utos
gumana nang walang karagdagang mga opsyon.

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

Kadalasan gugustuhin mong magpasa ng opsyon sa isang partikular na utos ng debhelper. Ang madaling paraan gawin
with ay sa pamamagitan ng pagdaragdag ng override na target para sa command na iyon.

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

override_dh_strip:
dh_strip -Xfoo

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

Minsan ang automated dh_auto_configure(1) at dh_auto_build(1) hindi mahulaan kung ano ang gagawin
para sa kakaibang pakete. Narito kung paano maiwasan ang alinman sa pagtakbo at sa halip ay patakbuhin ang iyong sarili
utos.

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

override_dh_auto_configure:
./mondoconfig

override_dh_auto_build:
gawin universe-sumabog-sa-kasiyahan

Ang isa pang karaniwang kaso ay ang pagnanais na gumawa ng isang bagay nang manu-mano bago o pagkatapos ng isang partikular
Ang utos ng debhelper ay tumatakbo.

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

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

Kung ang iyong package ay gumagamit ng mga autotool at gusto mong magpasariwa config.sub at config.hulaan sa
mas bagong bersyon mula sa autotools-dev package sa oras ng pagbuo, maaari kang gumamit ng ilang mga utos
ibinigay sa autotools-dev na automate ito, tulad nito.

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

Ang mga tool sa Python ay hindi pinapatakbo ng dh bilang default, dahil sa patuloy na pagbabago sa lugar na iyon.
(Bago ang antas ng compatibility v9, tumatakbo ang dh dh_pysupport.) Narito kung paano gamitin dh_python2.

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

Narito kung paano pilitin ang paggamit ng Perl's Modyul::Buuin bumuo ng sistema, na maaaring kailanganin kung
Maling nakita ng debhelper na ang package ay gumagamit ng MakeMaker.

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

Narito ang isang halimbawa ng overriding kung saan ang dh_auto_* hanapin ng mga command ang pinagmulan ng package,
para sa isang pakete kung saan ang pinagmulan ay matatagpuan sa isang subdirectory.

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

At narito ang isang halimbawa kung paano sasabihin ang dh_auto_* mga utos na bumuo sa isang subdirectory,
na aalisin sa linisin.

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

Kung ang iyong package ay maaaring itayo nang magkatulad, mangyaring gamitin ang compat 10 o pass --parallel
sa dh. Pagkatapos dpkg-buildpackage -j magtatrabaho.

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

Kung hindi mapagkakatiwalaan ang iyong package habang gumagamit ng maraming thread, mangyaring pumasa
--walang-parallel sa dh (o ang nauugnay dh_auto_* utos):

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

Narito ang isang paraan upang maiwasan dh mula sa pagpapatakbo ng ilang mga utos na hindi mo gustong patakbuhin ito,
sa pamamagitan ng pagtukoy sa mga walang laman na override na target para sa bawat command.

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

# Mga utos na huwag tumakbo:
override_dh_auto_test override_dh_compress override_dh_fixperms:

Ang isang mahabang proseso ng pagbuo para sa isang hiwalay na pakete ng dokumentasyon ay maaaring paghiwalayin gamit
arkitektura independent overrides. Ang mga ito ay lalaktawan kapag nagpapatakbo ng build-arch at
binary-arch sequences.

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

override_dh_auto_build-indep:
$(MAKE) -C docs

# Walang mga pagsubok na kailangan para sa mga doc
override_dh_auto_test-indep:

override_dh_auto_install-indep:
$(MAKE) -Pag-install ng C docs

Pagdaragdag sa halimbawa sa itaas, ipagpalagay na kailangan mong mag-chmod ng isang file, ngunit kapag binuo lamang ang
package na nakasalalay sa arkitektura, dahil wala ito kapag gumagawa lamang ng dokumentasyon.

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

MGA INTERNAL

Kung curious ka dh's internals, narito kung paano ito gumagana sa ilalim ng hood.

Ang bawat debhelper command ay magtatala kapag ito ay matagumpay na tumakbo
debian/package.debhelper.log. (Alin dh_malinis nagtatanggal.) Kaya dh masasabi kung aling mga utos ang mayroon
naitakbo na, para sa kung aling mga pakete, at laktawan muli ang pagpapatakbo ng mga utos na iyon.

Sa bawat oras dh ay tumatakbo, sinusuri nito ang log, at hinahanap ang huling naka-log na utos na nasa
tinukoy na pagkakasunod-sunod. Pagkatapos ay nagpapatuloy ito sa susunod na utos sa pagkakasunud-sunod. Ang --hanggang,
--noon, --pagkatapos, at --natitira maaaring i-override ng mga opsyon ang gawi na ito.

Ang isang sequence ay maaari ding magpatakbo ng mga nakadependeng target sa debian/rules. Halimbawa, ang "binary"
pinapatakbo ng sequence ang target na "i-install".

dh ay gumagamit ng DH_INTERNAL_OPTIONS variable ng kapaligiran upang maipasa ang impormasyon sa
debhelper command na pinapatakbo sa loob ng override na mga target. Ang mga nilalaman (at sa katunayan,
pag-iral) ng environment variable na ito, gaya ng iminumungkahi ng pangalan, ay maaaring magbago
kahit anong oras.

Mga utos sa build-indep, install-indep at binary-indep ang mga sequence ay naipasa ang -i
opsyon upang matiyak na gumagana lamang ang mga ito sa mga independiyenteng pakete ng arkitektura, at mga utos sa
build-arch, install-arch at binary-arch ang mga sequence ay naipasa ang -a pagpipilian upang matiyak na sila
gumagana lamang sa mga package na umaasa sa arkitektura.

DEPRECATE NA Opsyon

Ang mga sumusunod na opsyon ay hindi na ginagamit. Mas mainam na gumamit na lang ng mga override na target.
Ang mga ito ay hindi magagamit sa compat 10.

--hanggang cmd
Patakbuhin ang mga utos sa pagkakasunud-sunod hanggang at kasama cmd, saka huminto.

--noon cmd
Patakbuhin ang mga utos sa pagkakasunud-sunod bago cmd, saka huminto.

--pagkatapos cmd
Patakbuhin ang mga utos sa sequence na susunod cmd.

--natitira
Patakbuhin ang lahat ng mga utos sa pagkakasunud-sunod na hindi pa tumatakbo.

Sa mga opsyon sa itaas, cmd ay maaaring isang buong pangalan ng isang debhelper command, o isang substring. Ito ay
maghanap muna ng command sa sequence na eksaktong tumutugma sa pangalan, upang maiwasan ang anuman
kalabuan. Kung maraming substring na tugma, ang huli sa sequence ay magiging
ginagamit.

Gamitin ang dh online gamit ang mga serbisyo ng onworks.net