====== Pense-bête pour utiliser la collection des sources XBPS ======

L'ensemble des « recettes » des paquets chez Void Linux est disponible à cette [[https://github.com/void-linux/void-packages|adresse]].

Un guide (non officiel) est consultable [[https://xbps-src-tutorials.github.io/|ici]].

Il faut dans un premier temps, cloner ce dépôt.

<code>
git clone https://github.com/void-linux/void-packages.git
cd void-packages/
./xbps-src binary-bootstrap
</code>

<WRAP center shadow info 60%>
Si c'est ponctuel, on souhaite uniquement mettre à jour les sources d'un paquet, il vaut mieux ne pas « télécharger » tout l'historique du dépôt (on parle de //git shallow clone//).

Le commande à utiliser est la suivante :

<code>git clone --depth=1 https://github.com/void-linux/void-packages.git</code>
</WRAP>


<WRAP center shadow help 60%>
On installe un paquet à partir des sources de cette manière : ''xbps-install --repository''.

Il faut préciser le chemin absolu (l'installation d'un logiciel, requiert des droits privilégiés, **root**).
</WRAP>

===== Mettre à jour =====

On peut vérifier si une nouvelle version est disponible (par exemple [[https://github.com/elementary/gala|gala]])

<code>
./xbps-src update-check gala</code>

Si c'est le cas, il faut modifier la valeur de la variable **version** dans le fichier ''srcpkgs/gala/template''.

Ensuite, on doit regénérer le //checksum//

<code>xgensum -if srcpkgs/gala/template</code>

===== Créer un nouveau paquet =====

<code>xnew gala</code>

On remplie les différents champs. Pensez à consulter cette [[https://github.com/void-linux/void-packages/blob/master/Manual.md|page]] (tout y est détaillé).

===== Construire un paquet =====

<code>./xbps-src pkg gala</code>

<WRAP center shadow tip 60%>
Avant de construire le paquet, il vaut mieux s'assurer que tout compile

<code>./xbps-src build gala</code>

On peut « regarder » quels fichiers vont être installer sur le système. C'est utile, si on doit créer des [[https://github.com/void-linux/void-packages/blob/master/Manual.md#pkgs_sub|sous-paquets]].

<code>./xbps-src install gala</code>

Les fichiers seront situés dans un répertoire situé dans ''masterdir/destdir/''.

Ne pas oublier de faire un nettoyage avant de construire un paquet

<code>./xbps-src clean gala</code>
</WRAP>