<?xml version="1.0" encoding="UTF-8"?>
<appendix id="installation">
<appendixinfo>
  <authorgroup>
    <author
>&Jack.H.Ostroff; &Jack.H.Ostroff.mail;</author>
  </authorgroup>
  <date
>30 серпня 2014 року</date>
  <releaseinfo
>4.7.01</releaseinfo>
</appendixinfo>

<title
>Встановлення</title>

<para
>У цьому додатку наведено основні відомості щодо встановлення &kappname; у операційній системі &Linux;. <link linkend="installation.nonlinux"
>Останній розділ додатка</link
> присвячено іншим операційним системам. </para>

<sect1 id="installation.getting">
<title
>Як отримати &kappname;?</title>

<para
>Розробка &kappname; ведеться вже протягом декількох років, розробники приділяють дуже велику увагу повній інтеграції програми до решти комплексу програм &kde;. Для роботи попередніх стабільних версій (1.0.x) потрібні були бібліотеки з &kde; 3, тому ними було важко користуватися у новітніх дистрибутивах Linux, у яких було здійснено перехід до &kde; 4. З випуском версії 4.5 у серпні 2010 року, &kappname; можна без проблем зібрати і встановити у будь-якій з версій &kde;, новіших за версію 4.3. Для роботи поточної версії, 4.7, потрібне &kde; 4.6, зокрема бібліотеки модулів kdelibs і kdepimlibs. </para>

<para
>Хоча роботу з портування &kappname; на нові бібліотеки KDE Frameworks 5 вже розпочато, вона все ще перебуває на дуже ранній стадії, тому ще не придатна до користування. Сподіаємося, що результатами портування можна буде скористатися у версії 5.0, яку планується випустити у першій половині 2015 року. До цього часу, якщо ви хочете стежити за ходом робіт, вам слід підписатися на список листування розробників, &devlist;. </para>

<para
>Решту цього розділу присвячено опису встановлення &kappname; за допомогою стандартних процедур встановлення програмного забезпечення у вашому дистрибутиві Linux. У наступному розділі наведено настанови щодо встановлення з початкових кодів. </para>

<sect2 id="installation.distribution">
<title
>Офіційні пакунки дистрибутивів</title>
<para
>Найкращим способом встановлення &kappname; є використання програми для керування пакунками вашого дистрибутива, зокрема apt-get, yum, portage, urpmi або pacman. Така програма подбає про задоволення залежностей та встановлення потрібних бібліотек. Хоча для додавання найновіших версій &kappname; до офіційних сховищ всіх дистрибутивів потрібен певний час, будь ласка, спробуйте спочатку знайти цю найновішу версію у офіційному сховищі. </para>
</sect2>

<sect2 id="installation.unsupported">
<title
>Непідтримувані сховища</title>
<para
>У більшості дистрибутивів Linux деякі з користувачів підтримують неофіційні сховища з пакунками програмного забезпечення найновіших версій, яких ще немає у офіційних сховищах дистрибутива. Список таких сховищ можна знайти на <ulink url="http://www.kmymoney.org"
>домашній сторінці &kappname;</ulink
>. </para>
</sect2>
</sect1>

<sect1 id="installation.fromsource">
<title
>Збирання &kappname; з початкових кодів</title>

<para
>Свіжіші відомості щодо найсучаснішої версії програми та проблем, які можуть виникнути під час її встановлення, можна знайти на <ulink url="http://www.kmymoney.org"
>домашній сторінці &kappname;</ulink
>. На цій сторінці також наведено посилання на файли архівів з кодами програми та настанови щодо отримання кодів з Git &kde;, якщо ви хочете зібрати версію, над якою зараз працюють розробники. </para>

<para
>Як ми вже згадували вище, існує дві основні причини збирання &kappname; з початкових кодів. Якщо вам не вдається знайти версію, спеціально зібрану для вашого дистрибутива, будь ласка, отримайте файл архіву з найсвіжішою стабільною версією програми. На час написання цього підручника такою версією була версія 4.6.0. Саме отриманим файлом цієї версії ми і рекомендуємо скористатися звичайним користувачам. </para>

<para
>З іншого боку, якщо ви бажаєте тримати руку на пульсі поточної розробки, перевірити виправлення вади або нову можливість, ви можете отримати файл архіву зі знімком версії програми зі сховища розробників програми. Ви також можете отримати коди безпосередньо зі сховища. Коди версії 4.x можна знайти у Git &kde; (коди версії 1.0.x — у CVS SourceForge, вже не розробляється та не підтримується). Настанови щодо доступу до сховищ наведено на домашній сторінці програми. </para>

<warning>
 <para
