FrugalBuild (exemple détaillé)
From FrugalWiki
Contents |
Exemple détaillé d'un FrugalBuild
Notre exemple
# Compiling Time: 0.06 SBU # Maintainer: VMiklos <vmiklos@frugalware.org> pkgname=cabextract pkgver=1.2 pkgrel=1 pkgdesc="a program to extract Microsoft Cabinet files" url="http://www.kyz.uklinux.net/cabextract.php"depends=('glibc') groups=('apps') archs=('i686' 'x86_64') up2date="lynx -dump http://www.kyz.uklinux.net/cabextract.php |grep 'cabextract \ source code'|tr -s ' '|cut -d ' ' -f 6" source=(http://www.kyz.uklinux.net/downloads/$pkgname-$pkgver.tar.gz) sha1sums=('871b3db4bc2629eb5726659c147aecea1af6a6d0') # optimization OK
Détaillons chaque élément…
# Compiling Time: SBU
# Compiling Time: SBU
Cette ligne signifie le temps de compilation, elle se rajoute automatiquement lors de la compilation ou par vérification via la commande fblint.
Maintainer et Contributor
# Maintainer: VMiklos <vmiklos@frugalware.org>
Cette ligne indique le nom de mainteneur de paquet, si vous n'allez pas maintenir indiquez ceci:
# Contributor: votrepseudo <votreemail@blabla.com>
pkgname
pkgname=cabextract
Cette ligne indique le nom de paquet. Ce sera le nom utilisé dans vos commandes pacman une fois le paquet au dépôt.
pkgver
pkgver=1.2
Cette ligne indique la version du programme cabextract, faîtes bien attention certains programmes ont des manières différentes de nommer ces numéros de version.
pkgrel
pkgrel=1
Cette ligne indique la version du paquet. Si vous avez recompilé le paquet afin de corriger des choses…etc vous devez alors changer le 1 par 2 (et ainsi de suite).
pkgdesc
pkgdesc="a program to extract Microsoft Cabinet files"
Cette ligne indique une courte description du programme en question.
url
url="http://www.kyz.uklinux.net/cabextract.php"
Cette ligne indique la page web du programme.
depends (dépendances)
depends=('glibc')
Cette ligne est très importante, elle indique les dépendances nécessaires au paquet. Dans cet exemple, glibc est nécessaire au fonctionnement de cabextract. Si votre paquet nécessite plusieurs dépendances il vous faudra toutes les indiquer entre guillemets et espacées par un espace. Pour trouver les dépendances d'un paquet utilisez la commande makepkg -a.
Le Groupe
groups=('apps')
Cette ligne indique le groupe auquel appartient le paquet. Ne placez pas votre paquet dans les groupes apps, base, devel, lib, multimedia ou network, vous devez utiliser un groupe adéquat avec le suffixe -extra. Par exemple si vous faîtes un paquet d'un programme pour Gnome, prenez le groupe gnome-extra.
Architectures
archs=('i686' 'x86_64')
Cette ligne indique l'architecture pour laquelle se destine votre paquet. Dans cet exemple les architectures sont i686 et x86_64.
L'up2date
up2date="lynx -dump http://www.kyz.uklinux.net/cabextract.php |grep 'cabextract \ source code'|tr -s ' '|cut -d ' ' -f 6"
Cette ligne est destinée au serveur de frugalware.org pour signaler aux mainteneurs la présence d'une nouvelle version du fichier source. Elle n'est pas toujours facile à faire, voici quelque exemples:
Pour une page comportant le lien vers le tarball en tar.gz, l'up2date devrait ressembler à ceci:
up2date="lynx -dump http://adressedelapage/page.php |grep tar.gz | Flasttar"
Note: S'il y a plusieurs liens pour des tar.gz, pour que l'up2date sélectionne le premier lien, mettez grep -m1 tar.gz.
S'il n'y a pas de page mais juste un espace avec des tarball en tar.bz2,
up2date="lynx -dump http://adressedelapage/ | Flasttarbz2"
Si vraiment vous n'y arrivez pas, vous pouvez bloquer l'up2date et indiquez aux développeurs de Frugalware qu'ils devront corriger la ligne, voilà ce qu'il faut mettre:
up2date=$pkgver #need to be fixed
Source
source=(http://www.kyz.uklinux.net/downloads/$pkgname-$pkgver.tar.gz)
Cette ligne indique l'URL de la source du programme. Ce fichier tar.gz sera téléchargé pour la compilation du paquet.
SHA1SUMS
sha1sums=('094e3afb2fe8dfe82f63731cdcd3b999f4856cff')
Cette ligne indique le SHA1SUM du fichier source de la précédente ligne.
Avec la commande makepkg -g vous aurez le SHA1SUM du fichier source.
Ensuite arrive la partie build, dans l'exemple il n'y en a pas. Allez voir la section plus bas pour les détails.
# optimization OK
# optimization OK
Cette ligne est rajouté automatiquement lors de la compilation ou par la commande fblint. Elle indique que la compilation a été faite par votre $CFLAGS ou $CXXFLAGS.
build
Dans l'exemple plus haut il n'y avait pas de partie build, tout simplement car par défaut si vous ne mettez rien, le build correspond à ceci:
build() { Fpatchall Fmake "$@" Fmakeinstall if echo ${source[@]}|grep -q README.Frugalware; then Fdoc README.Frugalware fi }
Les commandes sont indiquées entre { }.
Si votre paquet se compile avec les banales:
./configure make make install
…alors, là aussi, il n'est pas nécessaire de mettre un build, que c'est pratique… :-D
Nous avons vu sur cette page les fonctions classiques que comporte un FrugalBuild mais il en existe d'autres suivant les cas particuliers: