ppkg-configp - Online sa Cloud

PROGRAMA:

NAME

PkgConfig - Pure-Perl Core-Only na kapalit para sa pkg-config

SINOPSIS

As a kapalit para "pkg-config"
$ ppkg-config --libs --cflags --static gio-2.0

#outputs (mga linyang artipisyal na pinaghiwa-hiwalay para madaling mabasa):
# -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include
# -pthread -lgio-2.0 -lz -lresolv -lgobject-2.0
# -lgmodule-2.0 -ldl -lgthread-2.0 -pthread -lrt -lglib-2.0

Maaaring gamitin ang "pkg-config.pl" bilang alias para sa "ppkg-config" sa mga platform na sumusuporta dito.
Maaari din itong i-install bilang "pkg-config" kahit na hindi ito inirerekomenda kung mayroon ang iyong system
isang katutubong "pkg-config".

Ikumpara sa:
$ pkg-config --libs --cflags --static gio-2.0

#outputs ( "" ):
# -pthread -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include
# -pthread -lgio-2.0 -lz -lresolv -lgobject-2.0 -lgmodule-2.0
# -ldl -lgthread-2.0 -lrt -lglib-2.0

mula sa isa pa Perl module
gumamit ng PkgConfig;

my $o = PkgConfig->find('gio');
if($o->errmsg) {
#hawakan ang error
} Iba pa {
aking $prefix = $o->get_var('prefix');
aking @cflags = $o->get_cflags;
my @ldflags = $o->get_ldflags;
}

DESCRIPTION

Nagbibigay ang "PkgConfig" ng pure-perl, core-only na kapalit para sa "pkg-config" na utility.

Ito ay hindi isang paglalarawan ng mga paggamit ng "pkg-config" ngunit sa halip ay isang paglalarawan ng
mga pagkakaiba sa pagitan ng C na bersyon at ng Perl.

Habang ang "pkg-config" ay isang pinagsama-samang binary na naka-link sa glib, ang pure-perl na bersyon ay walang
ganoong pangangailangan, at tatakbo saanman ginagawa ni Perl ( >= 5.6).

Ang mga pangunahing sinusuportahang opsyon ay ang karaniwang "--libs", "--cflags", "--static", "--exists" at
"--modversion".

sCRIPT Opsyon
PAGGAMIT

[ --options ]

MGA PANGANGATWIRANG

Bilang default, ang pangalan ng library ay dapat ibigay maliban kung ang isa sa --version, o --real-version ay
tinukoy.

Ang output ay dapat na karaniwang angkop para sa pagpasa sa iyong paboritong compiler.

--libs

(Gayundin) mag-print ng mga flag ng linker. Ang mga dependency ay tumatawid sa pagkakasunud-sunod. Ang mga top-level na dependencies ay
lalabas nang mas maaga sa command line kaysa sa mga dependency sa ilalim ng antas.

--libs-only-L

Nagpi-print ng -L/-R na bahagi ng "--libs". Tinutukoy nito ang landas ng paghahanap sa library ngunit walang mga library
Link na may.

--libs-only-l

Ini-print ang -l na bahagi ng "--libs".

--libs-only-other

Ini-print ang bahagi ng "--libs" na hindi sakop ng "--libs-only-L" at "--libs-only-l", gaya ng
"--pthread".

--listahan-lahat

Ilista ang lahat ng alam na pakete.

—-FLAGS

(Gayundin) mag-print ng compiler at C preprocessor na mga flag.

--cflags-lamang-ako

Ini-print ang -I na bahagi ng "--cflags"

--cflags-only-other

Ini-print ang mga bahagi ng "--cflags" na hindi sakop ng "--cflags-only-I".

--modversion

I-print ang bersyon ng isang ibinigay na pakete.

--static

Gumamit ng mga karagdagang dependency at library kung nagli-link laban sa isang static na bersyon ng hiniling
aklatan

--umiiral

Ibalik ang tagumpay (0) kung ang package ay umiiral sa landas ng paghahanap.

--with-path=PATH

Prepend "PATH" sa listahan ng mga path sa paghahanap na naglalaman ng ".pc" file.

Maaaring tukuyin ang opsyong ito nang maraming beses na may iba't ibang mga landas, at magiging lahat sila
idinagdag.

--env-lamang

Gamit ang opsyong ito, lamang ang mga landas na tinukoy sa "PKG_CONFIG_PATH" ay kinikilala at anumang mahirap-
binabalewala ang mga naka-code na default.

--hulaan-mga landas

I-invoke ang "gcc" at "ld" para matukoy ang default na linker at magsama ng mga path. Ang mga default na landas ay magiging
hindi kasama sa tahasang -L at -I na mga flag.

