|
|
| (18 intermediate revisions by 5 users not shown) |
| Line 1: |
Line 1: |
| This page is dedicated to technical aspects of KMyMoney for KDE Platform 4. If you are looking for other info, or the source tarball, go to the official page of [http://kmymoney.org KMyMoney]. | | This documentation has been moved to GitLab wiki: https://invent.kde.org/office/kmymoney/-/wikis/home |
| | |
| [[Image:kmm_4_splash.png]]
| |
| | |
| == Available versions ==
| |
| === Latest release ===
| |
| | |
| [http://download.kde.org/stable/kmymoney/4.7.1/src/kmymoney-4.7.1.tar.xz.mirrorlist KMyMoney 4.7.1] has been released on 1st of November 2014.
| |
| Alternatively, you can get the source from the [https://projects.kde.org/projects/extragear/office/kmymoney KDE Git]. (see link below)
| |
| | |
| === Obsolete releases ===
| |
| [http://download.kde.org/stable/kmymoney/4.7.0/src/kmymoney-4.7.0.tar.xz.mirrorlist KMyMoney 4.7.0] has been released on 1st of October 2014.
| |
| | |
| [http://download.kde.org/stable/kmymoney/4.6.6/src/kmymoney-4.6.6.tar.xz.mirrorlist KMyMoney 4.6.6] has been released
| |
| on 24th of June 2014.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.4/kmymoney-4.6.4.tar.bz2/download KMyMoney 4.6.4] has been released on 6th of October 2013.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.3/kmymoney-4.6.3.tar.bz2/download KMyMoney 4.6.3] has been released on September 3rd 2012.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.2/kmymoney-4.6.2.tar.bz2/download KMyMoney 4.6.2] has been released on February 4th 2012.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.1/kmymoney-4.6.1.tar.bz2/download KMyMoney 4.6.1] has been released on November 6th 2011.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.0/kmymoney-4.6.0.tar.bz2/download KMyMoney 4.6.0] has been released on August 8th 2011.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.5.3/kmymoney-4.5.3.tar.bz2/download KMyMoney 4.5.3] has been released on February 13rd 2011.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.5.2/kmymoney-4.5.2.tar.bz2/download KMyMoney 4.5.2] has been released on December 23rd 2010.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.5.1/kmymoney-4.5.1.tar.bz2/download KMyMoney 4.5.1] has been released on November 14th 2010.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.5/kmymoney-4.5.tar.bz2/download KMyMoney 4.5] has been released on August 16th 2010.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.98/kmymoney-3.98.1.tar.bz2/download KMyMoney 3.98.1] has been released on May 21st 2010.
| |
| | |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.98.0/kmymoney-3.98.0.tar.bz2/download KMyMoney 3.98.0] has been released on May 15th 2010.
| |
| | |
| [http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.97.2/kmymoney-3.97.2.tar.bz2/download KMyMoney 3.97.2] has been released on Apr 6th 2010.
| |
| | |
| [https://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.96.1/kmymoney-3.96.1.tar.bz2/download KMyMoney 3.96.1] has been released on Feb 17th 2010.
| |
| | |
| == Installation ==
| |
| | |
| === Requirements ===
| |
| | |
| KMyMoney depends on KDE SC 4.7+. Specifically on kdelibs, kde PIM libs, and kactivities.
| |
| | |
| *g++
| |
| *make
| |
| *cmake
| |
| *libkdepimlibs-devel
| |
| *libgpgme-dev
| |
| *libical-dev
| |
| *libkactivities-dev
| |
| *libgmp-dev
| |
| *libalkimia-dev
| |
| | |
| ==== Optional ====
| |
| Additionally, you may want to install other libraries that will provide additional functionality:
| |
| | |
| *libofx >= 0.9.2
| |
| *Aqbanking >= 5.0.0
| |
| *quote::finance (also known as libfinance-quote-perl)
| |
| | |
| === Installation steps ===
| |
| | |
| If possible, it is always preferred to use a package specifically prepared for your distribution. However, if one is not available, or you want a more recent version, you can use the latest tarball. If you really need the most recent version, such as to test a new bug fix, get the source from [https://projects.kde.org/projects/extragear/office/kmymoney KDE Git] at
| |
|
| |
| * '''git://anongit.kde.org/kmymoney'''.
| |
| | |
| $ git clone git://anongit.kde.org/kmymoney
| |
| | |
| To install, read the README.cmake file in the root folder of the source. The basic steps are the following:
| |
| | |
| First, make sure you have uninstalled any old versions of kmymoney through your package manager and/or '''sudo make uninstall''' depending on how it was installed last time. Then:
| |
| | |
| $ mkdir build
| |
| $ cd build
| |
| $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/
| |
| # optional, to adjust build configuration
| |
| $ ccmake .
| |
| $ make && make
| |
| $ sudo make install
| |
| | |
| It is important that the prefix is the same one that is used by your already installed KDE software. If it does not match, you will run into problems later.
| |
| '''(The last step should be executed with admin privileges. Either switch to root or use sudo, or the appropriate steps for your installation)'''
| |
| | |
| To execute, either look for KMyMoney on the Office menu, or type kmymoney in a console window.
| |
| | |
| === Localization ===
| |
| '''If you are installing from Git source, you need to install your locale files by hand. If you are installing from the tarball provided above, please skip this section.'''
| |
| | |
| To localize you will need to download the appropriate kmymoney.po file from http://websvn.kde.org/trunk/l10n-kde4/<country_code>/messages/extragear-office/ (replace <country_code> with the correct one for your locale e.g. es would give http://websvn.kde.org/trunk/l10n-kde4/es/messages/extragear-office/) and then, either by switching to root or using sudo, do the following:
| |
| | |
| *Copy the kmymoney.po file into /usr/share/locale/<country_code>/
| |
| *In that folder run:
| |
| | |
| $ msgfmt kmymoney.po -o LC_MESSAGES/kmymoney.mo
| |
| | |
| Note: use the msgfmt that comes with your distribution not the one needed for kmymoney2.
| |
| | |
| === Debian dependencies ===
| |
| | |
| build-essential
| |
| cmake
| |
| kdelibs5-dev
| |
| kdepimlibs5-dev
| |
| libaqbanking29-dev
| |
| libboost-graph-dev
| |
| libfinance-quote-perl
| |
| libgpgme11-dev
| |
| libgwenhywfar47-dev
| |
| libical-dev
| |
| libjpeg62-dev
| |
| libofx-dev
| |
| libpng12-dev
| |
| libsqlite3-dev
| |
| libz-dev
| |
| gettext
| |
| | |
| == Guidelines ==
| |
| | |
| This version is only suitable for early adopters. It will behave fairly well, but the application might crash and you may lose some data. Make backups often.
| |
| | |
| For 3.95 version and later, we use the Bugzilla tracker at bugs.kde.org (BKO). Any bugs you find, please report it and assign to product kmymoney . Also, if you need help write to [email protected]. | |
| | |
| === Link to Debian bugs ===
| |
| The bugs in Debian tracker can be linked back to BKO
| |
| | |
| * Open a bug report in KDE Bug Tracking System (BTS)
| |
| * Link it to Debian bug number using "forwarded". See http://www.debian.org/Bugs/server-control#forwarded
| |
| * When the bug is fixed in KDE BTS, the status will be synced in Debian BTS too.
| |
| | |
| === Obtain a useful backtrace on Windows ===
| |
| If you would like to create a bug report about an application crash on Windows you need to take care of the following to create a useful report:
| |
| | |
| * make sure that you can reproduce the crash
| |
| * download the debug information that matches your version ([http://downloads.sourceforge.net/project/kmymoney2/KMyMoney-Windows/4.6.3/kmymoney-4.6.3-debug-info.7z 4.6.3])
| |
| * extract the archive in a folder of your choice (in this example '''c:\temp\kmm-debug-info''') using 7z archiver
| |
| * open '''cmd.exe'''
| |
| * run '''set _NT_SYMBOL_PATH=c:\temp\kmm-debug-info'''
| |
| * run '''"c:\Program Files\KMyMoney\bin\kdeinit4.exe" --terminate'''
| |
| * run '''"c:\Program Files\KMyMoney\bin\kmymoney.exe"'''
| |
| * try to reproduce the crash and use '''DrKonqi''' the KDE crash handler that appears when the application crashes (only on Windows 7) to report the crash on bugs.kde.org
| |
| '''Notes''':
| |
| * '''DrKonqi''' will inform you if the crash report is useful or not (it contains the debug information or not)
| |
| * if '''DrKonqi''' says that the report is not useful something went wrong in the above steps
| |
| * if you can't reproduce the crash immediately you can run KMyMoney for a while in an environment in which '''_NT_SYMBOL_PATH''' is defined as above (you can use a batch file for that)
| |
| * when you no longer need the debug information you can safely delete the folder '''c:\temp\kmm-debug-info'''
| |
| | |
| == Schedule for future releases ==
| |
| Development is active on trunk towards the next version, but neither the [http://community.kde.org/KMyMoney/Features/Plan46 feature set] nor the release plan have been completed and signed off yet. There is also a [http://community.kde.org/KMyMoney/Features/Future wishlist] of features which might be integrated in future releases.
| |
| | |
| === Version 4.7.2 ===
| |
| * <s>Release on 21.12.2014</s> when [https://bugs.kde.org/buglist.cgi?bug_status=RESOLVED&f1=cf_versionfixedin&list_id=1173129&o1=equals&product=kmymoney4&query_format=advanced&resolution=FIXED&v1=4.7.2 there will be at least 10 fixes to release]
| |
| | |
| === Version 4.8.0 ===
| |
| * Release in the beginning of 2015
| |
| | |
| === Version 5.0 ===
| |
| * Release in the first half of 2015
| |
