Balíčkovací systém Arch Linuxu - 3 (PKGBUILD, makepkg, AUR)

9. 5. 2007 | Vojtěch Gondžala

Články - Balíčkovací systém Arch Linuxu - 3 (PKGBUILD, makepkg, AUR)  

V tomto díle si ukážeme, jak vytvořit vlastní balíček, a jak takový balíček poskytnout ostatním uživatelům.

Úvod

Pro vytváření balíčku máme v Arch Linuxu skript makepkg, který podle instrukcí v souboru PKGBUILD sestaví balíček; ten lze následně nainstalovat pacmanem. PKGBUILDy jsou tedy jakousi obdobou ebuidů z Gentoo Linuxu.

Pokud chcete poskytnout balíček ostatním, pak je nejlepší umístit jej do AURu (ArchLinux User-community Repository). Je to nebinární repozitář, nachází se v něm jen PKGBUILDy.

Každý balíček musí splňovat Standardy balíčků Archu. Jde o omezení názvů balíčků, způsob verzování, omezení adresářů, do kterých se instaluje software, a několik dalších doporučení. Jen PKGBUILD, který splňuje tato pravidla, může být umístěn do AURu. Vše, co porušuje pravidla, je smazáno, o což se starají správci i samotní uživatelé, kteří tyto prohřešky hlásí.

PKGBUILD

Popisován je PKGBUILD pro makepkg 3.0.x, starší verze makepkg nemusely vyžadovat všechny direktivy.

Uvedeme si příklad a vysvětlíme si jednotlivé direktivy a volby:

# Maintainer: An Archist <archist@archlinux.org>
# Contributor: Big Boss  <bigboss@sf.net>
pkgname = helloworld
pkgver = 0.4
pkgrel = 1
pkgdesc = "helloworld: a kernel module and a userspace daemon \
 for controlling an atomic bomb"
url = "http://www.helloworld.sf.net"
arch = ('i686' 'x86_64')
license = ('GPL' 'LGPL')
replaces = ('helloworld-rc' 'helloworld-test')
depend = ('kernel26')
conflict = ('libatomicbomb' 'goodbyeworld')
provides = ('libatomicbomb' 'goodbyeworld')
backup = ('etc/helloworld.conf')
install = $pkgname.install
source = ('http://www.helloworld.sf.net/source/$pkgname-$pkgver.tar.gz')
md5sums = ('a3290cbce4ffabbf91ccb1e9fce64d9e')
sha1sums = ('99fdedaec3acc9a8107443b6bfe87c7cdc0165c2')
build() {
  cd $startdir/src
  ./configure --prefix=/usr
  make || return 1
  make DESTDIR=$startdir/pkg install || return 1
}
# vim:syntax=sh