--define-variable=VARIABLE=VALUE

Tukuyin ang isang variable, i-override ang anumang naturang variable na kahulugan sa .pc file, at pagpayag
ang iyong halaga upang i-interpolate sa mga kasunod na gamit.

--variable=VARIABLE

Ibinabalik nito ang halaga ng isang variable na tinukoy sa .pc file ng isang package.

--print-mga variable

I-print ang lahat ng tinukoy na variable na makikita sa mga .pc file.

--bersyon

Ang target na bersyon ng "pkg-config" na tinularan ng script na ito

--tunay na bersyon

Ang aktwal na bersyon ng script na ito

--debug

I-print ang impormasyon sa pag-debug

--katahimikan-mga pagkakamali

I-off ang mga error. Ito ang default para sa mga argumentong hindi libs/cflag/modversion

--print-error

Mga error sa pag-print sa STDERR at nangunguna sa "--silence-errors"

--maikling-error

Hindi pinansin, ngunit kinikilala para sa pagiging tugma.

--errors-to-stdout

Mga error sa pag-print sa STDOUT at nangunguna sa "--print-errors"

Kapaligiran

ang mga variable na "PKG_CONFIG_PATH" at "PKG_CONFIG_LIBDIR" ay pinarangalan at ginagamit bilang colon-
delimited (semicolon-delimited sa Windows) na listahan ng mga direktoryo na naglalaman ng mga ".pc" na file.

Ang iba pang mga variable ng kapaligiran na na-recognize ng parehong "pkg-config" at PkgConfig ay kinabibilangan ng:

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
PKG_CONFIG_ALLOW_SYSTEM_LIBS

Kung ang Win32API::Registry ay naka-install, sa Windows (ngunit hindi Cygwin) PkgConfig ay din
kumonsulta sa mga registry key na ito. Ang mga pangalan ay hindi pinapansin, ngunit ang mga halaga ay mga landas na naglalaman
".pc" na mga file.

HKEY_CURRENT_USER\Software\pkgconfig\PKG_CONFIG_PATH
HKEY_LOCAL_MACHINE\Software\pkgconfig\PKG_CONFIG_PATH

Ang suporta sa rehistro ay dapat ituring na medyo eksperimental, maaaring magbago sa
hinaharap, bagaman hindi nang walang magandang dahilan. Ang katwiran para sa caveat na ito ay na ito
Ang feature ay nakadokumento sa ilang lugar, ngunit wala pa akong mahanap na gumaganang bersyon na iyon
nagpapatupad ng tampok na ito.

MODYUL Opsyon
PkgConfig->hanapin

my $result = PkgConfig->find($libary, %options);

Maghanap ng library at magbalik ng resultang object. Ang $library ay maaaring maging isang solong pangalan ng a
library, o isang reference sa isang hanay ng mga pangalan ng library

Ang mga opsyon ay nasa anyo ng mga hash key at value, at ang mga sumusunod ay kinikilala:

"search_path"
"search_path_override"
I-prepend ang mga path sa paghahanap bilang karagdagan sa mga path na tinukoy sa $ENV{PKG_CONFIG_PATH} Ang
ang value ay isang array reference.

binabalewala ng variant na "_override" ang mga default (tulad ng "PKG_CONFIG_PATH").

"file_path"
Tinutukoy ang buong landas ng .pc file na nais mong i-load. Hindi ito
kailangang nasa landas ng paghahanap (bagaman ang anumang mga dependency ay kailangang maging). Kapaki-pakinabang kung
alam mo ang buong landas ng eksaktong .pc file na gusto mo.

"exclude_cflags"
"exclude_ldflags"
"exclude_cflags_override"
"exclude_ldflags_override"
Tinukoy ng ilang ".pc" na file ang default na compiler at linker na mga path sa paghahanap, hal
"-I/usr/include -L/usr/lib". Ang pagtukoy sa kanila sa command line ay maaaring maging problema bilang
binago nito nang husto ang pagkakasunud-sunod ng paghahanap.

Ang mga opsyon sa itaas ay maaaring idagdag o papalitan ang mga opsyon na hindi kasama at
sinala.

Ang default na ibinukod na linker at mga pagpipilian sa compiler ay maaaring makuha sa pamamagitan ng
@PkgConfig::DEFAULT_EXCLUDE_LFLAGS at @PkgConfig::DEFAULT_EXCLUDE_CFLAGS,
ayon sa pagkakabanggit.

"static"
Tukuyin din ang mga static na aklatan.

