<?xml version="1.0" encoding="UTF-8"?>
<appendix id="installation">
<appendixinfo>
  <authorgroup>
    <author
>&Jack.H.Ostroff; &Jack.H.Ostroff.mail;</author>
  </authorgroup>
  <date
>2014-08-30</date>
  <releaseinfo
>4.7.01</releaseinfo>
</appendixinfo>

<title
>Paigaldamine</title>

<para
>Käesolev lisa puudutab peamiselt &kappname; paigaldamist &Linux; operatsioonisüsteemis. <link linkend="installation.nonlinux"
>Viimane osa</link
> puudutab ka teisi operatsioonisüsteeme. </para>

<sect1 id="installation.getting">
<title
>&kappname; hankimine</title>

<para
>&kappname; on arenduses olnud juba aastaid ja me oleme kõvasti vaeva näinud täieliku lõimimisega &kde; koosseisu. Varaseim stabiilne versioon (1.0.x) nõudis &kde; 3 teeke ega olnud seepärast saadaval paljudes Linuxi distributsioonides, mis olid juba üle läinud &kde; 4 peale. Kuid alates 2010. aasta augustis ilmunud versioonist 4.5 on ka &kappname; hõlpsasti kompileeritav ja paigaldatav kõigil &kde; versioonidel 4.3 või uuematel. Praegune 4.7 versioon juba nõuab &kde; 4.6, täpsemalt kdelibs'i ja kdepimlibs'i. </para>

<para
>Kuigi oleme alustanud &kappname; portimist uue KDE Frameworks 5 peale, on see alles algusjärgus ja rakendus pole veel sellisena kasutatav. Loodetavasti oleme sellega valmis versiooniks 5.0, mis on kavas välja lasta 2015. aasta algul. Seni aga, kui tunnete tõsisemat huvi meie sellesuunalise töö vastu, soovitame tellida endale arendajate postiloendi &devlist;. </para>

<para
>Edasi kirjeldame &kappname; paigaldamist sinu Linuxi distributsiooni tavapärase tarkvara paigaldamise protseduuriga. Järgmine osa käsitleb kompileerimist lähtekoodist. </para>

<sect2 id="installation.distribution">
<title
>Distributsioonide ametlikud paketid</title>
<para
>Parim viis &kappname; paigaldada on kasutada oma distributsiooni tarkvarahaldurit, näiteks apt-get, yum, portage või pacman. Sel juhul hoolitsetakse kõigi vajalike sõltuvuste ja teekide eest. Ehkki distributsioonidel kulub pärast &kappname; uue versiooni ilmumist natuke aega, enne kui see jõuab nende ametlikesse hoidlatesse, kasuta palun kõigepealt just seda võimalust. </para>
</sect2>

<sect2 id="installation.unsupported">
<title
>Toetamata hoidlad</title>
<para
>Paljudel Linuxi distributsioonidel leidub kasutajaid, kes pakuvad omalt poolt toetamata hoidlaid, milles leidub uuemat tarkvara kui distributsiooni ametlikus hoidlas. Nende loetelu leiab <ulink url="http://www.kmymoney.org"
>&kappname; koduleheküljel</ulink
>. </para>
</sect2>
</sect1>

<sect1 id="installation.fromsource">
<title
>&kappname; kompileerimine lähtekoodist</title>

<para
>Uusimat teavet viimase saadaoleva versiooni ja kõigi teadaolevate paigaldamisprobleemide kohta leiab <ulink url="http://www.kmymoney.org"
>&kappname; koduleheküljel</ulink
>. Samas leiab ka lingid uusimate versioonide pakitud failidele ning juhised, kuidas hankida lähtekood &kde; Gitist, kui soovid ise kompileerida uusima arendusversiooni. </para>

<para
>Nagu võis mõista eelmisest lõigust, on &kappname; kompileerimisel lähtekoodist kaks erinevat põhjust. Kui sa ei leia just sinu distributsioonile pakendatud versiooni, laadi alla uusima stabiilse väljalaske pakitud fail. Käsiraamatu kirjutamise ajal oli selleks versioon 4.6.0. See on tavalistele kasutajatele soovitatav kompileerimisvõimalus. </para>