• Řádky začínající na # jsou komentáře.
• # Maintainer: - člověk zodpovědný za PKGBUILD, používá se v balíčcích z oficiálních repozitářů.
• # Contributor: - člověk který vytvořil PKGBUILD, zde uveďte svoje jméno (nebo nick) a emailovou adresu.
• pkgname - jméno balíčku.
• pkgver - verze balíčku (verze softwaru v balíčku).
• pkgrel - release balíčku, obvykle se navyšuje při změně PKGBUILDu, úpravě parametrů pro configure atd.
• pkgdesc - krátký a výstižný popis balíčku.
• url - domovská stránka projektu.
• license (pole) - licence, se kterou je software vydáván. Pokud použijete nějakou vlastní licenci, nastavte hodnotu na custom nebo custom:LicenseName a licenci umístěte do adresáře $start-dir/pkg/usr/share/licenses/$pkgname.
• install - specifikuje název instalačního skriptu.
• noextract (pole) - obsahuje názvy souborů použitých v seznamu source, které nebudou rozbalovány; hodí se to například pro soubory, které mají být ve finálním balíčku zabalené.
• md5sums (pole) - seznam kontrolních md5 součtů souborů ze source, v pořadí, v jakém jsou uvedeny.
• sha1sums (pole) - seznam kontrolních součtů zjištěných algoritmem sha1; podobně mohou být použity i další.
• groups (pole) - seznam skupin, do kterých balíček náleží. Pokud se balíček vyskytne v repozitáři, a uživatel se rozhodne nainstalovat některou ze skupin, ve kterých balíček je, potom bude nainstalován.
• arch (pole) - seznam architektur, pro které může být balíček sestaven.
• backup (pole) - seznam souborů, které se mají zálohovat; obvykle jde o soubory v /etc; je možné použít shellové expanze {}.
• depends (pole) - seznam závislostí; pokud chcete specifikovat verzi, tak se používá zápis balíček <>verze, kde <> je jedno z porovnání =>, <= nebo =.
• makedepends (pole) - seznam závislostí potřebných pro sestavení balíčku; jsou potřeba jen při kompilaci.
• conflicts (pole) - seznam balíčků, které jsou s tímto v konfliktu.
• provides (pole) - balíček může poskytovat funkce jiného, například balíček s ovladači pro grafické karty nVidia poskytuje funkčnost balíčku libgl.
• replaces (pole) - seznam balíčků, které tento nahrazuje.
• options (pole) - seznam příznaků balíčku; pokud před některou z nich uvedete !, bude použit opačný význam. Příznaky jsou:
  • strip - stripne objfile symboly z knihoven a binárek.
  • docs - ponechá adresáře doc a info; pokud chcete smazat info a doc, tak použijte volbu !doc.
  • libtool - ponechá *.la soubory knihoven; pokud je chcete smazat, použijte !libtool.
  • emptydirs - ponechá prázdné adresáře v balíčku.
  • ccache - při sestavování se použije ccache; pokud s tím máte problémy, zakážete použití volbou !ccache.
  • distcc - při sestavování se použije distcc; pokud jsou problémy, zakážete použití volbou !distcc.
  • makeflags - použijí se makeflags udané uživatelem v makepkg.conf.
  • force - je speciálním přiznakem, který byste neměli běžně ve svých PKGBUILDech používat, je vyhrazen pro výjimečné použití. Pokud je takový balíček umístěn v repozitáři, bude při systemupgrade uživateli nabídnuta aktualizace, i když je balíček uveden mezi ignorovanými.
• build() - shell funkce, která se volá pro sestavení balíčku; můžete v ní používat proměnné $pkgname, $pkgver a $startdir.
• msg - používá se pro výpis zpráv ve funkci build().

Zde popsaný PKGBUILD je použitelný pro sestavení balíčku ze zdrojových souborů dostupných v archivech. Existuje možnost balíček sestavit přímo ze SVN i CVS repozitáře. I v tomto případě je třeba se držet pravidel pro tvorbu PKGBUILDu. Používají se proměnné _cvsroot a _cvsmod, respektive _svntrunk a _svnmod. Ve funkci build() se použije příkaz pro stažení CVS repozitáře a jeho překopírování; až z této kopie se sestavuje balíček.

if [ -d $_cvsmod/CVS ]; then
    cd $_cvsmod
    cvs -z3 update -d
else
    cvs -z3 -d $_cvsroot co -D $pkgver -f $_cvsmod
  fi

msg "CVS checkout done or server timeout"
msg "Starting make..."

cp -r $_cvsmod $_cvsmod-build
cd $_cvsmod-build
...

Podobně vypadá fragment pro SVN:

if [ -d $_svnmod/.svn ]; then
    cd $_svnmod
    svn up -r $pkgver
else
    svn co $_svntrunk --config-dir ./ -r $pkgver $_svnmod
fi

msg "SVN checkout done or server timeout"
msg "Starting make..."

cp -r $_svnmod $_svnmod-build
cd $_svnmod-build
...

Instalační skript

Pokud chcete ve svém balíčku používat instalační skript, musíte uvést v PKGBUILDu direktivu:

install=jméno_balíčku.install

Skript poskytuje tyto funkce:

• pre_install - spouští se před instalací.
• post_install - spouští se po instalaci.
• pre_upgrade - spouští se před upgrade.
• post_upgrade - spouští se po upgrade.
• pre_remove - spouští se před odinstalováním.
• post_remove - spouští se po odinstalovaní.

Jak vypadá instalační skript, jsme si ukázali v prvním díle seriálu. Skript nemusí být umístěn v seznamu source; stačí, když je v adresáři, ve kterém je PKGBUILD.