>Розробку коду у сховищі Git та файлах знімків сховищ не можна вважати завершеною: у зібраної версії можуть бути вади, програма може пошкодити дані або призвести до їх втрати. Якщо ви користуєтеся такою версією програми, не забувайте про створення резервних копій. Не використовуйте нестабільних версій, якщо у вас немає для цього вагомих причин. </para>
</warning>

<sect2
><title
>Необхідні бібліотеки</title>
<para
>Збирання та роботу &kappname; забезпечують певні бібліотеки. По-перше, слід встановити &kde; версії 4.3.5 або новішої, зокрема бібліотеки kdelibs і kdepimlibs. Для збирання у певних дистрибутивах вам знадобляться пакунки з суфіксом <quote
>-devel</quote
>, для встановлення попередньо зібраної програми такі бібліотеки не потрібні. Версія 4.6.0 &kappname; залежить від бібліотеки libalkimia, версії 4.3.1 або новішої. Додаткові вимоги для збирання може бути визначено під час запуску програми «cmake». </para>

<para
>Додаткові функціональні можливості стануть доступними, лише якщо на час збирання було встановлено відповідні бібліотеки. Найважливішими є такі дві бібліотеки: </para>

<itemizedlist>
<listitem>
  <para
>libofx, версії 0.9.4 або пізнішої, щоб мати змогу імпортувати фінансові дані у форматі OFX, і</para>
</listitem>

<listitem>
  <para
>AqBanking, версії 5.0.0 або пізнішої, щоб мати змогу скористатися певними можливостями роботи з банком за допомогою інтернету. Зауважте, що рекомендується встановити версію 5.0.14 або пізнішу через вади у попередніх версіях.</para>
</listitem>
</itemizedlist>
</sect2>

<sect2
><title
>Настанови щодо збирання</title>
<para
>У &kappname; використано систему збирання cmake. Докладні настанови наведено у файлі README.cmake, що зберігається у кореневій теці кодів програми. Ось перелік основних команд: </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
>$ su -c "make install/fast"</command
></member>
</simplelist>

<important
><para
>Зауважте, що останній крок є обов’язковим. Для роботи &kappname; потрібно встановити компоненти програми у строго визначених місцях. Якщо ви запустите програму з каталогу build без встановлення, у вікні програми не буде показано піктограм, можливі інші несподіванки. </para
></important>

<para
>Якщо ви вже збирали код з git, і тепер бажаєте оновити його до найсвіжішого випуску, вам слід виконати такі дії: </para>

<simplelist>
<member
><command
>$ cd &lt;шлях до кореневої теки кодів&gt;</command
></member>
<member
><command
>$ git pull --rebase</command
></member>
<member
><command
>$ cd build</command
></member>
<member
><command
>$ make</command
></member>
<member
><command
>$ su -c "make install/fast"</command
></member>
</simplelist>

<para
>Іноді зміни, внесені розробниками, можуть призвести до проблем зі збиранням, якщо ви не почнете збирання коду з початку. Якщо у вас виникають подібні проблеми, вам слід зробити так: </para>

<simplelist>
<member
><command
>$ cd &lt;шлях до кореневої теки кодів&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
>$ su -c "make install/fast"</command
></member>
</simplelist>
</sect2>
</sect1>

<sect1 id="installation.nonlinux">
<title
>Встановлення &kappname; поза межами Linux</title>

<para
>&kappname; можна успішно зібрати для &MacOS; X. Відповідний пакунок зберігається на <ulink url="http://www.macports.com"
>вебсайті MacPorts</ulink
>. </para>
<para
>&kappname; можна користуватися у &Windows;. Робота над повноцінним портуванням усе ще триває, але протягом останнього року було досягнуто значних успіхів. Щоб дізнатися більше про те, як запустити програми &kde;, зокрема &kappname;, у &Windows;, відвідайте <ulink url="http://windows.kde.org"
>сторінку ініціативи KDE у Windows</ulink
>. Посилання на окремий пакунок для встановлення лише &kappname; наведено у правій частині <ulink url="http://www.kmymoney.org"
>домашньої сторінки &kappname;</ulink
>. Зауважте, що найсвіжіша версія цього пакунка не працює у &Windows; XP. На час поточного випуску невідомо, чи можна розв’язати цю проблему, оскільки її пов’язано із набором інструментів, використаним для збирання програми, а не з самою програмою. </para>

<para
>Якщо вам відомо, що &kappname; можна успішно зібрати і використовувати у інших операційних системах, повідомте про це авторам програми, щоб інші користувачі отримали цю важливу для них інформацію. </para>

</sect1>
</appendix>
