AUR User Guidelines (Français)
From ArchWiki
Article summary |
---|
Explains how to access and use the Arch User Repository |
Available in languages |
Česky |
Dansk |
English |
Español |
Français |
Italiano |
Русский |
简体中文 |
Related articles |
AUR Trusted User Guidelines |
AUR |
AUR Q & A |
Aurbuild |
Contents |
Objet
L'ArchLinux User-community Repository (AUR) est un dépot maintenu par la communauté d'utilisateurs d'Arch Linux. Ce document montre comment pour un simple utilisateur, il est possible d'accéder et d'utiliser AUR .
Comment utiliser AUR
Utiliser les paquets UNSUPPORTED
Pour installer un paquet UNSUPPORTED, vous devez suivre ces étapes:
- Trouvez l'application dans AUR en utilisant la fonction rechercher (nous allons utiliser foo comme exemple de nom de paquet dans la suite de la page) et cliquez sur le nom du paquet voulu dans la liste de résultats. Ceci fera apparaître une page d'information à propos du paquet. Sur le côté gauche, on peut voir deux liens côte à côte:
Tarball :: Files
- Cliquez sur
Tarball
pour télécharger les fichiers nécessaires à la construction du paquet. Si le paquet a été correctement soumis à AUR, il devrait porter le nomfoo.tar.gz
. - Copiez le fichier
foo.tar.gz
dans un répertoire approprié tel que/var/abs/local
ou~/builds
avant de l'extraire. Cela devrait créer un nouveau répertoire :/var/abs/local/foo
ou~/builds/foo
contenant tout les fichiers nécessaires à la construction du paquet. - IMPORTANT:
cd
dans le nouveau répertoire et vérifiez le fichier PKGBUILD ainsi que les fichiers .install - en cas de doute NE PAS construire le paquet et rechercher des conseils sur les forums ou mailing list. - Il est conseillé d'utiliser
fakeroot
pour construire un paquet. Une fois que tout est vérifié, lancez simplementmakepkg
en tant qu'utilisateur dans le dossierbuilds
. Les fichiers sources seront téléchargés, vérifiés puis compilés. - makepkg devrait créer une tarball nommée foo.pkg.tar.gz que l'on peut installer avec pacman :
pacman -U foo.pkg.tar.gz
Remarque : les informations ci-dessus sont un bref résumé du processus de construction de paquet. Une visite sur la page d'ABS donnera plus de détails. Il est vivement recommandé d'y faire un tour, surtout pour les premières constructions de paquets.
Utiliser fakeroot
fakeroot
permet à un utilisateur normal d'avoir les permissions root nécessaires à la création du paquet dans l'environnement de construction sans pouvoir endommager le système tout entier. Si pendant le processus de construction, un fichier hors de l'environnement de construction est modifié, une erreur est déclenchée et interrompt la construction du paquet - ceci est très pratique pour vérifier la qualité et l'intégrité du PKGBUILD. Par défaut la ligne export USE_FAKEROOT="y"
se trouve dans le fichier /etc/makepkg.conf
, donc à moins de l'avoir modifié, l'utilisation de fakeroot est déjà activée.
Soumettre un paquet UNSUPPORTED
Une fois identifié sur l'interface web d'AUR, un utilisateur peut soumettre une tarball compressée (tar.gz) du répertoire contenant les fichiers de construction du paquet. Ce répertoire doit contenir le PKGBUILD, les fichiers .install, patchs etc... (AUCUN fichier binaire). On peut trouver des exemples de tels répertoires dans /var/abs
Remarquez que ceci une une archive compressée - c'est-à-dire que si vous voulez soumettre un paquet nommé 'libfoo', vous devez créer un fichier qui ressemble à ceci :
$ ls -a libfoo . .. PKGBUILD libfoo.install $ tar -zcvvf libfoo.tar.gz libfoo a libfoo a libfoo/PKGBUILD a libfoo/libfoo.install
Lorsque vous soumettez un paquet, suivez les règles suivantes:
- Cherchez le paquet dans les dépôts [extra], [core], UNSUPPORTED, and [community]. S'il se trouve dans l'un d'entre eux, NE le soumettez PAS (si le paquet est endommagé, ou nécessite un ajout, faites un rapport de bug FlySpray).
- Vérifiez attentivement que ce que vous soumettez est correct. Toutes personnes voulant contribuer doit avoir lu et accepté les Arch Packaging Standards avant d'écrire un PKGBUILD. C'est essentiel pour assurer l'homogénéité et le succès d'AUR. Souvenez vous que vous ne gagnerez pas le respect et la reconnaissance de vos pairs en leur faisant perdre leur temps avec des paquets défectueux.
- Les paquets contenant des fichiers binaires ou qui sont très mal écrits seront tous simplement détruits.
- Si vous n'êtes pas certain de votre paquet, soumettez le PKGBUILD à la Mailing list de AUR ou sur le forum.
- Soyez certain que ce paquet soit utile. Est-ce que d'autres personnes vont l'utiliser ?
- Gagner un peu d'expérience avant de soumettre des paquets. Créer quelques paquets pour vous entrainer avant d'en soumettre.
- Si vous soumettez un
package.tar.gz
qui contient un fichier appelé 'package', vous allez obtenir une erreur : 'Could not change to directory /home/aur/unsupported/package/package'. Pour l'éviter, il faut renommer le fichier 'package' en 'package.rc', par exemple, puis le renommer 'package' pendant la phase d'installation.
Maintenir les paquets UNSUPPORTED
- Prenez en considération les retours et les commentaires des autres utilisateurs et essayez d'utiliser ces suggestions pour améliorer les différents paquets ; considérez cela comme une phase d'apprentissage.
- NE PAS laisser le paquet à l'abandon un fois qu'il est soumis ! Tant que le paquet reste dans le dépôt UNSUPPORTED, c'est à l'utilisateur que revient la charge de maintenir, de vérifier les mise à jour et de chercher à améliorer le PKGBUILD.
- Si pour une raison quelconque, vous ne pouvez plus assurer la maintenance du paquet, vous pouvez "l'abandonner" en cliquant sur
disown
dans l'interface web de AUR et/ou poster un message dans la mailing list de AUR.
L'utilisateur et l'AUR
L'utilisateur normal joue un rôle essentiel dans AUR et sans cela, sans l'implication et la contribution d'une large communauté, AUR ne pourrait pas profiter entièrement de son potentiel. Le cycle de vie d'un paquet dans AUR commence et s'arrête avec l'utilisateur, qui peut contribuer de différentes manières.
Partager des PKGBUILDs dans le dépôt UNSUPPORTED
Les utilisateurs peuvent partager des PKGBUILDs en utilisant le dépôt UNSUPPORTED de AUR. UNSUPPORTED ne contient aucun paquet binaire mais laisse la possibilité aux utilisateurs de soumettre les PKGBUILDs qui peuvent alors être téléchargés par d'autres. Un système de commentaires permet à chacun de donner des retours et des suggestions pour améliorer le PKGBUILD. Un nouveau système de flag permet aux TUs d'identifier les paquets comme ne comportant pas de code dangereux : "checked for malicious code". Cependant ces PKGBUILDs ne sont pas officiels et n'ont pas été entièrement examinés, donc vous les utilisez à vos risques et périls.
Il n'existe pas encore de système officiel de téléchargement et d'installation des paquets UNSUPPORTED mais vous trouverez quelques scripts sur le wiki.
[community]
Le dépôt [community] est un complément aux dépots [extra] et [core] où l'on peut trouver les paquets les plus populaires provenant du dépôt UNSUPPORTED. Il est maintenu par les Trusted Users, un groupe qui représente les utilisateurs. [community], à la différence du dépôt UNSUPPORTED, contient des paquets binaires que l'on peut installer directement à l'aide de pacman et les fichiers de "build" peuvent être accessibles par ABS. Certains de ces paquets peuvent ensuite migrer vers [core] ou [extra] si les développeurs pensent qu'ils sont indispensables à la distribution.
Il est possible d'accéder au dépôt [community] en ajoutant cette ligne dans le fichier pacman.conf:
Include = /etc/pacman.d/community
Il est donc nécessaire de posséder un fichier /etc/pacman.d/community
. Si ce n'est pas le cas, vous pouvez en créer un et lui ajouter cette ligne (qui est un lien vers un dépôt [community]):
[community] Server = ftp://ftp.archlinux.org/community/os/i686/
Le dépôt [community] peut être accessible depuis ABS en éditant le fichier /etc/abs.conf
:
REPOS=(core extra community)
Voter
Une des plus simples activités que chaque utilisateur d'ArchLinux peut faire consiste à parcourir AUR et à voter pour ses paquets préférés en utilisant l'interface web. N'importe quel paquet peut être élu par les TUs pour figurer dans le dépôt [community], et le nombre de vote entre en compte lors de ce choix - c'est donc dans l'intérêt de tous de voter !
AUR-DMS (downloading and management scripts)
Liste de AUR-DMS
- aurbuild (Python)
- aur-install (bash)
- aur-sync (Perl) - for downloading all AUR tarballs
- 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
- aurup (bash) - for uploading packages to AUR
- autoaur (bash, depends on aurscripts, will automatically update all of your packages installed from AUR)
- autarchy (bash) - to create a tarball including all files required by the PKGBUILD (better than aurcreate)
- qpkg (Python, works with non-AUR-apps too, *discontinued*)
- yaourt (bash, a wrapper for srcpac with AUR support and more)
All of these scripts can be found in UNSUPPORTED.