makepkg

Makepkg je shellový skript, který umožní sestavit balíček podle PKGBUILDu. Je distribuován společně s pacmanem.

Popisovány jsou vlastnosti makepkg 3.0.x, starší verze se mohou lišit. Postupně probereme nejpoužívanější přepínače. Pokud chcete vědět více, prohlédněte si manuálovou stránku.

makepkg se volá takto (musíme být v adresáři, kde je PKGBUILD, který chceme použít):

makepkg [volby]

• -c, --clean - po úspěšném sestavení budou smazány všechny nepotřebné soubory.
• -d, --nodeps - nekontrolují se závislosti, to může zapříčinit neúspěch při sestavování balíčku.
• -i, --install - po úspěšném sestavení se balíček nainstaluje pomocí pacmana.
• -R, --repackage - "přebalí" se balíček, použije se obsah pkg/ bez nového sestavování.
• -s, --syncdeps - chybějící závislosti se nainstalují pomocí pacmana.
• -S, --usesudo - pokud se volá pacman a vyžaduje oprávnění roota, použije se sudo.
• --noconfirm - předává se pacmanovi, zabraňuje čekání na odpověď uživatele.

makepkg.conf

Konfigurační soubor makepkg umožňuje nastavit optimalizace pro procesor, zapnout distribuovanou kompilaci a další proměnné prostředí, které ovlivňují software ve výsledném balíčku. Soubor je bohatě komentován, takže i neznalý uživatel se v něm neztratí.

Opět uvedu nejdůležitější volby:

• FTPAGENT="/cesta/k/příkazu [volby]" - nastavuje program pro stahování souborů.
• CFLAGS="volby" - nastavuje volby pro C kompilátor; právě zde se dá balíček optimalizovat přímo pro danou architekturu.
• CXXFLAGS="volby" - podobně jako CFLAGS= ovšem pro C++ kompilátor.
• MAKEFLAGS="volby" - podobně jako CFLAGS= ovšem pro make, například -j2 pro nastavení počtu souběžně zpracovávaných úloh.
• PKGDEST=/path/to/folder - cesta, kam se mají ukládat sestavené balíčky, např. /home/packages.
• SRCDEST=/path/to/folder - pokud je prázdná cesta, pak se stažené soubory ukládají do aktuálního adresáře, ale můžeme je ukládat hromadně do jednoho adresáře, např. /home/sources.

AUR

AUR je repositář PKGBUILDů, do kterého může přispět každý uživatel Arch Linuxu. Jeho stránky jsou http://aur.archlinux.org/. Pokud chcete připívat, musíte si vytvořit účet.

Když zjistíte, že balíček pro daný software v binárních repozitářích není, nejprve se podívejte do AURu, obvykle ho tam najdete. Pokud vytvoříte PKGBUILD, který ještě neexistuje, pak jej stačí zabalit do archivu a uploadovat do AURu.

Ke každému balíčku je možné posílat komentáře, které mohou obsahovat hlášení chyb nebo návrhy na vylepšení PKGBUILDu určené pro autora. Každý má také možnost pro balíčky hlasovat - pokud bude mít daný balíček hodně hlasů, má velkou šanci se dostat do repozitáře community. Stejně tak se dá balíček označit za neaktuální (Out-of-date).

Vybraní důvěryhodní uživatelé se snaží udržovat AUR a PKGBUILDY v něm ve funkčním stavu, ale stejně je na každém přispěvateli, aby PKGBUILD udržoval v aktuální verzi a v sestavitelné podobě. Proto se může stát, že si stáhnete PKGBUILD, který je nepoužitelný, a nezbývá, než jej opravit. Toto se může odrazit ve vašem hodnocení balíčku.

AUR je dobrým zdrojem, ale často se vám může stát, že daný balíček nesestavíte - proto je dobré se podívat na poslední aktualizaci. Alespoň zjistíte, jestli je PKGBUILD ještě udržován. AUR je stále tak trochu džungle.

Příště

V příštím díle budeme pokračovat v sestavování balíčků - podíváme na ABS (Arch Build System) a makeworld.

Seriál Balíčkovací systém Arch Linuxu (dílů: 4)

