PKGBUILD (Česky)

From ArchWiki
Revision as of 20:45, 10 February 2011 by Seberm (Talk | contribs) (Proměnné)

Jump to: navigation, search

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: The group "base-devel" is assumed already installed when building with makepkg . Members of "base-devel" should not be included in makedepends arrays.
Template:Codeline 
An array of package names that are not needed for the software to function but provides additional features. A short description of what each package provides should also be noted. An Template:Codeline may look like this:
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 
An array of package names that this package provides the features of (or a virtual package such as cron or sh). If you use this variable, you should add the version (Template:Codeline and perhaps the Template:Codeline) that this package will provide if dependencies may be affected by it. For instance, if you are providing a modified qt package named qt-foobar version 3.3.8 which provides qt then the Template:Codeline array should look like Template:Codeline. Putting Template:Codeline will cause to fail those dependencies that require a specific version of qt. Do not add Template:Codeline to your provides array, this is done automatically.
Template:Codeline 
An array of package names that may cause problems with this package if installed. You can also specify the version properties of the conflicting packages in the same format as the Template:Codeline array.
Template:Codeline 
An array of obsolete package name that are replaced by this package, e.g. Template:Codeline for the Template:Package Official package. After syncing with Template:Codeline, it will immediately replace an installed package upon encountering another package with the matching Template:Codeline in the repositories. If you are providing an alternate version of an already existing package, use the Template:Codeline variable which is only evaluated when actually installing the conflicting package.
Template:Codeline 
An array of files to be backed up as Template:Filename when the package is removed. This is commonly used for packages placing configuration files in Template:Filename. The file paths in this array should be relative paths (e.g. Template:Filename) not absolute paths (e.g. Template:Filename).
Template:Codeline 
This array allows you to override some of the default behavior of Template:Codeline. To set an option, include the option name in the array. To reverse the default behavior, place an ! at the front of the option. The following options may be placed in the array:
  • strip - Strips symbols from binaries and libraries.
  • docs - Save Template:Filename directories.
  • libtool - Leave libtool (Template:Filename) files in packages.
  • emptydirs - Leave empty directories in packages.
  • zipman - Compress man and info pages with gzip.
  • ccache - Allow the use of Template:Codeline during build. More useful in its negative form Template:Codeline with select packages that have problems building with Template:Codeline.
  • distcc - Allow the use of Template:Codeline during build. More useful in its negative form Template:Codeline with select packages that have problems building with Template:Codeline.
  • makeflags - Allow the use of user-specific Template:Codeline during build. More useful in its negative form Template:Codeline with select packages that have problems building with custom Template:Codeline.
  • force - Force the package to be upgraded by a pacman system upgrade operation, even if the version number would normally not trigger such an upgrade. This is useful when the version numbering scheme of a package changes (or is alphanumeric) or when a downgrade is required for security reasons.
Template:Codeline 
The name of the Template:Filename script to be included in the package. pacman has the ability to store and execute a package-specific script when it installs, removes or upgrades a package. The script contains the following functions which run at different times:
  • pre_install - The script is run right before files are extracted. One argument is passed: new package version.
  • post_install - The script is run right after files are extracted. One argument is passed: new package version.
  • pre_upgrade - The script is run right before files are extracted. Two arguments are passed in the following order: new package version, old package version.
  • post_upgrade - The script is run after files are extracted. Two arguments are passed in the following order: new package version, old package version.
  • pre_remove - The script is run right before files are removed. One argument is passed: old package version.
  • post_remove - The script is run right after files are removed. One argument is passed: old package version.
Tip: A prototype Template:Filename is provided at Template:Filename.
Template:Codeline 
An array of files which are needed to build the package. It must contain the location of the software source, which in most cases is a full HTTP or FTP URL. The previously set variables Template:Codeline and Template:Codeline can be used effectively here (e.g. Template:Codeline)
Note: If you need to supply files which are not downloadable on the fly, e.g. self-made patches, you simply put those into the same directory where your Template:Filename file is in and add the filename to this array. Any paths you add here are resolved relative to the directory where the Template:Filename lies. Before the actual build process is started, all of the files referenced in this array will be downloaded or checked for existence, and Template:Codeline will not proceed if any are missing.
Note: You can specify a different name for the downloaded file - if the downloaded file has a different name for some reason like the url had a GET parameter - using the following syntax: <filename>::<fileuri>, do not include the '<' and '>' characters
Template:Codeline 
An array of files listed under the Template:Codeline array which should not be extracted from their archive format by Template:Codeline. 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 Template:Codeline array and the first line of the Template:Codeline function should contain:
cd $srcdir/$pkgname-$pkgver
unzip [source].zip
Template:Codeline 
An array of MD5 checksums of the files listed in the Template:Codeline array. Once all files in the Template:Codeline 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 Template:Codeline array. While the order of the source files itself does not matter, it is important that it matches the order of this array since Template:Codeline cannot guess which checksum belongs to what source file. You can generate this array quickly and easily using the command Template:Codeline in the directory that contains the Template:Filename file. Note that the MD5 algorithm is known to have weaknesses, so you should consider using a stronger alternative.
Template:Codeline 
An array of SHA-1 160-bit checksums. This is an alternative to md5sums described above, but is also known to have weaknesses, so you should consider using a stronger alternative. To enable use and generation of these checksums, be sure to set up the INTEGRITY_CHECK option in makepkg.conf. See man makepkg.conf.
Template:Codeline 
An array of SHA-2 checksums with digest sizes 256, 384 and 512 bits respectively. These are alternatives to md5sums described above and are generally believed to be stronger. To enable use and generation of these checksums, be sure to set up the INTEGRITY_CHECK option in makepkg.conf. See man makepkg.conf.

It is common practice to preserve the order of the Template:Filename variables as shown above. However, this is not mandatory, as the only requirement in this context is correct Bash syntax.