Difference between revisions of "PKGBUILD (Italiano)"

From ArchWiki
Jump to: navigation, search
m (Variabili)
Line 31: Line 31:
 
;{{codeline|pkgrel}}: Il numero della versione di rilascio del pacchetto specifico di Arch Linux. Questo valore permette agli utenti di distinguere tra build consecutive della stessa versione del pacchetto. Quando una nuova versione del pacchetto viene rilasciata, il '''numero di rilascio parte da 1'''. Nel caso in cui si apportino aggiustamenti e ottimizzazioni al file {{filename|PKGBUILD}}, allora il pacchetto verrà '''ri-rilasciato''' e il '''numero di rilascio''' verrà incrementato di 1. Nel caso in cui esca una nuova versione del pacchetto, il numero di rilascio verrà resettato a 1.
 
;{{codeline|pkgrel}}: Il numero della versione di rilascio del pacchetto specifico di Arch Linux. Questo valore permette agli utenti di distinguere tra build consecutive della stessa versione del pacchetto. Quando una nuova versione del pacchetto viene rilasciata, il '''numero di rilascio parte da 1'''. Nel caso in cui si apportino aggiustamenti e ottimizzazioni al file {{filename|PKGBUILD}}, allora il pacchetto verrà '''ri-rilasciato''' e il '''numero di rilascio''' verrà incrementato di 1. Nel caso in cui esca una nuova versione del pacchetto, il numero di rilascio verrà resettato a 1.
  
