|
|
|
[[_TOC_]]
|
|
|
|
|
|
|
|
The below is likely outdated and needs to be rewritten/incorporated into the up-to-date instructions above
|
|
|
|
|
|
|
|
## OFX plugin build details
|
|
|
|
|
|
|
|
KMyMoney README.ofx \
|
|
|
|
Author: Ace Jones [acejones@users.sf.net](mailto:acejones@users.sf.net) \
|
|
|
|
Thomas Baumgart [ipwizard@users.sf.net](mailto:ipwizard@users.sf.net) \
|
|
|
|
Date : Jan 19 2006 \
|
|
|
|
Last update: Oct 20 2010
|
|
|
|
|
|
|
|
This README covers how to compile with OFX support.
|
|
|
|
|
|
|
|
Building the OFX Plugin allows you to import OFX files from your bank. For more information on using the feature, see the "OFX Import" section of the user manual. It also supports the OFX Direct Connect feature which enables but not all. For information on how to set up your accounts and connect to your bank, please see the "Direct Connect" section in the "OFX Import" section of the user's manual.
|
|
|
|
|
|
|
|
To build it:
|
|
|
|
|
|
|
|
1. Get the required version of libofx. For KMyMoney >= 4.5, get at least version 0.9.1 of libofx and make sure you have the patch to correct a daylight savings time problem installed. The patch can be found at <http://sourceforge.net/tracker/download.php?group_id=61170&atid=496353&file_id=345261&aid=2872464>
|
|
|
|
|
|
|
|
Please ensure you have at least this version or a CVS based version before requesting support for any problem building with OFX.
|
|
|
|
|
|
|
|
1. Ensure you have pkg-config installed, and that your PKG_CONFIG_PATH includes the location of libofx.pc.
|
|
|
|
2. The KMyMoney cmake build script will automatically build the OFX plugin if it finds the necessary header files. You can enable or disable manually by running
|
|
|
|
|
|
|
|
```plaintext
|
|
|
|
ccmake <rel-path-to-kmm-sources>
|
|
|
|
```
|
|
|
|
|
|
|
|
Then, change the value of ENABLE_LIBOFX and run the configure script again. You will see this if it was succesful if the output of your cmake run contains the following lines:
|
|
|
|
|
|
|
|
```plaintext
|
|
|
|
-- checking for module 'libofx'
|
|
|
|
-- found libofx, version 0.9.1
|
|
|
|
-- Found LibOfx: /usr/local/lib64/libofx.so
|
|
|
|
|
|
|
|
:
|
|
|
|
:
|
|
|
|
|
|
|
|
Configure results (user options):
|
|
|
|
--------------------------------------------
|
|
|
|
OFX plugin: yes
|
|
|
|
```
|
|
|
|
|
|
|
|
In case the first block is not part of the output and the second part contains no, please remove the file CMakeCache.txt in your build directory and run cmake again.
|
|
|
|
|
|
|
|
Make sure to install the software using "sudo make install" after it has been built. If the plugin is not installed in the KDE directory hierarchy it will not be available while KMyMoney is running.
|
|
|
|
|
|
|
|
## Building and Installation
|
|
|
|
|
|
|
|
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://invent.kde.org/office/kmymoney**](git://invent.kde.org/office/kmymoney).
|
|
|
|
|
|
|
|
`git clone git://invent.kde.org/office/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:
|
|
|
|
|
|
|
|
```shell
|
|
|
|
mkdir build
|
|
|
|
cd build
|
|
|
|
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/ # optional, to adjust build configuration
|
|
|
|
ccmake .
|
|
|
|
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 separate build directory is mandatory (out of source build). The _install_ 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.
|
|
|
|
|
|
|
|
## Link to Debian bugs
|
|
|
|
|
|
|
|
The bugs in Debian tracker can be linked back to <http://build.kde.org>
|
|
|
|
|
|
|
|
* 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.
|
|
|
|
|
|
|
|
## 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-kf5/<country_code>/messages/extragear-office/>, replacing <country_code> with the correct one for your locale e.g. es would give <http://websvn.kde.org/trunk/l10n-kf5/es/messages/extragear-office/>. Once done, 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.
|
|
|
|
|
|
|
|
## Reporting bugs
|
|
|
|
|
|
|
|
### 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**
|
|
|
|
|
|
|
|
## Other
|
|
|
|
|
|
|
|
### Windows specific configuration options
|
|
|
|
|
|
|
|
##### KDE provided file dialogs for example for importer
|
|
|
|
|
|
|
|
add to share/config/kdeglobals
|
|
|
|
|
|
|
|
```plaintext
|
|
|
|
[KFileDialog Settings]
|
|
|
|
Native=false
|
|
|
|
```
|
|
|
|
|
|
|
|
##### Enable debug log level for online banking plugin
|
|
|
|
|
|
|
|
Open a command shell in kmymoney 'bin' dir and run
|
|
|
|
|
|
|
|
```plaintext
|
|
|
|
set AQBANKING_LEVEL=debug
|
|
|
|
set GWEN_LOGLEVEL=debug
|
|
|
|
```
|
|
|
|
|
|
|
|
Then start kmymoney with `kmymoney`
|
|
|
|
|
|
|
|
##### Enable verbose log level for online banking plugin
|
|
|
|
|
|
|
|
Open a command shell in kmymoney 'bin' dir and run
|
|
|
|
|
|
|
|
```plaintext
|
|
|
|
set AQBANKING_LEVEL=verbous
|
|
|
|
set GWEN_LOGLEVEL=verbous
|
|
|
|
```
|
|
|
|
|
|
|
|
Then start kmymoney with `kmymoney`
|
|
|
|
|
|
|
|
##### Show aqbanking log file path
|
|
|
|
|
|
|
|
1. Start kmymoney
|
|
|
|
2. Open Settings->configure KMymoney
|
|
|
|
3. In the Main tab select "Support" -> on that page there is a link to the current aqbanking lo path |