Difference between revisions of "PKGBUILD (Česky)"

From ArchWiki
Jump to: navigation, search
m (Proměnné)
m (Proměnné)
Line 102: Line 102:
 
: {{Note|Můžete také specifikovat jiné jméno stahovaného souboru. Například pokud má stahovaný soubor nehodící se jméno (například obsahuje parametry GET). Vše uděláte následovně: <jmeno_souboru>::<uri_souboru>, vše bez znaků '<' a '>'.}}
 
: {{Note|Můžete také specifikovat jiné jméno stahovaného souboru. Například pokud má stahovaný soubor nehodící se jméno (například obsahuje parametry GET). Vše uděláte následovně: <jmeno_souboru>::<uri_souboru>, vše bez znaků '<' a '>'.}}
  
; {{Codeline|noextract}} : An array of files listed under the {{Codeline|source}} array which should not be extracted from their archive format by {{Codeline|makepkg}}. This most commonly applies to certain zip files which cannot be handled by ''bsdtar'' because ''libarchive'' processes all files as streams rather than random access as ''unzip'' does. In these situations ''unzip'' should be added in the {{Codeline|makedepends}} array and the first line of the {{Codeline|build()}} function should contain:
+
; {{Codeline|noextract}} : Pole souborů, které jsou obsaženy v poli {{Codeline|source}}, ale nemají být extraktovány. Toto pole se většinou používá pro archívy typu zip, které nemohou být rozbaleny programem ''bsdtar''. V těchto situacích by se měl přidat program ''unzip'' do pole {{Codeline|makedepends}} a první řádka funkce {{Codeline|build()}} by měla obsahovat:
 
  cd $srcdir/$pkgname-$pkgver
 
  cd $srcdir/$pkgname-$pkgver
 
  unzip [source].zip
 
  unzip [source].zip
  
; {{Codeline|md5sums}} : An array of MD5 checksums of the files listed in the {{Codeline|source}} array. Once all files in the {{Codeline|source}} array are available, an MD5 hash of each file will be automatically generated and compared with the values of this array in the same order they appear in the {{Codeline|source}} array. While the order of the source files itself does not matter, it is important that it matches the order of this array since {{Codeline|makepkg}} cannot guess which checksum belongs to what source file. You can generate this array quickly and easily using the command {{Codeline|makepkg -g}} in the directory that contains the {{Filename|PKGBUILD}} file. Note that the MD5 algorithm is known to have weaknesses, so you should consider using a stronger alternative.
+
; {{Codeline|md5sums}} : Je pole kontrolních součtů typu MD5. Jedná se o kontrolní součty souborů obsažených v poli {{Codeline|source}}. Při sestavování balíčku se pak automaticky spočítá kontrolní součet souborů obsažených v poli {{Codeline|source}} a porovná se se součtama z tohoto pole. Toto pole lze jednoduše vygenerovat pomocí příkazu {{Codeline|makepkg -g}} spuštěném v adresáři, který obsahuje daný soubor {{Filename|PKGBUILD}}.
  
 
; {{Codeline|sha1sums}} : Je pole SHA-1 160-bitových kontrolních součtů. Je to alternativa k md5 součtům, které jsou zmíněny výše. Pro to, aby jste je mohli používat musíte mít zaplou volbu INTEGRITY_CHECK ve vašem {{Filename|makepkg.conf}}. Pro více informací koukněte do man makepkg.conf.
 
; {{Codeline|sha1sums}} : Je pole SHA-1 160-bitových kontrolních součtů. Je to alternativa k md5 součtům, které jsou zmíněny výše. Pro to, aby jste je mohli používat musíte mít zaplou volbu INTEGRITY_CHECK ve vašem {{Filename|makepkg.conf}}. Pro více informací koukněte do man makepkg.conf.

Revision as of 00:49, 2 March 2011

Tango-preferences-desktop-locale.pngThis article or section needs to be translated.Tango-preferences-desktop-locale.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:PKGBUILD (Česky)#)

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary wiki Template:Article summary heading Template:Article summary link Template:Article summary end

Template:Filename je textový soubor, ve kterém je přesně určeno, jak se bude vytvářet určitý binární balíček. Více zde. Tento článek pouze popisuje proměnné, které lze při vytváření tohoto souboru použít.

Sestavování balíčků

