GnuCash 3.x kompilieren (Debian)
Dieser Artikel beschreibt, wie GnuCash 3.x aus den Quellcodes gebaut werden kann..
Für GnuCash ab Version 3.0 bestehen neue Anforderungen an das Build-System. Dadurch verändert sich auch der Build-Prozess.
Voraussetzungen installieren
Build essentials
apt install build-essential gcc --version
Autotools
Prüfen, ob Autotools installiert sind:
autoconf --version
Wenn Autotools nicht installiert sind, dann installieren:
apt install autoconf # loads autoscan, autoconf and associated macros apt install automake apt install libtool apt install m4
Make und CMake Prüfen, ob make und cmake installiert sind:
make --version cmake --version
Wenn nicht installiert, dann installieren:
# apt install cmake
Google Test installieren
Google Test Version 1.8.0 wird benötigt. Installation under Debian:
# apt-get install googletest
Alternativ selbst bauen. Anleitung hier: https://wiki.gnucash.org/wiki/Google_Test
Google Test Umgebungsvariablen setzen
Es werden Umgebungsvariablen im Userkontext des Users, der den Build-Vorgang ausführt, benötigt:
$ export GMOCK_ROOT=/usr/src/googletest/googlemock $ export GTEST_ROOT=/usr/src/googletest/googletest
Abhängigkeiten (Dependencies) installieren
In Debian kann man Abhängigkeiten folgendermaßen installieren:
# apt-get build-dep gnucash
Dies klappt jedoch nur, wenn in der verwendeten Version der Distribution die gleiche Version von Gnucash vorliegt, wie die, die man bauen möchte. Falls dies nicht der Fall ist, kann es sein, dass man manche benötigen Pakete manuell beschaffen muss.
Benötigte Pakete sind beschrieben in README.dependencies oder hier: https://wiki.gnucash.org/wiki/Installing_Dependencies
Verzeichnisstruktur vorbereiten
Ab Version 3.x mit CMake können die gebaute Applikation und die Quellen nicht im gleichen Verzeichnis vorliegen.
Es empfehlen sich daher folgende drei Verzeichnisse:
| Inhalt | Beschreibung | Beispielpfad |
|---|---|---|
| Quellen | Quellcodedateien | ~/dev/gnucash-3.x |
| Build | Dateien für den Build-Vorgang
Hinweis: Notwendig für Deinstallation |
~/dev/gnucash-3.x-build |
| Installation | Ausführbare Dateien
entweder ins Systemverzeichnis /usr/local oder vom System getrennt in /opt oder lokal unter ~./local |
/usr/local oder
/opt oder ~/.local |
Hinweis: Eine Installation in /opt/gnucash-3.x scheint nicht zu funktionieren. Nach der Installation erscheint beim Aufruf von Gnucash die Fehlermeldung "Breakpoint ausgelöst".
Download
Bei obiger Verzeichnisstruktur z.B. nach ~/dev/
Quellcodedownload siehe https://www.gnucash.org/index.phtml
cd ~/dev wget <url> sha256sum gnucash-version.tar.bz2 # Check checksum against README-File from Download-Page tar -xjvf gnucash-version.tar.bz2 -C
Build-Daten aufbauen
Nicht vergessen: Google Test Umgebungsvariablen setzen
Nicht vergessen: Bestehende Installation vorhanden? Gnucash deinstallieren
cd ~/dev
mkdir gnucash-3.x-build # create build directory
cd gnucash-3.x-build # change into the build directory
cmake -DCMAKE_INSTALL_PREFIX=/usr/local ../gnucash-3.x
# This will install in the /usr/local directory.
make # builds the program and associated libraries
Hinweis: Build-Dateien für spätere Deinstallation aufheben.
Gnucash installieren
Installation muss mit Root-Rechten ausgeführt werden:
# cd ~/dev/gnucash-3.x-build # make install # to install to /usr/local or /opt admin privileges are required.
Gnucash deinstallieren
Deinstallation muss mit Root-Rechten ausgeführt werden:
# cd ~/dev/gnucash-3.x-build # make uninstall # to uninstall from /usr/local or /opt admin privileges are required.
Troubleshooting
Kursabfrage
Siehe GnuCash Online-Kursabfragen
Quellen
| Quelle | URL |
|---|---|
| Übersicht des Bau-Prozesses | https://wiki.gnucash.org/wiki/Building |
| Anleitung zum Bauen unter Linux | https://wiki.gnucash.org/wiki/Building_On_Linux |
| Übersicht Voraussetzungen / Build Tools | https://wiki.gnucash.org/wiki/Install_Build_Tools |