První díl: Balíčkovací systém Arch Linuxu - 1 (formát balíčků), poslední díl: Balíčkovací systém Arch Linuxu - 4 (ABS, makeworld).
Předchozí díl: Balíčkovací systém Arch Linuxu - 2 (pacman, repozitáře)
Následující díl: Balíčkovací systém Arch Linuxu - 4 (ABS, makeworld)

Diskuse k tomuto článku

[kouzer]

Pěkné..

[kozzi]

Moc pěkný, ale je tamn pár pravopisných chyb, což většinou moc nevadí. Ale v jednom případě je to zavádějíci viz. rozdíl mezi x68_64 a x86_64

[Robert Krátký]

Pravopisné chyby prosím vypsat, ať je mohu opravit. Dík.

[kozzi]

No, koukám že jich pár ubylo. Jiank možná to není překlep, ale hned na začátku píše autor balíku(což je správně, ale mám pocit, že chtěl napsat balíčku, jelikož i nadále v textu používá daný výraz).
Potom tam je věta "Uvedeme se příklad.." myslím že yb tam mělo být Uvedeme si příklad...
A ještě to si ale nejsem jistý se mi zdá že u věty "...nastavte hodnotu na custom nebo custom:LicenseName a licenci umístěte..." by mělo být před nebo čárka

[kozzi]

Zde popsaný PKGBUILD je použitelný pro sestavení balíčku se zdrojových souborů dostupných v archivech.

ze zdrojových balíčků - z koho z čeho 2.pád

[Robert Krátký]

Díky za upozornění. Opravil jsem (až na tu čárku před "nebo").

[kozzi]

JJ OK, proč vůbec tam nemá být čárka?

[otula]

Protože v případě, že jde o libovolně zaměnitelné alternativy, čárka se nepíše. Třeba Koupím hrušky nebo jablka.

Pokud se nejedná o libovolně zaměnitelné alternativy, čárka se tam píše. Líbí se ti to, nebo na to máš jiný názor?

[kozzi]

JJ díky. Jsem sám, komu se zdá čeština občas až příliš složitá?

[otula]

Nejsi, znám takových spoustu Už jsi dobuildil to icc? Já už z něj mám hlavu na prasknutí a naprosto to vzdávám. Pokud bys s tím dospěl k úspěchu, můžeš o tom napsat pár řádek do blogu (pravopisné chyby ti odpustím )

[kozzi]

Jo zatím se mi to jesště stahuje, takže to nechám přes noc vybuildit a o víkendu si stím pohraju, a blog o tom určitě napíšu.

[otula]

Ten balíček je hotový okamžitě. Nekompiluje se. Hlavně si pak hned oprav tu konfigurák /etc/ld.so.conf :)

[Kyosuke]

Co je na ní složitého?

[petr_p]

A když přijdu z nákupu s jablky i hruškami? Mě učili (ale možná to je profesionalání deformace), že když je poměr XOR, tak se čarka píše.

[otula]

To je jedno. Klidně můžeš koupit i ananas a brambory Čeština není matematika

[trekker.dk]

Koukám, že redakce se rozhodla, že probere všechny možné balíčkovací systémy - rpm už tu bylo, teď Gentoo a Arch... bude taky něco pro Debian?

[Vykook]

A nebylo uz před lety?

[freshmouse]

Repríza?

[trekker.dk]

Bylo? Já nevím, hledal jsem, nenašel jsem.

[Robert Krátký]

Nebylo. Nejbližší balíčkovacímu systému Debianu byl článek Zdroje balíčkov pre Ubuntu. Takže pokud by se našel někdo, kdo by chtěl popsat debianní balíčky, ať se mi prosím ozve, budu jen rád.

[freshmouse]

To bych potřeboval, poněvadž jsem začal mít zájem tvořit balíčky (pro osobní i cizí potřebu) pri Ubuntu. Už mám patřičné odkazy v záložkách, že se po tom mrknu... Článek by mi ale ušetřil čas (na nějakou dobu).

[zbynek]

Asi jsem trouba, ale jak se hlasuje v AURu? Žádnou volbu pro hlasování u balíčků nemám, používám Konquer 3.5.6. Díky

[zbynek]

Už jsem na to došel, musím si vytvořit účet a přihlásit se :)