Difference between revisions of "AUR User Guidelines (Italiano)"

From ArchWiki
Jump to: navigation, search
m
m (rm all traces of [unstable] (and other cruft))
Line 43: Line 43:
 
Server = ftp://ftp.archlinux.org/community/os/i686/</pre>
 
Server = ftp://ftp.archlinux.org/community/os/i686/</pre>
  
Gli utenti possono anche accedere ai file in [community] modificando il file <code>/etc/abs/abs.conf</code> nel seguente modo:
+
Gli utenti possono anche accedere ai file in [community] modificando il file <code>/etc/abs.conf</code> nel seguente modo:
<pre>SUPFILES=(arch extra !unstable community)</pre>
+
<pre>REPOS=(core extra community)</pre>
  
 
===Votazione===
 
===Votazione===
Line 79: Line 79:
  
 
When submitting a package, observe the following rules:  
 
When submitting a package, observe the following rules:  
* Check [extra], [core], [unstable], UNSUPPORTED, and [community] for the package. If it is inside any of those repositories in ANY form, DO NOT submit the package (if the current package is broken or is lacking an included feature then please file a bug report in [http://bugs.archlinux.org/ FlySpray]).
+
* Check [extra], [core], UNSUPPORTED, and [community] for the package. If it is inside any of those repositories in ANY form, DO NOT submit the package (if the current package is broken or is lacking an included feature then please file a bug report in [http://bugs.archlinux.org/ FlySpray]).
 
* Verify carefully that what you are uploading is correct. All contributors must read and adhere to the [[Arch Packaging Standards]] when writing PKGBUILDs.  This is essential to the smooth running and general success of the AUR.  Remember you are not going to earn any credit or respect from your peers by wasting their time with a bad PKGBUILD.
 
* Verify carefully that what you are uploading is correct. All contributors must read and adhere to the [[Arch Packaging Standards]] when writing PKGBUILDs.  This is essential to the smooth running and general success of the AUR.  Remember you are not going to earn any credit or respect from your peers by wasting their time with a bad PKGBUILD.
 
* Packages that contain binaries or that are very poorly written may be deleted without warning.
 
* Packages that contain binaries or that are very poorly written may be deleted without warning.

Revision as of 17:27, 14 December 2008

Tango-preferences-desktop-locale.pngThis article or section needs to be translated.Tango-preferences-desktop-locale.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:AUR User Guidelines (Italiano)#)
Summary help replacing me
Explains how to access and use the Arch User Repository
Available in languages

Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry

Related articles
AUR Trusted User Guidelines
AUR
AUR Q & A
Aurbuild

Obiettivo

ArchLinux User-community Repository (AUR) è un repository gestito dalla community per gli utenti di Arch. Questo documento mostra agli utenti come accedere ad AUR e come utilizzarlo.

L'utente e AUR

Gli utenti ricoprono un ruolo essenziale per AUR e senza il supporto, il coinvolgimento e il contributo dell'ampia community di utenti, AUR non riesce ad esprimere il suo potenziale. Il ciclo di vita di un pacchetto AUR comincia e finisce con l'utente e richiede il contributo dell'utente in diversi modi.

Condividere i PKGBUILD in UNSUPPORTED

Gli utenti possono condividere i PKGBUILD usando l'area UNSUPPORTED di AUR. Quest'area non contiene nessun pacchetto binario ma permette agli utenti di caricare i PKGBUILD in modo che possano essere scaricati da chiunque. La zona dei commenti permette agli utenti di fornire suggerimenti e feedback all'autore del PKGBUILD. Un nuovo sistema di flagging permette di segnalare pacchetti che presentano codice dannoso. Tuttavia, questi PKGBUILD non sono ufficiali e non sono stati controllati a fondo, perciò se li utilizzerete, sarà a vostro rischio e pericolo.

Non ci sono ancora dei meccanismi ufficiali per scaricare il materiale già compilato da UNSUPPORTED, ma si possono trovare degli script nel wiki.

[community]

Il repository [community] è un supplemento ai repository [extra] e [core] dove i pacchetti più utilizzati di UNSUPPORTED vengono gestiti dal gruppo TU (Trust Users ovvero Utenti Affidabili). [community], a differenza di UNSUPPORTED, contiene i pacchetti binari che possono essere installati direttamente con pacman e si può accedere a tali file anche con ABS. Alcuni di questi pacchetti possono eventualmente spostarsi nei repository [core] o [extra] se gli sviluppatori li considerano importanti per la distribuzione.

Gli utenti possono accedere al repository [community] di AUR aggiungendo (o decommentando) questa riga nel file pacman.conf:

Include = /etc/pacman.d/community

Se il file /etc/pacman.d/community non esiste va creato come semplice file di testo, inserendo:

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

Gli utenti possono anche accedere ai file in [community] modificando il file /etc/abs.conf nel seguente modo:

REPOS=(core extra community)

Votazione

Una delle attività più facili per tutti gli utenti di Arch è sfogliare AUR e votare i pacchetti preferiti usando l'interfaccia online. Qualunque pacchetto può, per decisione del gruppo TU (Trust Users), entrare a far parte del repository [community], e il conteggio dei voti è uno degli aspetti che servono per decidere - perciò è nell'interesse di ognuno votare!

Come usare AUR

Usare i pacchetti da UNSUPPORTED

Per installare un pacchetto da UNSUPPORTED bisogna seguire questi passi:

  • trovare l'applicazione in AUR usando la funzione cerca (noi come esempio assumeremo foo come il nome del pacchetto) e cliccare il nome del pacchetto nella lista dei risultati. Verrà poi caricata la pagina con le informazioni del pacchetto. Sulla sinistra ci sono due link vicini:
 Tarball :: Files 
  • cliccare il link Tarball per scaricare i file necessari sul proprio hard disk. I file saranno contenuti in un archivio del tipo foo.tar.gz, se avete scaricato il file corretto.
  • copiare l'archivio foo.tar.gz in una cartella per la compilazione, per esempio /var/abs/local o ~/builds, ed estrarre l'archivio. Verrà creata una nuova cartella, /var/abs/local/foo o ~/builds/foo che conterrà tutti i file necessari per compilare il pacchetto.
  • IMPORTANTE: controllate nella nuova cartella che il PKGBUILD e qualsiasi file di installazione non contengano codice dannoso - se avete dei dubbi NON COMPILATE il pacchetto e segnalatelo nel forum o nella mailing list.
  • è consigliato l'utilizzo di fakeroot per compilare i pacchetti (vedere sotto), così si avrà la conferma manuale dell'integrità dei file semplicemente eseguendo makepkg da normale utente nella cartella di compilazione. I sorgenti verranno scaricati, controllati e compilati come di norma.
  • makepkg dovrebbe creare un pacchetto con nome foo.pkg.tar.gz che può essere installato con pacman col comando:
 pacman -U foo.pkg.tar.gz

Attenzione: quanto appena descritto è una breve sintesi del processo di compilazione dei pacchetti. Una visita sul sito di ABS fornirà tutti i dettagli, ed è altamente consigliata, in particolare per coloro che compilano per la prima volta.

Usare fakeroot

fakeroot permette ad un utente normale di assegnare i permessi di root nell'ambiente di compilazione del pacchetto, impedendogli di alterare l'intero sistema. Se il processo di compilazione prova ad alterare dei file al di fuori dell'ambiente di compilazione, vengono generati degli errori e la compilazione fallisce - questo sistema è molto utile per controllare la qualità/sicurezza/integrità dei PKGBUILD. L'opzione predefinita export USE_FAKEROOT="y" è inclusa nel file /etc/makepkg.conf, a meno che non venga modificata, fakeroot è sempre attivo.

Inviare i pacchetti a UNSUPPORTED

Dopo aver effettuato l'accesso all'interfaccia web di AUR, un utente può inviare il file zippato (tar.gz) contenente la directory e i file necessari per costruire il pacchetto. La directory deve contenere solamente un PKGBUILD, qualsiasi .install files necessari, patch etc (ASSOLUTAMENTE niente binari). Un esempio di ciò che dovrebbe contenere tale directory può essere visto all'interno della directory /var/abs.

Note that this is a gzipped tarball - ie. assuming you're uploading a package called 'libfoo', when you create the file it should look similar to this (note the -zcvvf option to tar):

   $ ls -a libfoo
   . .. PKGBUILD libfoo.install
   $ tar -zcvvf libfoo.tar.gz libfoo
   a libfoo
   a libfoo/PKGBUILD
   a libfoo/libfoo.install

When submitting a package, observe the following rules:

  • Check [extra], [core], UNSUPPORTED, and [community] for the package. If it is inside any of those repositories in ANY form, DO NOT submit the package (if the current package is broken or is lacking an included feature then please file a bug report in FlySpray).
  • Verify carefully that what you are uploading is correct. All contributors must read and adhere to the Arch Packaging Standards when writing PKGBUILDs. This is essential to the smooth running and general success of the AUR. Remember you are not going to earn any credit or respect from your peers by wasting their time with a bad PKGBUILD.
  • Packages that contain binaries or that are very poorly written may be deleted without warning.
  • If you are unsure about the package (or the build/submission process) in any way, submit the PKGBUILD to the AUR Mailing List or the AUR boards on the forum for public review before adding it to the AUR.
  • Make sure the package is useful. Will anyone else want to use this package? Is it extremely specialized? If more than a few people would find this package useful, it is appropriate for submission.
  • Gain some experience before submitting packages. Build a few packages to learn the process and then submit.
  • If you submit a package.tar.gz with a file named 'package' in it you'll get a an error: 'Could not change to directory /home/aur/unsupported/package/package'. To resolve this rename the file named 'package' to something else, for example, 'package.rc'. When it is installed in the pkg directory you may rename it back to 'package'.

Maintaining Packages in UNSUPPORTED

  • Check for feedback and comments from other users and try to incorporate any improvements they suggest; consider it a learning process!
  • Please DO NOT just submit and forget about packages! While in UNSUPPORTED, it is the user's job to maintain the package by checking for updates and improving the PKGBUILD.
  • If you do not want to continue to maintain the package for some reason, disown the pkg using the AUR web interface and/or post a message to the AUR Mailing List.

AUR-DMS (downloading and management scripts)

List of AUR-DMS

  1. aurbuild (Python)
  2. aur-install (bash)
  3. aur-sync (Perl) - for downloading all AUR tarballs
  4. aurscripts (bash):
    1. aurcreate - create clean packages prepared for upload to AUR
    2. aurdownload - download and extract packages from AUR
    3. aurupdate - update package versions (if specified) and md5sums
  5. aurup (bash) - for uploading packages to AUR
  6. autarchy (bash) - to create a tarball including all files required by the PKGBUILD (better than aurcreate)
  7. autoaur (bash, depends on aurscripts, will automatically update all of your packages installed from AUR)
  8. qpkg (Python, works with non-AUR-apps too, *discontinued*)
  9. yaourt (bash, a wrapper for srcpac with AUR support and more)

All of these scripts can be found in UNSUPPORTED.