;{{codeline|pkgdesc}}: La descrizione del pacchetto. La descrizione dovrebbe essere di circa 80 caratteri o meno e non dovrebbe includere il nome del pacchetto The description should be about 80 characters or less and should not include the package name in modo autoreferenziale.  Per esempio, "Nedit è un editor di testo per X11" si dovrebbe scrivere come "un editor di testo per X11."
+
;{{codeline|pkgdesc}}: La descrizione del pacchetto. La descrizione dovrebbe essere di circa 80 caratteri o meno e non dovrebbe includere il nome del pacchetto stesso.  Per esempio, "Nedit è un editor di testo per X11" si dovrebbe scrivere come "un editor di testo per X11."
  
 
;{{codeline|arch}}: Una array di architetture contro le quali il file  {{Filename|PKGBUILD}} deve essere compilato ed utilizzato. Attualmente, può contenere '''i686''' e/o '''x86_64''', {{codeline|<nowiki>arch=('i686' 'x86_64')</nowiki>}}. E' possibile utilizzare anche il valore '''any''' per i pacchetti indipendenti dall'architettura. E' possibile accedere questo valore durante la compilazione con la variabile {{codeline|$CARCH}}.
 
;{{codeline|arch}}: Una array di architetture contro le quali il file  {{Filename|PKGBUILD}} deve essere compilato ed utilizzato. Attualmente, può contenere '''i686''' e/o '''x86_64''', {{codeline|<nowiki>arch=('i686' 'x86_64')</nowiki>}}. E' possibile utilizzare anche il valore '''any''' per i pacchetti indipendenti dall'architettura. E' possibile accedere questo valore durante la compilazione con la variabile {{codeline|$CARCH}}.
Line 53: Line 53:
 
;{{codeline|makedepends}}: Un array di nomi dei pacchetti che devono essere installati per poter compilare il software ma inutili per poter usare il software dopo l'installazione. E' possibile specificare la versione minima di dipendenza del pacchetto nello stesso formato ell'array {{codeline|depends}}.
 
;{{codeline|makedepends}}: Un array di nomi dei pacchetti che devono essere installati per poter compilare il software ma inutili per poter usare il software dopo l'installazione. E' possibile specificare la versione minima di dipendenza del pacchetto nello stesso formato ell'array {{codeline|depends}}.
  
:{{warning| Qunado si compila con makepkg, si assume che si abbia già installato nel proprio sistema il gruppo "base-devel" . I membri di "base-devel" '''non''' devono essere inclusi nell'array makedepends.}}
+
:{{warning| Quando si compila con makepkg, si assume che si abbia già installato nel proprio sistema il gruppo "base-devel" . I membri di "base-devel" '''non''' devono essere inclusi nell'array makedepends.}}
  
 
;{{codeline|optdepends}}: Un array di nomi dei pacchetti che non sono necessari al software per funzionare ma che forniscono funzionalità aggiuntive. Si dovrebbe aggiungere una piccola descrizione delle funzionalità che ogni pacchetto fornisce. Un'array {{Codeline|optdepends}} deve assomigliare a questo:
 
;{{codeline|optdepends}}: Un array di nomi dei pacchetti che non sono necessari al software per funzionare ma che forniscono funzionalità aggiuntive. Si dovrebbe aggiungere una piccola descrizione delle funzionalità che ogni pacchetto fornisce. Un'array {{Codeline|optdepends}} deve assomigliare a questo:

Revision as of 19:09, 2 July 2010

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary text Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary wiki Template:Article summary end

Un Template:Filename è un file di descrizione della costruzione di pacchetti di Arch Linux, usato durante la creazione dei pacchetti. Questo articolo descrive le possibili variabili del Template:Filename.

Costruire i pacchetti

I pacchetti in Arch Linux sono costruiti utilizzando il comando makepkg e le informazioni sono memorizzate in un file Template:Filename. Quando Template:Codeline viene eseguito, cerca un Template:Filename nella directory corrente e segue le istruzioni ivi contenute per compilare o altrimenti acquisire i file necessari per essere confezionati all'interno di un pacchetto (Template:Filename). Il pacchetto risultante contiene i file binari e le istruzioni di installazione e può essere facilmente installato con pacman. Vedere la creazione dei pacchetti per ulteriori informazioni.

Variabili

Seguono le variabili che si possono utilizzare nel file Template:Filename:

Template:Codeline
Il nome del pacchetto. Dovrebbe consistere nei soli caratteri alfanumerici e tutte le lettere dovrebbero essere in minuscolo. Per motivi di coerenza, il Template:Codeline dovrebbe corrispondere al nome dell'archivio dei sorgenti del software che si sta impacchettando. Per esempio, se il software è in Template:Filename, il valore di Template:Codeline dovrebbe essere foobar. Anche la directory di lavoro in cui risiede il file Template:Filename dovrebbe corrispondere al Template:Codeline.
Template:Codeline
La versione del pacchetto. Il valore dovrebbe essere lo stesso della versione rilasciata dell'autore del pacchetto. Può contenere lettere, numeri e punti ma NON può contenere trattini. Se l'autore del pacchetto usa i trattini nello schema di numerazione della versione, si deve sostituirli con degli underscore. Per esempio, se la versione è 0.99-10, dovrebbe essere cambiata in 0.99_10. Se la variabile pkgver viene usata successivamente nel PKGBUILD, allora l'underscore può essere facilmente sostituito con un trattino, per esempio:
 source=($pkgname-${pkgver/_/-}.tar.gz)
Template:Codeline
Il numero della versione di rilascio del pacchetto specifico di Arch Linux. Questo valore permette agli utenti di distinguere tra build consecutive della stessa versione del pacchetto. Quando una nuova versione del pacchetto viene rilasciata, il numero di rilascio parte da 1. Nel caso in cui si apportino aggiustamenti e ottimizzazioni al file Template:Filename, allora il pacchetto verrà ri-rilasciato e il numero di rilascio verrà incrementato di 1. Nel caso in cui esca una nuova versione del pacchetto, il numero di rilascio verrà resettato a 1.
Template:Codeline
La descrizione del pacchetto. La descrizione dovrebbe essere di circa 80 caratteri o meno e non dovrebbe includere il nome del pacchetto stesso. Per esempio, "Nedit è un editor di testo per X11" si dovrebbe scrivere come "un editor di testo per X11."
Template:Codeline
Una array di architetture contro le quali il file Template:Filename deve essere compilato ed utilizzato. Attualmente, può contenere i686 e/o x86_64, Template:Codeline. E' possibile utilizzare anche il valore any per i pacchetti indipendenti dall'architettura. E' possibile accedere questo valore durante la compilazione con la variabile Template:Codeline.
Template:Codeline
L'URL del sito ufficiale del software che si sta pacchettizzando.
Template:Codeline
La licenza con la quale il software è distribuito. Il pacchetto Template:Package Official presente in Template:Codeline fornisce le licenze più comuni in Template:Filename, per esempio Template:Filename. Se un pacchetto è munito di una di queste licenze, il valore dovrebbe essere impostato al nome della directory, per esempio Template:Codeline. Se la licenza appropriata non è inclusa del pacchetto ufficiale Template:Package Official, si devono fare alcune cose:
  1. Il file della licenza dovrebbe essere incluso in: Template:Filename, per esempio Template:Filename.
  2. Se l'archivio dei sorgenti NON contiene i dettagli della licenza ed essa è visualizzata altrove, ad esempio su un sito web, allora si doverbbe copiare la licenza su un file da includere.
  3. Aggiungere custom all'array delle Template:Codeline. Facoltativamente, si può rimpiazzare custom con custom:nome della licenza. Una volta che la licenza è utilizzata in due o più pacchetti dei repository ufficiali (incluso Template:Codeline), entrerà a far parte del pacchetto Template:Package Official.
  • Le licenze BSD, MIT, zlib/png and Python sono casi speciali e potrebbero non essere inclusi nel pacchetto Template:Package Official. Per quanto riguarda l'array Template:Codeline, queste vengono trattate come licenze comuni (Template:Codeline, Template:Codeline, Template:Codeline e Template:Codeline) ma tecnicamente ognuna è una licenza custom poiché ha il proprio copyright. Ogni pacchetto munito di una di queste quattro licenze dovrebbe avere la propria salvata in Template:Filename. Alcuni pacchetti potrebbero non essere coperti da una sola licenza. In questi casi, sono possibili più voci nell'array license, ad esempio Template:Codeline.
  • Inoltre, le (L)GPL hanno diverse versioni e permutazioni di queste versioni. Per il software (L)GPL, la convenzione è:
    • (L)GPL - (L)GPLv2 o qualsiasi versione successiva
    • (L)GPL2 - (L)GPL2 solamente
    • (L)GPL3 - (L)GPL3 o qualsiasi versione successiva
Template:Codeline
Il gruppo al quale appartiene il pacchetto. Per esempio, quando si installa il pacchetto Template:Package Official, si installano tutti i pacchetti che appartengono al gruppo kde.
Template:Codeline
Un array di nomi dei pacchetti che devono essere installati per poter poi lanciare questo software. Se il software richiede una versione minima di una dipendenza, si dovrebbe usare l'operatore >= per sottolinearlo, ad esempio: Template:Codeline. Non è necessario elencare i pacchetti che il software richiede come dipendenza se questi sono già richiesti come tale dagli altri pacchetti elencati nell'array. Per esempio, gtk2 dipende da glib2 e glibc. Tuttavia, glibc non è necessita di essere elencato come dipendenza per gtk2 visto che è dipendenza per glib2.
Template:Codeline
Un array di nomi dei pacchetti che devono essere installati per poter compilare il software ma inutili per poter usare il software dopo l'installazione. E' possibile specificare la versione minima di dipendenza del pacchetto nello stesso formato ell'array Template:Codeline.
Warning: Quando si compila con makepkg, si assume che si abbia già installato nel proprio sistema il gruppo "base-devel" . I membri di "base-devel" non devono essere inclusi nell'array makedepends.
Template:Codeline
Un array di nomi dei pacchetti che non sono necessari al software per funzionare ma che forniscono funzionalità aggiuntive. Si dovrebbe aggiungere una piccola descrizione delle funzionalità che ogni pacchetto fornisce. Un'array Template:Codeline deve assomigliare a questo:
optdepends=('cups: supporto per la stampa'
'sane: supporto per gli scanner'
'libgphoto2: supporto per le fotocamere digitali'
'alsa-lib: supporto per l'audio'
'giflib: supporto per le immagini GIF'
'libjpeg: supporto per le immagini JPEG'
'libpng: supporto per le immagini PNG')
Template:Codeline
Un array di nomi dei pacchetti dei quali questo software fornisce le funzionalità (oppure un pacchetto virtuale come cron o sh). Se si usa questa variabile, si dovrebbe aggiungere la versione (Template:Codeline e magari la Template:Codeline) che questo pacchetto fornisce se le dipendenze possono esserne influenzate. Per esempio, se si vuole fornire una versione modificata di qt chiamata qt-foobar versione 3.3.8 che fornisce qt allora l'array Template:Codeline dovrebbe essere: Template:Codeline. Mettere Template:Codeline causerà il fallimento di quelle dipendenze che richiedono una specifica versione di qt. Non aggiungere Template:Codeline all'array provide, viene fatto in automatico.
Template:Codeline
Un array di nomi dei pacchetti che possono causare problemi con questo pacchetto installato. Si possono anche specificare le proprietà delle versioni dei pacchetti che vanno in conflitto nello stesso formato dell'array Template:Codeline.
Template:Codeline
Un array di nomi dei pacchetti obsoleti che sono rimpiazzati da questo pacchetto, per esempio: Template:Codeline per il pacchettoTemplate:Package Official. Dopo aver aggiornato il database con Template:Codeline, rimpiazzerà immediatamente un pacchetto installato con un altro pacchetto dei repository, accoppiato relativamente a Template:Codeline. Se si sta fornendo una versione sostitutiva di un pacchetto esistente, si dovrà usare la variabile Template:Codeline la quale è valutata soltanto nel momento in cui si installerà il pacchetto in conflitto.
Template:Codeline
Un array di file da salvare come Template:Filename quando il pacchetto viene rimosso. Questa variabile è comunemente usata con i pacchetti che mettono i loro file di configurazione in Template:Filename. I percorsi dei file in questo array dovrebbero essere percorsi relativi (ad esempio Template:Filename) non assoluti (come Template:Filename).
Template:Codeline
Questo array permette di sovrascrivere alcuni dei comportamenti di default di Template:Codeline. Per impostare un'opzione, si deve includere il nome dell'opzione nell'array. Per invertire il comportamento di default, si deve mettere un ! davanti l'opzione. Questo è un elenco delle opzioni che si possono mettere nell'array:
  • strip - Toglie i simboli dai binari e dalle librerie.
  • docs - Salva le directory Template:Filename.
  • libtool - Lascia i file di libtool (Template:Filename) nel pacchetto.
  • emptydirs - Lascia le directory vuote nel pacchetto.
  • zipman - Comprime le pagine di man e info con gzip.
  • ccache - Permette l'uso di Template:Codeline durante la compilazione. Con i pacchetti che hanno problemi con Template:Codeline durante la compilazione è più utile nella sua forma negata Template:Codeline.
  • distcc - Permette l'uso di Template:Codeline durante la compilazione. Con i pacchetti che hanno problemi con Template:Codeline durante la compilazione è più utile nella sua forma negata Template:Codeline.
  • makeflags - Permette l'uso di Template:Codeline specifiche per l'utente durante la compilazione. Con i pacchetti che hanno problemi con Template:Codeline durante la compilazione è più utile nella sua forma negata Template:Codeline.
  • force - Forza l'aggiornamento del pacchetto attraverso l'operazione di aggiornamento del sistema di pacman, anche se il numero di versione normalmente non avrebbe innescato tale aggiornamento. Questa opzione è utile quando si cambia lo schema di numerazione della versione del pacchetto (o è alfanumerico) oppure quando è richiesto un downgrade per ragioni di sicurezza.
Template:Codeline 
Il nome dello script di Template:Filename che deve essere incluso nel pacchetto. Pacman ha l'abilità di memorizzare ed eseguire uno script specifico per pacchetto quando installa, rimuove o aggiorna un pacchetto. Lo script contiene le seguenti istruzioni che vengono eseguite in tempi diversi:
  • pre_install - Lo script è lanciato appena prima dell'estrazione dei file. La nuova versione del pacchetto viene passata come argomento alla funzione.
  • post_install - Lo script è lanciato appena dopo l'estrazione dei file. La nuova versione del pacchetto viene passata come argomento alla funzione.
  • pre_upgrade - Lo script è lanciato appena prima dell'estrazione dei file. La nuova e la vecchia versione del pacchetto vengono passate come argomento alla funzione.
  • post_upgrade - Lo script è lanciato appena dopo dell'estrazione dei file. La nuova e la vecchia versione del pacchetto vengono passate come argomento alla funzione.
  • pre_remove - Lo script è lanciato appena che i file vengano rimossi. La vecchia versione del pacchetto viene passata come argomento alla funzione.
  • post_remove - Lo script è lanciato dopo che i file vengano rimossi. La vecchia versione del pacchetto viene passata come argomento alla funzione.
Tip: Un prototipo Template:Filename è disponibile al Template:Filename.
Template:Codeline 
un array di file che sono necessari per compilare il pacchetto. Deve contenere la locazione dei sorgenti del software, che in quasi tutte le occasioni è un completo URL HTTP o FTP. Le variabili precendentemente impostatate Template:Codeline e Template:Codeline possono essere usate efficacemente qui (per esempio Template:Codeline)
Note: Se si ha il bisogno di fornire file che non sono scaricabili al volo, per esempio patch fatte in proprio, è possibile mettere questi file nella stessa directory del proprio Template:Filename e aggiungere il nome del file a questo array. Qualsiasi percorso viene aggiunto qui è risolto relativamente alla directory in cui giace il Template:Filename. Prima che il processo di compilazione parta, tutti i file Before the actual build process is started, all of the files che sono riferiti in questo array, verranno scaricati o controllati in sussistenza, e Template:Codeline non procederà oltre se qualcuno manca.
Template:Codeline
Un array di file elencati nell'array Template:Codeline che non dovrebbero essere estratti dal loro archivio da Template:Codeline. Per lo più si applica a certi file zip che non possono essere gestiti da bsdtar visto che libarchive processa tutti i file come flussi piuttosto che ad accesso casuale come fa unzip. In queste situazioni si dovrebbe aggiungere unzip all'array Template:Codeline e le prime linee della funzione Template:Codeline dovrebbero contenere:
cd $srcdir/$pkgname-$pkgver
unzip [source].zip
Template:Codeline
Un array di checksum MD5 dei file elencati nell'array Template:Codeline. Una volta che tutti i file presenti nell'array Template:Codeline saranno disponibili, per ogni file verrà generato automaticamente un hash MD5 e confrontato con il valore di questo array nello stesso ordine in cui appare nell'array Template:Codeline. Mentre l'ordine dell'array source non è rilevante, è importante che questo combaci con l'ordine di questo array dato che Template:Codeline non può indovinare a quale file sorgente appartenga la checksum. E' possibile generare questo array rapidamente e facilmente usando il comando Template:Codeline nella directory che contiene il file Template:Filename. Notare che l'algoritmo MD5 è noto per avere falle, quindi si dovrebbero considerare alternative più sicure.
Template:Codeline 
Un array di checksum SHA-1 a 160-bit. Questa è un'alternativa alle md5sums descritte in precedenza, ma anch'esse sono note per avere delle debolezze, quindi si dovrebbero considerare alternative più sicure. Per abilitare l'uso e la generazione di queste checksums, assicurarsi di impostare l'opzione INTEGRITY_CHECK in makepkg.conf. Vedere man makepkg.conf.
Template:Codeline 
Un array di checksum SHA-2 con dimensione del digest di 256, 384 e 512 bit rispettivamente. Queste sono delle alternative alle md5sums descritte in precedenza e sono generalmente considerate più sicure. Per abilitare l'uso e la generazione di queste checksums, assicurarsi di impostare l'opzione INTEGRITY_CHECK in makepkg.conf. Vedere man makepkg.conf.

E' prassi comune per preservare l'ordine delle variabili del Template:Filename come sono state mostrate in precedenza. Ad ogni modo, non è obbligatorio, dato che il solo requisito in questo contesto è la sintassi corretta di Bash.