<para
>Kui aga soovid hoida kätt arendustegevuse pulsil, proovida järele uusimaid veaparandusi või omadusi, võib ka laadida alla pakitud faili, mis kujutab endast hetkvõtet arendushoidlast. Samuti võib lähtekoodi otse hoidlast välja võtta. Versiooni 4.x lähtekood asub &kde; Gitis. (Versiooni 1.0.x lähtekood asus SourceForge'i CVS-is, aga seda enam ei arendata ega isegi toetata.) Kuidas sinna ligi pääseda, saab teada projekti koduleheküljel. </para>

<warning>
 <para
>Kood Giti hoidlas ja arendus-hetkvõtted on aktiivses arendamises: neis võib esineda vigu, neid võivad tabada krahhid ning nad võivad andmeid segi ajada või lausa ära kaotada. Nende kasutamisel tuleb kindlasti teha vajalikud varukoopiad. Kui sul ei ole just kindlat põhjust kasutada arendusversiooni, tasuks püsida stabiilse välja lastud versiooni juures. </para>
</warning>

<sect2
><title
>Nõutavad teegid</title>
<para
>&kappname; sõltub teatavatest teekidest, mis lubavad seda korralikult kompileerida ja käitada. Esimene nõue on KDE versioon 4.3.5 või uuem, eriti kdelibs ja kdepimlibs. Sõltuvalt distributsioonist võib olla vaja &kappname; kompileerimiseks otseselt laadida <quote
>-devel</quote
> versioonid, mitte lihtsalt käivitada eelnevalt kompileeritud versioon. Alates versioonist 4.6.0 sõltub &kappname; ka libalkimia versioonist 4.3.1 või uuem. Lisanõuded saab tuvastada allpool sammu <quote
>cmake</quote
> ajal. </para>

<para
>Lisaomadusi võimaldavad kasutada kompileerimisajal saada olevad lisateegid. Kaks levinumat on </para>

<itemizedlist>
<listitem>
  <para
>libofx versiooniga 0.9.4 või uuem, mis võimaldab importida OFX-vormingus finantsandmeid, ja</para>
</listitem>

<listitem>
  <para
>AqBanking versiooniga 5.0.0 või uuem, mis võimaldab kasutada teatavaid internetipanganduse võimalusi. Pane tähele, et varasemate versioonide vigade tõttu on tungivalt soovitatav kasutada versiooni 5.0.14 või uuem.</para>
</listitem>
</itemizedlist>
</sect2>

<sect2
><title
>Ehitamisjuhised</title>
<para
>&kappname; kasutab cmake'i ehitamissüsteemi. Täpsemat teavet annab lähtekoodi juurkataloogis leiduv fail README.cmake. Põhisammud on järgmised: </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
>Pane tähele, et viimane samm on nõutav. &kappname; eeldab leida teatavad komponendid standardses asukohas ja kui käivitad selle ehitamiskataloogist ilma paigaldamissammuta, võivad ikoonid olla kadunud või esineda muid üllatusi. </para
></important>

<para
>Kui oled kompileerinud lähtekoodi Gitist ja soovid uuendada uusimale versioonile, tuleb enamasti teha vaid järgmist: </para>

<simplelist>
<member
><command
>$ cd &lt;lähtekoodi juurkataloogi asukoht&gt;</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
>Kuid arendajate tehtud muudatused tekitavad mõnikord kompileerimisprobleeme, kui sa ei alusta puhta koodibaasiga. Sellisel juhul tuleb teha järgmist: </para>

<simplelist>
<member
><command
>$ cd &lt;lähtekoodi juurkataloogi asukoht&gt;</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
>&kappname; paigaldamine ilma Linuxita</title>

<para
>&kappname; on edukalt kompileeritud &MacOS; X tarbeks ja on saadaval <ulink url="http://www.macports.com"
>veebieleheküljel MacPorts</ulink
>. </para>
<para
>&kappname; on saadaval ka &Windows; jaoks. See algatus on ikka veel arengujärgus, aga viimasel aastal on selles vallas saavutatud suurt edu. Täpsemat teavet &kde;, sealhulgas &kappname; käitamise kohta &Windows; keskkonnas leiab veebilehelt <ulink url="http://windows.kde.org"
>KDE on Windows</ulink
>. Autonoomse installeri, mis paigaldab ainult &kappname;, leiab <ulink url="http://www.kmymoney.org"
>&kappname; koduleheküljel</ulink
> paikneva allalaadimislingi alt. Pane tähele, et installeri uusim versioon ei tööta enam &Windows; XP keskkonnas. Väljalaske ajal ei olnud teada, kas seda õnnestub muuta, sest probleem on seotud rakenduse ehitamiseks vajalike tööriistade, mitte rakenduse endaga. </para>

<para
>Kui tead, et &kappname; on edukalt kompileeritud ja saadaval muudelegi operatsioonisüsteemidele, anna ka meile teada, et me saaksime sellest laiemalt teada anda. </para>

</sect1>
</appendix>