"no_recurse"
Huwag ulitin ang mga dependency. Ito ay kapaki-pakinabang para sa paggawa lamang ng mga pagsusuri sa bersyon.

"VARS"
Tukuyin ang isang hashref ng mga variable upang i-override ang anumang mga kahulugan ng variable sa loob ng .pc
mga file. Ito ay katumbas ng "--define-variable" na opsyon sa command-line.

Ang isang bagay na "PkgConfig" ay ibinalik at maaaring itanong tungkol sa mga resulta:

$o->errmsg

Isang mensahe ng error, kung mayroon man. Ito ay isang string at nagpapahiwatig ng isang error.

$o->pkg_exists

Boolean value, true kung umiiral ang package.

$o->pkg_version

Ang bersyon ng package

$o->get_cflags

$o->get_ldflags

Nagbabalik ng mga flag ng compiler at linker, ayon sa pagkakabanggit.

Sa konteksto ng listahan, ang mga pamamaraang ito ay nagbabalik ng isang listahan na may bawat paghahati ng argumento sa mga hindi nakatakas na espasyo.

Sa konteksto ng listahan ay nagbabalik ng isang listahan ng mga flag ng compiler at linker, ayon sa pagkakabanggit.

Sa kontekstong scalar ay nagbabalik ng isang string ng mga flag ng compiler at linker na may mga puwang at mga quote
nakatakas ng tama.

$o->get_var($name)

Kunin ang variable na may ibinigay na pangalan.

PkgConfig->Hulaan

Isa itong paraan ng klase, at papalitan ang hard-coded na default na linker at isasama ang mga path
kasama ang mga natuklasan sa pamamagitan ng pagtawag ld(1) at cppNa (1).

Sa kasalukuyan, gumagana lang ito sa "ld" na ibinigay ng GCC at "ld" ng GNU.

INSTALL
Ang "Makefile.PL" na kasama ng "PkgConfig" ay maaaring tumagal ng isa o higit pang "--script" na mga opsyon upang
pagbabago ng pangalan ng script o mga script na naka-install.

--script ppkg-config
Ito ang default at gumagana sa lahat ng platform

--script pkg-config.pl
Naka-install ito bilang default sa lahat ng platform maliban sa Windows, kung saan maaaring ang .pl
lituhin ang shell at maging sanhi ng pagbukas ng script sa isang text editor.

--script pkg-config
Ito ang default na pangalan ng tunay na "pkg-config" at kaya kailangan mong partikular
paganahin ito kung gusto mo ito.

--script wala
Huwag mag-install ng anumang mga script.

Halimbawa, i-install ang lahat ng pangalan ng script:

% perl Makefile.PL --script ppkg-config --script pkg-config.pl --script pkg-config

Halimbawa, huwag mag-install ng anumang mga script:

% perl Makefile.PL --script wala

Maaari mo ring itakda ang environment variable na PERL_PKG_CONFIG_SCRIPTS sa gustong --script
value (paghihiwalay sa bawat pangalan ng script gamit ang kuwit ",") upang matiyak na ang mga pag-upgrade ng PkgConfig
gawin ang parehong.

MGA CAVEATS
Sa Strawberry Perl ang "ppkg-config" ay kumikilos na parang Strawberry ang system. Ibig sabihin nito

· Ang mga .pc na file na kasama ng Strawberry ay hinahanap bilang default.

· Ang Strawberry kasama at lib na mga direktoryo ay ginagamit upang kalkulahin ang mga listahan ng pagbubukod.

Mula sa Strawberry 5.20.0.1 ang PkgConfig ay kasama ng Strawberry at ang "pkg-config" ay
naka-install bilang default (bilang karagdagan sa "ppkg-config", kahit na ang "ppkg-config" alias ay HINDI
bundle ng Strawberry mismo).

Para sa mga detalye kung paano i-patch ang mga .pc file na kasama ng mas lumang Strawberries, tingnan ang
"README.win32" na kasama nitong Distribusyon.

TUMBOK
Ang pagkakasunud-sunod ng mga flag ay hindi eksaktong tumutugma sa "pkg-config". Mula sa aking sarili
obserbasyon, tila mas maganda ang ginagawa ng modyul na ito, ngunit maaaring mali ako.

Hindi tulad ng "pkg-config", ang mga script na "--exists" na function ay magbabalik ng nonzero kung isang package or
alinman sa mga dependency nito ay nawawala. Ito ay naiiba sa pag-uugali ng "pkg-config" na
susuriin lamang ang kahulugan ng package mismo (nang walang dependencies).

Gumamit ng ppkg-configp online gamit ang mga serbisyo ng onworks.net