News | About | Get Frugalware | Packages | Documentation | Discussion Forums | Bug Tracker | Wiki | Community | Development

FrugalBuild (exemple détaillé)

From FrugalWiki

Jump to: navigation, search

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:

Personal tools
Namespaces
Variants
Actions