Le Dépôt des Utilisateurs de ArchLinux nommé AUR (ArchLinux User-community Repository) est un dépôt dirigé par la communauté des utilisateurs de Arch. Ce document explique comment un utilisateur accède à AUR et comment travailler avec.

L'utilisateur joue un rôle essentiel dans AUR et sans l'appui, la participation et les contributions d'une large communauté d'utilisateur AUR ne peut pas exploiter son potentiel. La durée de vie d'un paquetage sur AUR débute et fini avec l'utilisateur et permet de contribuer de différentes façons.

Les utilisateurs peuvent partager leur PKGBUILD en utilisant l'espace UNSUPPORTED de AUR. UNSUPPORTED ne contient pas de paquetages binaires mais permet aux utilisateurs de mettre leur PKGBUILD à la disposition des autres. Les commentaires permettent à tous de donner leurs impressions et suggestions aux rédacteurs de PKGBUILD. Un système de notation a été mis en place pour permettre aux TU (Utilisateurs de Confiance) de marquer les paquetages comme vérifiés de tout code malveillant. Cependant, ces PKGBUILD ne sont pas officiels et ne sont pas soumis aux contrôles de qualité, donc ils sont à utiliser à vos risques et périls.

Ils n'existe pas d'outil officiel pour télécharger, construire les paquetages depuis UNSUPPORTED mais il existe un utilitaire comme yaourt qui vous sera d'un grand secours.

Le dépôt [community] est un complément aux dépôts [extra] et [core] où les paquetages les plus populaires de UNSUPPORTED sont maintenus par le groupe de TU au nom des utilisateurs. le dépôt [community], contrairement à UNSUPPORTED, contient des paquetages binaires et peut être installé directement avec pacman et les fichiers de compilation sont accessibles depuis ABS. Certains de ces paquetages sont parfois en transition vers les dépôts [core] et [extra] quand les développeurs les considèrent comme essentiels à la distribution.

Les utilisateurs peuvent accéder au dépôt [community] de AUR en ajoutant/décommentant cette ligne dans le fichier pacman.conf :

Include = /etc/pacman.d/community

Si

/etc/pacman.d/community

n'existe pas vous devriez le créér et ajouter ce qui suit :

 [community]
 Server = ftp://ftp.archlinux.org/community/os/i686/

Les utilisateurs peuvent aussi accéder aux fichiers de compilation de [community] en éditant

/etc/abs/abs.conf

comme suit :

 SUPFILES=(arch extra !unstable community)

Une des activités les plus faciles pour tous les utilisateurs de Arch est de se balader dans AUR et de voter pour leurs paquetages favoris. Tous les paquetages sont éligibles pour une adoption par un TU afin d'être inclus dans [community] et le décompte du vote compte dans le processus de considération, chacun est donc intéressé par le vote !

Pour installer un paquetage depuis UNSUPPORTED vous devrez suivre ces étapes :

• Cherchez l'application sur AUR en utilisant le moteur de recherche (l'exemple est réalisé avec un paquetage nommé “exemple”) et cliquez sur le nom du paquetage voulu. Cela affiche la page d'information pour le paquetage. Sur le côté gauche, vous voyez deux liens côte à côte :

  Tarball :: Files

• Cliquez sur

  Tarball

  pour télécharger le (ou les) fichier(s) de compilation sur votre machine. Il devrait se nommer

  exemple.tar.gz

  si ce dernier a été correctement soumis.

• Copiez le tarball

  exemple.tar.gz

  dans le répertoire de compilation, ex :

  /var/abs/local

  ou

  ~/builds

  et décompressez le. Cela devrait créer un nouveau répertoire

  /var/abs/local/exemple

  ou

  ~/builds/exemple

  qui contient tous les fichiers utiles à la création du paquetage.

• IMPORTANT : allez dans le répertoire nouvellement créé et vérifiez soigneusement le PKGBUILD et tous les fichiers .install à la recherche de commandes malsaines : si vous avez le moindre doute NE COMPILEZ PAS le paquetage et cherchez des conseils sur le forum ou la Liste de diffusion.

• Il est préférable d'utiliser

  fakeroot

  pour construire les paquetages (voir ci-dessous), vous devez valider manuellement l'intégrité des fichiers en exécutant simplement

  makepkg

  en utilisateur dans le répertoire de compilation. Les sources vont être téléchargées, vérifiées et compilées.