Balíčky jsou v ArchLinuxu sestavovány programem makepkg. Při jeho spuštění se program pokouší najít Template:Filename ve vašem pracovním adresáři. Pokud ho najde, přečte si ho a podle jednotlivých instrukcí v něm obsažených začne sestavovat balíček. Pokud je vše provedeno bez chyb, vznikne soubor (Template:Filename). Tento balíček obsahuje binární soubory a instrukce pro instalaci. Takto vytvořený balíček lze nainstalovat pomocí správce balíčků pacman.

Pro více informací běžte na vytváření balíčků.

Proměnné

Následující proměnné mohou být použity v souboru Template:Filename:

Template:Codeline 
Obsahuje jméno balíčku. Mělo by se skládat z alfanumerických znaků a pomlčky ('-'). Všechna písmena by měla být malá (lowercase). V zájmu soudržnosti by se měla proměnná Template:Codeline shodovat s názvem zdrojového archivu programu, pro který balíček vytváříte. Například, pokud je jméno tarballu Template:Filename, měla by hodnota Template:Codeline být foobar.
Template:Codeline 
Verze balíčku. Hodnota proměnné by měla být stejná jako verze sestavovaného programu. Může obsahovat písmena, čísla a tečky ale NEMĚL BY obsahovat pomlčku. Pokud autor programu používá ve verzi pomlčku, nahraďte ji podtržítkem. Například, pokud je verze programu 0.99-10, měla by být změněna na 0.99_10. Pokud je pak proměnná použita dále ve skriptu, lze jednoduše podtržítko nahradit pomlčkou následovně:
 source=($pkgname-${pkgver//_/-}.tar.gz)
Template:Codeline 
Tato proměnná zastupuje číslo release. Umožňuje uživatelům rozlišit mezi jednotlivými verzemi Template:Filenameu. Když je vydána první verze balíčku, začíná proměnná Template:Codeline na hodnotě 1. Pokud později nastanou ruzné optimalizace souboru Template:Filename, balíček bude vydán znovu a release číslo se zvýší o 1. Pokud pak vyjde nová verze sestavovaného programu, release číslo verze se nastaví opět na 1.
Template:Codeline 
Krátký popis balíčku. Popis by měl být dlouhý okolo 80 znaků nebo méně a neměl by v sobě obsahovat znovu jméno programu. Například, místo "Nedit is a text editor for X11" by mělo spíše být "A text editor for X11."
Template:Codeline 
Pole architektur na kterých je možné balíček správně zkompilovat a spustit. V současné době většinou obsahuje i686 a/nebo x86_64, Template:Codeline. Hodnota any může být použita také, pokud sestavujete na platformě nezávislý balíček. Při samotném průběhu sestavování balíčku pak k této hodnotě můžete přistupovat pomocí proměnné Template:Codeline.
Template:Codeline 
V této proměnné je obsažena oficiální stránka programu, který sestavujete.
Template:Codeline 
Toto pole obsahuje licenci pod kterou je program distribuován. V repozitáři Template:Codeline byl vytvořen balíček Template:Package Official, který obsahuje nejběžnější licence. Soubory licencí jsou pak uloženy v adresáři Template:Filename, například známou Template:Filename. Pokud je balíček licencován pod některou z těchto licencí, měla by být proměnná nastavena na jméno adresáře tzn. Template:Codeline. Jestliže se licence, pod kterou je program vydáván v adresáři nenachází, musíte ještě udělat pár věcí:
  1. Pokud archiv se zdrojovými kódy programu neobsahuje žádný soubor s licencí, budete pravděpodobně muset licenci odněkud zkopírovat, například z oficiálních stránek programu. Následně ji uložit do souboru a zajistit to, aby se licence nainstalovala spolu s balíčkem, který vytváříte.
  2. Nastavte pole Template:Codeline na custom. Případně ještě můžete nahradit custom za custom:jméno neoficiální licence. Pokud je daná licence použita u dvou a více programů z oficiálního repozitáře (včetně Template:Codeline), stává se součástí balíčku Template:Package Official.
  • Licence BSD, MIT, zlib/png a Python jsou speciální případy, které nemohou být obsažené v balíčku Template:Package Official. Pokud je program vydáván pod některou z těchto licencí vložte ji do pole Template:Codeline takto (Template:Codeline, Template:Codeline, Template:Codeline nebo Template:Codeline). Každý z těchto balíčků by měl mít svou vlastní unikátní licenci uloženou v Template:Filename. Některé balíčky nemusejí být vždy vydávány pouze pod jednou licencí, proto lze do pole vložit licencí více. Například takto Template:Codeline.
  • Kromě toho například (L)GPL má plno různých podob, proto je pro (L)GPL software dodržována tato konvence:
    • (L)GPL - (L)GPLv2 nebo kterákoliv pozdější verze
    • (L)GPL2 - (L)GPL2 pouze
    • (L)GPL3 - (L)GPL3 nebo kterákoliv pozdější verze
Template:Codeline 
Jméno skupiny do které balíček patří. Například když nainstalujete balíče Template:Package Official, nainstalují se zároveň i ostatní balíčky, které patří do skupiny kde.
Template:Codeline 
Pole jmen balíčků, které musí být pro spuštění sestavovaného programu nainstalovány. Pokud program vyžaduje nějakou určitou verzi balíčku, lze ji definovat použitím operátoru >=, například takto: Template:Codeline.
Template:Codeline 
Je pole jmen balíčků, které musí být nainstalovány, aby šel daný program zkompilovat, ale nejsou už potom potřeba pro samotný běh programu. Můžete také specifikovat minimální verzi závislého balíčku. To se nastavuje úplně stejně jako u pole Template:Codeline.
Warning: Skupina balíčků "base-devel" je už nainstalovaná automaticky, pokud vše sestavujete pomocí programu makepkg. Takže by balíčky z této skupiny neměly být obsaženy v tomto poli.
Template:Codeline 
Je pole balíčků, které obsahuje jména programů, které nejsou nutně potřeba pro běh programu, ale pouze poskytují nějaké nadstandartní funkce. U každého zmíněného balíčku by měla být obsažena krátká informace o tom, co poskytuje. Pole Template:Codeline by mohlo vypadat například následovně:
optdepends=('cups: printing support'
'sane: scanners support'
'libgphoto2: digital cameras support'
'alsa-lib: sound support'
'giflib: GIF images support'
'libjpeg: JPEG images support'
'libpng: PNG images support')
Template:Codeline 
Pole jmen balíčků, které tento balíček funkčně zastupuje. Pokud toto pole použijete, měli byste ještě definovat proměnnou (Template:Codeline, případně i Template:Codeline). Například pokud poskytujete upravenou verzi qt v balíčku pojmenovaném qt-foobar verze 3.3.8, která poskytuje qt mělo by pole Template:Codeline vypadat nějak takto: Template:Codeline. Pokud do pole vložíte pouze Template:Codeline, bude to způsobovat chyby závislostí. Proměnnou Template:Codeline už do svého pole provides nepřidávejte. To se už řeší automaticky.
Template:Codeline 
Pole jmen balíčků, které mohou způsobovat problémy, když bude tento program nainstalován. Mužete zde také specifikovat konfliktní verzi balíčku - stejně jako u pole Template:Codeline.
Template:Codeline 
Pole jmen balíčků, které mají být nahrazeny tímto balíčkem. Například Template:Codeline. Pokud poskytujete alternativní verzi nějakého existujícího balíčku, použijte pole Template:Codeline.
Template:Codeline 
Toto pole obsahuje jména souborů, které se mají zálohovat a tím pádem uložit jako Template:Filename když je balíček odinstalován ze systému. Toto se většinou používá u balíčků, které svou konfiguraci ukládají do adresáře Template:Filename. Cesty definované v tomto poli by měly být relativní. Takže například Template:Filename. Nepoužívejte absolutní cesty! (Template:Filename).
Template:Codeline 
Toto pole vám umožňuje změnit základní chování programu Template:Codeline. Pro nastavení vložte jméno určité volby do pole.Pro změnu defaultní volby na opačnou hodnotu vložte ! na začátek jména volby. V poli lze použít následující volby:
  • strip - Odstranění symbolů z binárních souborů a knihoven.
  • docs - Uložení adresářů Template:Filename.
  • libtool - Odstranění souborů programu libtool (Template:Filename).
  • emptydirs - Odstranění prázdných adresářů z výsledného balíčku.
  • zipman - Komprese man a info stránek programem gzip.
  • ccache - Povoluje použití Template:Codeline v průběhu sestavování balíčku. Více se užívá obrácená varianta této volby Template:Codeline - většinou pro balíčky, které mají problém při sestavování s Template:Codeline.
  • distcc - Povoluje užítí Template:Codeline v průběhu sestavování balíčku. Více se užívá obrácená varianta této volby Template:Codeline. Tuto volbu většinou používájí balíčky, které mají problémy při sestavování s Template:Codeline.
  • makeflags - Umožňuje definovat proměnné pro kompilaci. Více se užívá její znegovaná forma Template:Codeline.
  • force - Donutí balíček k aktualizaci, a to i v případě, že by to verze balíčku neměla umožňovat. Tato volba se například užívá při změně číslování verzí balíčku nebo když je nutný tzv. downgrade balíčku z důvodu bezpečnosti.
Template:Codeline 
Představuje jméno skriptu Template:Filename, který může a nemusí být součástí balíčku. pacman pak tento skript spouští při instalaci, odstranění nebo aktualizaci balíčku. Skript pak může obsahovat následující funkce. Každá z funkcí se spouští v jinou dobu.
  • pre_install - Tato funkce je volána předtím, než jsou soubory rozbaleny. Funkci je argumentem předávána nová verze balíčku.
  • post_install - Tato funkce je volána po rozbalení balíčku. V argumentu ji je předáváno číslo nové verze balíčku.
  • pre_upgrade - Tato funkce je volána předtím, než jsou soubory rozbaleny. Jsou ji předávány dva argumenty v tomto pořadí: nová verze balíčku, stará verze balíčku.
  • post_upgrade - Tato funkce je volána po rozbalení balíčku. Jsou ji předávány dva argumenty v tomto pořadí: nová verze balíčku, stará verze balíčku.
  • pre_remove - Funkce, která je volána předtím, než jsou všechny soubory odstraněny. Je jí předáván jeden parametr - stará verze balíčku.
  • post_remove - Funkce, která je volána po odstranění souborů. Je jí předáván jeden argument - stará verze balíčku.
Tip: Prototyp souboru Template:Filename můžete naleznout zde: Template:Filename.
Template:Codeline 
Je pole souborů, které jsou potřeba pro sestavení balíčku. Musí obsahovat umístění zdrojových kódů programu. Umístění tedy představuje adresa URL na HTTP nebo FTP. Můžete zde využít již definované proměnné Template:Codeline a Template:Codeline. Například takto: Template:Codeline.
Note: Pokud k balíčku potřebujete přidat nějaké soubory, které není možno stáhnout přímo z internetu (například patche apod.), stačí je jednoduše přidat do stejného adresáře jako váš Template:Filename a název souboru přidat do tohoto pole. Předtím, než začne samotný proces sestavování balíčku, jsou všechny odkazované soubory staženy a zkontrolovány. Pokud nastane nějaká chyba, Template:Filename nebude dál pokračovat a skončí s chybou.
Note: Můžete také specifikovat jiné jméno stahovaného souboru. Například pokud má stahovaný soubor nehodící se jméno (například obsahuje parametry GET). Vše uděláte následovně: <jmeno_souboru>::<uri_souboru>, vše bez znaků '<' a '>'.
Template:Codeline 
Pole souborů, které jsou obsaženy v poli Template:Codeline, ale nemají být extraktovány. Toto pole se většinou používá pro archívy typu zip, které nemohou být rozbaleny programem bsdtar. V těchto situacích by se měl přidat program unzip do pole Template:Codeline a první řádka funkce Template:Codeline by měla obsahovat:
cd $srcdir/$pkgname-$pkgver
unzip [source].zip
Template:Codeline 
Je pole kontrolních součtů typu MD5. Jedná se o kontrolní součty souborů obsažených v poli Template:Codeline. Při sestavování balíčku se pak automaticky spočítá kontrolní součet souborů obsažených v poli Template:Codeline a porovná se se součtama z tohoto pole. Toto pole lze jednoduše vygenerovat pomocí příkazu Template:Codeline spuštěném v adresáři, který obsahuje daný soubor Template:Filename.
Template:Codeline 
Je pole SHA-1 160-bitových kontrolních součtů. Je to alternativa k md5 součtům, které jsou zmíněny výše. Pro to, aby jste je mohli používat musíte mít zaplou volbu INTEGRITY_CHECK ve vašem Template:Filename. Pro více informací koukněte do man makepkg.conf.
Template:Codeline 
Pole kontrolních součtů typu SHA-2 o šířce 256, 384 a 512 bitů. Jsou alternativou pro kontrolní součty typu md5, které jsou popsané výše. Pro zapnutí generování těchto kontrolních součtů se ujistěte, že máte správně nastavenou volbu INTEGRITY_CHECK ve vašem Template:Filename. Mrkněte také do man makepkg.conf.

Běžně se ve skriptu Template:Filename zachovává stejné pořádí proměnných jako výše. Nicméně to není povinné. Jediným požadavkem je dodržení přesné Bash syntaxe.

Koukněte také na