<?xml version="1.0" encoding="UTF-8"?> <appendix id="installation"> <appendixinfo> <authorgroup> <author >&Jack.H.Ostroff; &Jack.H.Ostroff.mail;</author> </authorgroup> <date >2011-07-20</date> <releaseinfo >4.6</releaseinfo> </appendixinfo> <title >Installazione</title> <para >Questa appendice si riferisce in modo particolare all'installazione di &kappname; usando il sistema operativo &Linux;. L'<link linkend="installation.nonlinux" >ultima sezione</link > riguarda gli altri sistemi operativi. </para> <sect1 id="installation.getting"> <title >Come ottenere &kappname;</title> <para >Nonostante &kappname; esista da vari anni, stiamo ancora lavorando per un'integrazione completa in &kde;. Le prime versioni stabili (1.0.x) richiedevano librerie di &kde; 3, e non erano quindi disponibili in molte distribuzioni Linux, che erano già migrate a &kde; 4. Con il rilascio della versione 4.5 nell'agosto 2010, invece, &kappname; può essere facilmente compilato ed installato su qualsiasi versione di &kde;, 4.3 o superiore. La versione attuale, 4.6, richiede &kde; 4.3, nello specifico kdelibs e kdepimlibs. </para> <para >Il resto di questa sezione descrive l'installazione di &kappname; usando il processo standard di installazione per la tua distribuzione Linux. La sezione successiva tratta invece la compilazione dai sorgenti. </para> <sect2 id="installation.distribution"> <title >Pacchetti ufficiali della distribuzione</title> <para >Il modo migliore di installare &kappname; è di usare il gestore dei pacchetti della tua distribuzione, come apt-get, yum, portage o pacman. In questo modo verranno gestite automaticamente le dipendenze e le librerie necessarie. Nonostante possa passare un po' di tempo dal rilascio di una nuova versione di &kappname; perché essa sia inserita negli archivi ufficiali di tutte le distribuzioni, verifica sempre questa opzione per prima. </para> </sect2> <sect2 id="installation.unsupported"> <title >Repository non supportati</title> <para >Molte distribuzioni Linux hanno repository non supportati, forniti da utenti, che offrono pacchetti più aggiornati dei repository ufficiali della distribuzione. Si può trovare una lista di questi repository nel <ulink url="http://www.kmymoney.org" >sito di &kappname;</ulink >. </para> </sect2> </sect1> <sect1 id="installation.fromsource"> <title >Compilazione di &kappname; dai sorgenti</title> <para >Si possono trovare informazioni più aggiornate sull'ultima versione disponibile e sui problemi di installazione conosciuti nel <ulink url="http://www.kmymoney.org" >sito di &kappname;</ulink >. Questa pagina contiene anche collegamenti ai file compressi delle versioni più recenti, così come le istruzioni per ottenere i sorgenti dal Git di &kde;, nel caso tu voglia compilare l'ultima versione di sviluppo. </para> <para >Come si poteva intuire dal paragrafo precedente, ci sono due possibili ragioni per voler compilare &kappname; dai sorgenti. Se non riesci a trovare una versione pacchettizzata specificamente per la tua distribuzione, scarica il file compressodella versione stabile più recente. Al momento della scrittura di questo manuale, l'ultima versione è la 4.6.0. Questa è la versione consigliata per i normali utenti. </para> <para >Se invece desideri vedere lo stato attuale dello sviluppo, controllare la correzione di un bug o una nuova funzione, puoi scaricare un file compresso contenente i file dell'archivio di sviluppo. Puoi anche ottenere i sorgenti direttamente dall'archivio. La versione 4.x si trova nel Git di &kde;. (I sorgenti delle versioni 1.0.x sono nel cvs di SourceForge, ma non sono più sviluppati). Le istruzioni per l'accesso si trovano nel sito del progetto. </para> <warning> <para >Il codice negli archivi Git ed in quelli di sviluppo è in fase di continuo sviluppo: potrebbe contenere errori, potrebbe bloccarsi, e potrebbe causare il danneggiamento o la perdita di dati. Se lo usi, sii assolutamente sicuro di fare copie di sicurezza adeguate. A meno di non avere una buona ragione per usare questo codice, utilizza una versione stabile. </para> </warning> <sect2 ><title >Librerie richieste</title> <para >Per poter essere compilato ed eseguito correttamente &kappname; necessita di determinate librerie. Innanzi tutto KDE, versione 4.3.5 o successiva, in particolare kdelibs e kdepimlibs. A seconda della tua distribuzione, potresti dover caricare esplicitamente le versioni <quote >-devel</quote > per compilare &kappname;, invece di eseguire semplicemente una versione pre-compilata. Per quanto riguarda la versione 4.6.0, &kappname; dipende anche da libalkimia, versione 4.3.1 o superiore. Ulteriori requisiti possono essere individuati durante la fase di <quote >cmake</quote >, di seguito. </para> <para >Ulteriori funzionalità possono essere ottenute se al momento della compilazione sono disponibili librerie aggiuntive. Le due più comuni sono </para> <itemizedlist> <listitem> <para >libofx, versione 0.9.4 o superiore, per essere in grado di importare dati finanziari nel formato OFX, e</para> </listitem> <listitem> <para >AqBanking, versione 5.0.0 o superiore, per poter utilizzare alcune funzionalità del banking online. Si raccomanda l'utilizzo della versione 5.0.14 o superiore, a causa di errori di programmazione presenti nelle precedenti versioni.</para> </listitem> </itemizedlist> </sect2> <sect2 ><title >Istruzioni di compilazione</title> <para >&kappname; usa il sistema di compilazione cmake. Si possono trovare maggiori informazioni nel file README.cmake presente nella cartella principale dei sorgenti. I comandi base sono i seguenti: </para> <simplelist> <member ><command >$ mkdir build</command ></member> <member ><command >$ cd build</command ></member> <member ><command >$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/</command ></member> <member ><command >$ make</command ></member> <member ><command >$ sudo make install/fast</command ></member> </simplelist> <important ><para >Fa attenzione: l'ultimo passo è necessario. &kappname; si aspetta di trovare certe componenti in posizioni standard, e se lo si esegue dalla cartella di compilazione senza installarlo, ci possono essere icone mancanti o altre sorprese. </para ></important> <para >Se hai compilato i sorgenti da git, e vuoi aggiornarli all'ultima revisione, la maggior parte delle volte puoi fare così: </para> <simplelist> <member ><command >$ cd <cartella principale dei sorgenti></command ></member> <member ><command >$ git pull --rebase</command ></member> <member ><command >$ cd build</command ></member> <member ><command >$ make</command ></member> <member ><command >$ sudo make install/fast</command ></member> </simplelist> <para >Comunque, a volte i cambiamenti fatti dagli sviluppatori producono dei problemi di compilazione se non si parte con una cartella di compilazione nuova. In questi casi, è necessario eseguire i seguenti comandi: </para> <simplelist> <member ><command >$ cd <cartella principale dei sorgenti></command ></member> <member ><command >$ git pull --rebase</command ></member> <member ><command >$ rm -r build</command ></member> <member ><command >$ mkdir build</command ></member> <member ><command >$ cd build</command ></member> <member ><command >$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/</command ></member> <member ><command >$ make</command ></member> <member ><command >$ sudo make install/fast</command ></member> </simplelist> </sect2> </sect1> <sect1 id="installation.nonlinux"> <title >Installazione di &kappname; senza Linux</title> <para >&kappname; è stato compilato con successo per &MacOS; X ed è disponibile nel <ulink url="http://www.macports.com" >sito MacPorts</ulink >. </para> <para >Ci e stato segnalato che &kappname; è disponibile anche per &Windows;. Questa iniziativa costituisce ancora un progetto in evoluzione, e maggiori informazioni possono essere trovare sul sito dell'<ulink url="http://windows.kde.org" >Iniziativa KDE su Windows</ulink >. </para> <para >Se sai che &kappname; è stato compilato con successo e reso disponibile per un altro sistema operativo, faccelo sapere, così possiamo diffondere la notizia. </para> </sect1> </appendix>