• makepkg va créer un tarball nommé exemple-i686.pkg.tar.gz qui va pourvoir être installé par pacman comme ceci :

  pacman -U foo.pkg.tar.gz

Note : ce qui suit est une brève explication du processus de compilation. Visitez la page de ABS pour avoir plus d'informations, ce qui est recommandé, particulièrement si vous construisez des paquetages pour la première fois.

fakeroot

permet simplement à un utilisateur normal de prendre les droits root utiles à la création d'un paquetage dans un environnement de construction sans altérer l'intégralité du système. Si la compilation tente d'alterer des fichiers en dehors de l'environnement de compilation, des erreurs sont affichés et la compilation échoue, c'est très pratique pour vérifier la qualité/sécurité/intégrité du PKGBUILD pour diffusion. Par défaut,

export USE_FAKEROOT="y"

est inclus dans

/etc/makepkg.conf

, donc vous devez le désactiver car il est déjà activé.

Après vous être connecté au site de AUR, vous pouvez soumettre un tarball (en tar.gz) contenant un répertoire incluant les fichiers de compilation du paquetage. Le répertoire doit contenir le PKGBUILD, tous les fichiers .install, les patches, … mais AUCUN binaires. Un exemple de ce qui doit se trouver dans le répertoire peut être vu dans /var/abs.

Quand vous soumettez un paquetage, veuillez suivre les règles suivantes :

• Vérifiez [extra], [core], [unstable], UNSUPPORTED, et [community]. Si il existe dans ces dépôts un paquetage semblable sous N'IMPORTE quelle forme, NE PAS soumettre le paquetage (si le paquetage existant est cassé ou si il manque une fonctionnalité, veuillez faire un rapport de bug dans FlySpray).
• Vérifiez attentivement si ce que vous proposez est correct. Tous les contributeurs doivent lire et adhérer aux Standard d'Écriture de Paquetages quand vous écrivez des PKGBUILDs. Ceci est essentiel au bon fonctionnement général de AUR.
• Les paquetages contenant des binaires ou si ils sont vraiment mal rédigés doivent être détruits sans avertissement.
• Si vous n'êtes pas sûr de votre paquetage (de la compilation ou du principe de soumission) dans tout les cas, soumettez votre PKGBUILD sur la liste de diffusion de AUR ou sur le forum public consacré à AUR avant de l'ajouter à AUR.
• Assurer vous que le paquetage est utile. Est ce que quelqu'un d'autre veut utiliser ce paquetage ? Est-il très spécialisé ? Si plus d'une poignée de personnes peut être intéressée par ce paquetage, il est juste de le proposer.
• Obtenez un peu d'expérience avant de soumettre vos paquetages. Construisez en quelques-uns pour apprendre le fonctionnement et les proposer.

• Validez les retours d'expériences et les commentaires des autres utilisateurs et tentez d'ajouter toutes les recommandations qu'ils suggèrent, considérez ça comme un apprentissage.
• S'il vous plait, NE proposez PAS vos paquetages pour les abandonner après. Une fois dans UNSUPPORTED, c'est le travail de l'utilisateur de suivre l'évolution du paquetage et du PKGBUILD.
• Si vous ne souhaitez plus suivre un paquetage pour différentes raisons, sélectionnez

  Abandonner les paquets

  sur l'interface web de AUR et/ou postez un message sur la liste de diffusion de AUR.

• aur-sync (Perl) - for downloading all AUR tarballs
• aur-install (bash)
• aurup (bash) - for uploading packages to AUR
• aurscripts (bash):
  • aurcreate - create clean packages prepared for upload to AUR
  • aurdownload - download and extract packages from AUR
  • aurupdate - update package versions (if specified) and md5sums
• autoaur (bash, depends on aurscripts, will automatically update all of your packages installed from AUR)
• yaourt (bash, a wrapper for srcpac with aur support and more)
• aurbuild (Python, most voted)
• qpkg (Python, works with non-AUR-apps too, second voted, but most advanced?)
• autarchy (bash) - to create a tarball including all files required by the PKGBUILD (better than aurcreate)

All of these scripts can be found in UNSUPPORTED.
__

• Page Originale : http://wiki.archlinux.org/index.php/New_AUR_user_guidelines

En lire plus :

• Standard d'Écriture des Paquetages Arch Linux
• page man francophone de PKGBUILD.5