Difference between revisions of "De/Flatpak"

From GnuCash
Jump to: navigation, search
(Tips: Wartung)
(Abstract: — auch parallel zu der ihrer Distribution —)
 
(55 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
| [[Flatpak|English]]
 
| [[Flatpak|English]]
 
|}
 
|}
'''[https://flatpak.org/ Flatpaks]''' sind Bündel, welche neben dem Programm auch alle erforderlichen Bibliotheken enthalten. Falls Ihre Linux-Distribution für erforderliche Bibliotheken zu alt ist, aber Flatpak-Unterstützung hat, können Sie damit dennoch eine ''aktuelle'' GnuCash-Version installieren.
+
'''[{{URL:FP}} Flatpaks]''' sind Bündel, welche neben dem Programm auch alle erforderlichen Bibliotheken enthalten. Falls Ihre Linux-Distribution für erforderliche Bibliotheken zu alt ist, aber Flatpak-Unterstützung hat, können Sie damit dennoch eine ''aktuelle'' GnuCash-Version — auch parallel zu der ihrer Distribution — installieren.
  
Das Programm läuft dabei in einer teilweise abgeschotteten Umgebung, kann also beispielsweise nur auf das Heimat-Verzeichnis des aufrufenden Benutzers schreibend zugreifen und in der Regel große Teile des Dateisystems nicht einmal lesen, welche zur Programmausführung nicht notwenig sind.
+
Das Programm läuft dabei in einer teilweise abgeschotteten Umgebung—<q>Sandkasten</q>—, kann also beispielsweise nur auf das Heimat-Verzeichnis des aufrufenden Benutzers schreibend zugreifen und in der Regel weite Teile des Dateisystems, welche zur Programmausführung nicht notwenig sind, nicht einmal lesen. Damit es keine Konflikte mit einer <q>normalen Installation</q> gibt, befinden sich die Anwendungsdaten für Konfiguration etc. in
 +
:<tt>$HOME/.var/app/org.gnucash.GnuCash/</tt> und
 +
:<tt>$HOME/.local/share/flatpak/app/org.gnucash.GnuCash/</tt>
  
 
=Bekannte Einschränkungen=
 
=Bekannte Einschränkungen=
* Wenn Sie Ihre '''Smart Card''' benutzen wollen, benötigen Sie mindestens [https://www.fosslinux.com/13357/new-flatpak-1-3-2-uses-custom-fuse-filesystem-installation-technique.htm Flatpak 1.3.2] auf Ihrem Computer. Beschweren Sie sich bei Ihrer Distribution, wenn sie es nicht anbietet.
+
* Wir haben darauf verzichtet, die [[Python Bindings]] zu bündeln,
*Kein '''Finance::Quote''' vor dem Bündel 3.8-2 (16/17.02.2020),
+
* kein '''direkter Druck''' von ''Berichten'', aber Ihr Druck in eine Datei und direkter Scheckdruck funktionieren.
*kein ''direkter Druck'' von Berichten (Drucken in eine Datei funktioniert) und
+
* Wenn Sie Ihre '''Smart Card''' beim Online-Banking benutzen wollen, benötigen Sie mindestens [https://www.fosslinux.com/13357/new-flatpak-1-3-2-uses-custom-fuse-filesystem-installation-technique.htm Flatpak 1.3.2] auf Ihrem Computer. Die weiteren Schritte sind in [[#Zugriff auf zusätzliche Resourcen]] beschriebenen.
*ein potenzieller Fehler, der ''Guile'' veranlaßt, alle scm-Quellen neu zu übersetzen. [https://github.com/flathub/org.gnucash.GnuCash/issues/24#issuecomment-523048429 Workaround (englisch)]
+
* Die [[Flatpak#Known Issues|englische Version dieser Seite]] hat noch einen Absatz zur Speicherung der GnuCash Präferenzen.
 +
* Ein nur in ''Ubuntu-Derivaten'' beobachteter Fehler, der ''Guile'' veranlaßt, alle scm-Quellen neu zu übersetzen: {{Flatpak_Guile_Error_Demo}}
 +
* Aktuelle Liste auf
 +
** [https://github.com/flathub/org.gnucash.GnuCash/issues/flathub/org.gnucash.GnuCash flathub/org.gnucash.GnuCash]
 +
**[{{BugURL}}/buglist.cgi?component=Flatpak&product=Packaging&resolution=--- Bugzilla]
  
 
=Installation=
 
=Installation=
==Flatpak selbst==
+
Viele Paketmanager wie <tt>Gnome Software</tt> oder KDE's <tt>Discover</tt> können so konfiguriert werden, daß sie zumindest Flatpaks von Flathub  installieren und aktualisieren können, aber auf dieser Seite verwenden wir das mächtigere <tt>flatpak</tt> Befehlszeilen-Werkzeug. Das Beispiel zur Installation von Flatpak selbst wurde für ''Debian'' —ab ''Buster'' ist ''Flatpak'' regulär, für ''Stretch''/''Jessie'' in den „Backports“ enthalten— und Derivate wie ''Ubuntu'' geschrieben.
https://flatpak.org/setup/ hat Anleitungen für verschiedene Distributionen.
+
;Tip: Für andere Distributionen ist also <tt>apt …</tt> durch das jeweilige Software-Installationswerkzeug zu ersetzten, z.B. für viele rpm-basierte <SyntaxHighlight lang="sh">
 +
zypper install flatpak
 +
</Syntaxhighlight> Flatpak selbst hat aber auch [https://flatpak.org/setup Anleitungen für verschiedene Distributionen].
  
 
==Serverübersicht==
 
==Serverübersicht==
 
* Die [[#Stabile_Version_von_Flathub.org]] entspricht offiziellen GnuCash-Versionen und eignet sich für Distributionen, die kein aktuelles GnuCash mitliefern, aber über ein genügend aktuelles FlatPak-Paket verfügen.
 
* Die [[#Stabile_Version_von_Flathub.org]] entspricht offiziellen GnuCash-Versionen und eignet sich für Distributionen, die kein aktuelles GnuCash mitliefern, aber über ein genügend aktuelles FlatPak-Paket verfügen.
 
* [[#Testversion_von_Gnucash.org]] sind aktuelle Schnappshüsse, um Flicken (Patches) zu testen. An anderer Stelle können aber neue Löcher aufgetreten sein.
 
* [[#Testversion_von_Gnucash.org]] sind aktuelle Schnappshüsse, um Flicken (Patches) zu testen. An anderer Stelle können aber neue Löcher aufgetreten sein.
 +
;Anmerkung zu den folgenden Beispielen: <tt>sudo</tt> muß nicht angegeben werden. <tt>flatpak</tt> ist smart genug, bei Bedarf einen entsprechenden Dialog vom verwendeten Desktop anzufordern wie z.B. bei KDE [[File:FP-Auhentication-KDE.png]]
  
==Beispiel-Einrichtung==
+
===Offizielle Versionen auf ''Flathub.org''===
Diese wurde unter ''Ubuntu'' oder ''Debian'' (ab ''Buster'' ist ''Flatpak'' regulär enthalten, für ''Stretch''/''Jessie'' in den „Backports“) ausgeführt. Für andere ist also <tt>apt ...</tt> durch das jeweilige Software-Installationswerkzeug zu ersetzten.
+
Auf Flathub steht neben der aktuellen ''stabilen'' —GnuCash {{Version}}— ''in der Testphase'' von einigen Monaten vor einer neuen Haupversion auch eine Vorschau als ''unstable'' (instabile) —GnuCash {{BetaSeries}}—  bereit. Die genauen Daten werden im [[Release Schedule]] angekündigt.
 +
* Beide Zweige können ''parallel installiert'' werden.
 +
;Siehe auch: [https://flathub.org/apps/details/org.gnucash.GnuCash Flathub]
 +
 
 +
;Hinweis zu PSD2: Die Version ''Gnucash 3.7'' enthielt noch ''Aqbanking 5.8.2'' und war damit für „''PSD2''“ '''ungeeignet''', Online-Banking per ''[[:Category:De/FinTS|FinTS]]''/''[[De/Online-Banking|HBCI oder chipTAN]]'' ging damit seit September 2019 nicht mehr. Seitdem enthielt jede Version der 3.x-Serie noch weitere Verbessserungen dazu.
 +
:Die ''aktuellen'' Versionen enthalten Aqbanking {{AqB_Version}}.
 +
:Das Team bittet daher darum, davon abzusehen, Probleme zu melden, welche längst gelöst wurden!
 +
;Stabile Version
 +
{{Install_Flatpak_sh}}
 +
;Tip: Am ''Ende jeden [[Release_Schedule#Schedules|Quartals]]'' erscheint eine neue Gnucash-Version. Um danach darauf zu aktualisieren,  <SyntaxHighlight lang="sh">
 +
flatpak update
 +
</Syntaxhighlight> aufrufen.
 +
 
 +
;Beta-Version ("unstable"): In den [[Release Schedule#Goals| letzten Monaten vor einer neuen Hauptversion]] erscheinen Vorschauen, genannt Beta-Version. In dieser Testphase erscheint mindestens am ''Ende jeden '''Monats''''' eine neue Gnucash-Beta-Version.
 +
Für die Beta-Version, führen Sie "im Prinzip" dieselben Schritte aus wie für die stabile, aber ''register'', ''install'' und ''run'' wie folgt: {{Install_Flatpak_Unstable_sh}}
 +
 
 +
===Tägliche Testversionen —<q>Nightlies</q>— auf ''gnucash.org''===
 +
Gewöhnlich gibt es Schnappschüsse der aktuellen Programmentwicklung auf dem [{{BuildURL}}/builds/flatpak/ Build-Server].
 +
:Die ''aktuellen'' Versionen enthalten Aqbanking {{AqB_Version_nightly_FP}}.
  
===Testversion von ''Gnucash.org''===
 
Bisweilen gibt es Testversionen der aktuellen Programmentwicklung auf dem [{{BuildURL}}/builds/flatpak/ Build-Server].
 
 
;Warnung: Vor Gebrauch von Testversionen unbedingt '''Daten sichern!'''
 
;Warnung: Vor Gebrauch von Testversionen unbedingt '''Daten sichern!'''
 
Die aktuelle Version enthält Aqbanking 6.0.2 (für „''PSD2''“ geeignet, wird für Online-Banking mit ''[[:Category:De/FinTS|FinTS]]''/''[[De/HBCI|HBCI]]'' gebraucht; Stand: 16.02.2020).
 
  
 
Zu finden sind die aktuellen Versionen hier (das sind nicht die eigentlichen Programmpakete, sondern Referenzdateien, die ''Flatpak' sagen, was heruntergeladen werden soll):
 
Zu finden sind die aktuellen Versionen hier (das sind nicht die eigentlichen Programmpakete, sondern Referenzdateien, die ''Flatpak' sagen, was heruntergeladen werden soll):
:Testversion {{Version}} mit ''aktuellen'' Fehlerbehebungen, aber ohne neue Programmeigenschaften ('''aus Stabilitätsgründen zu bevorzugen'''): [{{BuildURL}}/builds/flatpak/maint/?C=M;O=D {{BuildServer}}/builds/flatpak/maint/]
+
:;Stable: Testversion {{Version}} mit ''aktuellen'' Fehlerbehebungen, aber ohne neue Programmeigenschaften ('''aus Stabilitätsgründen zu bevorzugen'''):
:Testversion {{Version}} mit ''verzögerten'' Fehlerbehebungen, aber neuen Programmeigenschaften: [{{BuildURL}}/builds/flatpak/master/?C=M;O=D {{BuildServer}}/builds/flatpak/master/]
+
::[{{URL:Build:FP}} {{URL:Build:FP}}]
 +
:;Future: Erst verfügbar, wenn das erste Feature aus [[Release Schedule#Goals for 6.0]] implementiert ist!
 +
::Testversion {{BetaVersion}} mit ''verzögerten'' Fehlerbehebungen, aber neuen Programmeigenschaften: [{{URL:Build:FP|future}} {{URL:Build:FP|future}}]
 
Die Dateinamen aus diesen Verzeichnissen können im Beispiel unten verkürzt eingesetzt werden: vorne „<tt>gnucash-</tt>“ und hinten „<tt>.flatpakref</tt>“ weglassen.
 
Die Dateinamen aus diesen Verzeichnissen können im Beispiel unten verkürzt eingesetzt werden: vorne „<tt>gnucash-</tt>“ und hinten „<tt>.flatpakref</tt>“ weglassen.
 
<SyntaxHighlight lang="sh">
 
<SyntaxHighlight lang="sh">
Line 49: Line 74:
 
</Syntaxhighlight>
 
</Syntaxhighlight>
  
===Stabile Version von ''Flathub.org''===
+
=Konfiguration=
Siehe auch: [https://flathub.org/apps/details/org.gnucash.GnuCash Flathub]
+
==Zugriff auf zusätzliche Resourcen==
 +
Jedes Flatpak ist zunächst ein abgeschotteter Sandkasten. Um Zugriff auf zusätzliche Resourcen zu erlangen, ist eine entsprechende Freigabe erforderlich.
 +
;USB- oder Netzwerk-Laufwerk:
 +
:;mit festem Mountpoint: {{Flatpak overwrite-fs.sh}}
 +
:;mit wechselndem Mountpoint: {{Flatpak overwrite-vfs.sh}}
 +
::Das GnuCash Flatpak kann dann die Freigabe, sofern gemountet, unter <tt>Andere Orte</tt> sehen. <ref>Aus [{{URL:reddit}}r/pop_os/comments/1702jkd/ reddit: Flatpak app don't seemed to have access to network drives]</ref>
  
Die Version ''Gnucash 3.7'' enthielt noch ''Aqbanking 5.8.2'' (für „''PSD2''“ '''ungeeignet''', Online-Banking per ''[[:Category:De/FinTS|FinTS]]''/''[[De/HBCI|HBCI]]'' ging damit nicht mehr).
+
;Kartenleser <q>Smartcard Reader</q>: Damit AqBanking auf eine Karte für FinTS zugreifen kann, muß
{{Install_Flatpak_sh}}
+
:# Auf dem Wirtssystem —Ihrem Linux-PC— der Dienst <tt>pcscd</tt> laufen,
;Hinweis: Am Ende jeden Quartals erscheint eine neue Gnucash-Version. Um darauf zu aktualisieren,  <SyntaxHighlight lang="sh">
+
:# der zugehörige Sockel freigeschaltet werden: {{Flatpak_PCSC_Socket.sh}}
flatpak update
+
:::Statt dieser ''einmaligen'' Freigabe könnte man das Programm auch ''jedesmal'' mit <syntaxhighlight lang="sh">
</Syntaxhighlight> aufrufen.
+
flatpak --socket=pcsc run org.gnucash.GnuCash
 +
</syntaxhighlight> starten, aber wer will das schon?
 +
;Siehe auch: {{URL:FP-docs|de}}sandbox-permissions.html
  
 
=Tips=
 
=Tips=
==Wartung==
 
Von Zeit zu Zeit sollte man <syntaxhighlight lang="sh" inline>flatpak update</syntaxhighlight> aufrufen, um zu sehen, für welche Komponenten es Aktualisierungen gibt. Das ist vor allem wichtig, wenn man ein '''Problem''' gemeldet hat, zu dem die Gnucash-Entwickler meinen, es liegt nicht in Gnucash, sondern in den von Flatpak verwendeten Gnome-Bibliotheken. Aber auch aus '''Sicherheitsgründe'''n sollte man immer aktuelle Umgebungen verwenden.
 
 
==Optische TANs==
 
Zur Anzeige optischer TANs haben einige AqBanking-Werkzeuge den Parameter <tt>--opticaltan=</tt>''<Pfad/zum/Anzeige-Programm>'', z.B. <tt>/usr/bin/gwenview</tt>. Sollte Flatpak das in seinem Sandkasten nicht finden, kann man stattdessen <tt>/usr/bin/xdg-open</tt> angeben, welches dann alle passenden Programme zur Auswahl anbietet. Es ist Bestandteil des Pakets 'xdg-utils', welches man dann natürlich installiert haben sollte.
 
 
 
==Befehlszeilen-Werkzeuge aufrufen==
 
==Befehlszeilen-Werkzeuge aufrufen==
 
Man kann mit <tt>--command</tt> ein Kommando angeben, dass <tt>flatpak run</tt> statt des eigentlichen Programms ausführen soll.
 
Man kann mit <tt>--command</tt> ein Kommando angeben, dass <tt>flatpak run</tt> statt des eigentlichen Programms ausführen soll.
:Also: <Syntaxhighlight lang="sh>flatpak run --command=sh org.gnucash.GnuCash</Syntaxhighlight>
+
;Beispiel 1: Shell (Befehlsinterpreter) starten, um mehrere Befehle einzu geben {{Flatpak_Shell_sh}}
 
:öffnet eine Shell innerhalb der Flatpak-Umgebung von ''GnuCash'', in der man dann auch <tt>aqbanking-cli</tt> oder <tt>gnc-fq-*</tt> Skripte aufrufen kann.
 
:öffnet eine Shell innerhalb der Flatpak-Umgebung von ''GnuCash'', in der man dann auch <tt>aqbanking-cli</tt> oder <tt>gnc-fq-*</tt> Skripte aufrufen kann.
 +
;Beispiel 2: Einzelnes Programm ausführen, z.B. die Kursdatenbank aktualisieren {{Flatpak_Quotes_sh}} Beachte die Reihenfolge der Argumente!
 +
:Das ist hilfreich, wenn man Befehle zeitgesteuert durch einen modernen [https://de.wikipedia.org/wiki/Systemd systemd] timer oder klassisch als [https://de.wikipedia.org/wiki/Cron cron]-Job starten will.
 +
 +
== Online-Banking FinTS==
 +
===Optische TANs===
 +
Zur Anzeige optischer TANs haben einige AqBanking-Werkzeuge den Parameter <tt>--opticaltan=</tt>''<Pfad/zum/Anzeige-Programm>'', z.B. <tt>/usr/bin/gwenview</tt>. Sollte Flatpak das in seinem Sandkasten nicht finden, kann man stattdessen <tt>/usr/bin/xdg-open</tt> angeben, welches dann alle passenden Programme zur Auswahl anbietet. Es ist Bestandteil des Pakets '[flatpak-]xdg-utils', welches man dann natürlich installiert haben sollte.
 +
===Schlüsselkarte, ChipTAN===
 +
siehe oben, [[#Zugriff auf zusätzliche Resourcen]].
 +
 +
==SQL Verbindung==
 +
Verwende <tt>127.0.0.1</tt> statt <tt>localhost</tt>. Bei Letzterem verwendet MySQL Unix-Sockel, welche normalerweise im Sandkasten unerlaubt sind. Man kann natürlich auch den [[#Zugriff auf zusätzliche Resourcen|Zugriff]] erlauben. Dafür muß man zunächst durch Beobachtung des Dateisystems herausfinden, wo die angelegt werden und dann den Zugrif für das <tt>org.gnucash.GnuCash</tt> Paket erlauben.
 +
 +
Der Aufruf von <tt>127.0.0.1</tt> zwingt dagegen MySQL, eine echte Netzwerk-Verbindung aufzubauen, die im GnuCash Flatpak nicht eingeschränkt ist.
 +
 +
Details: [https://github.com/flathub/org.gnucash.GnuCash/issues/17 FlatHub GnuCash issue 17]
 +
 +
==Wartung==
 +
===Flatpak-Komponenten aktualisieren===
 +
Von Zeit zu Zeit sollte man — auch  wenn keine neue GnuCash-Version angekündigt wurde — <syntaxhighlight lang="sh">[sudo] flatpak update</syntaxhighlight> aufrufen, um zu sehen, für welche Komponenten es Aktualisierungen gibt. Das kann dann so aussehen: {{Flatpak_update_sh}} Das ist vor allem wichtig, wenn man ein '''Problem''' gemeldet hat, zu dem die Gnucash-Entwickler meinen, es liegt nicht in Gnucash, sondern in den von Flatpak verwendeten Gnome-Bibliotheken. Aber auch aus '''Sicherheitsgründe'''n sollte man immer aktuelle Umgebungen verwenden.
 +
 +
===Flatpak aufräumen===
 +
Gerade wenn man flatpaks aus verschiedenen Quellen, etwa <q>Release</q> undn <q>Nightlies</q>, installiert hat, empfiehlt es sich, nicht länger benötigte Versionen zu deinstallieren.
 +
;Übersicht verschaffen: Folgede Ausgabe ist sehr weit, eventuell Fenster vergrößern: {{Flatpak_list_con}}
 +
;Nicht länger beötigte GnuCash-Flatpaks löschen: {{Flatpak uninstall con}}
 +
;Nicht länger beötigte Runtimes etc. löschen: {{Flatpak Cleanup con}}
  
 
==Fehlersuche==
 
==Fehlersuche==
Falls es irgendwelche Probleme gibt, hilft es bisweilen, die ''Konsolen-Ausgabe'' zu beobachten: <Syntaxhighlight lang="sh>flatpak run org.gnucash.GnuCash</Syntaxhighlight>
+
# Falls es irgendwelche Probleme gibt, hilft es bisweilen, die '''Konsolen-Ausgabe''' zu beobachten: <Syntaxhighlight lang="sh>flatpak run org.gnucash.GnuCash</Syntaxhighlight>
In der nächsten Stufe <Syntaxhighlight lang="sh>
+
# In der nächsten Stufe <Syntaxhighlight lang="sh>
 
flatpak run org.gnucash.GnuCash --logto stdout
 
flatpak run org.gnucash.GnuCash --logto stdout
 +
</Syntaxhighlight> werden alle '''Log-Daten''' auf der Konsole statt in einer schwer erreichbaren Trace-Datei geschrieben.
 +
#;Siehe auch: [[De/Feedback|Feedback]]
 +
# Zur Kommunikation mit Anderen ist es hilfreich, ein paar Infos zum aktuellen System zusammenzustellen:
 +
#;Programm Info: <Syntaxhighlight lang="sh>
 +
flatpak info org.gnucash.GnuCash/x86_64/stable
 +
</Syntaxhighlight>
 +
#;ggf. geänderte Privilegien: <Syntaxhighlight lang="sh>
 +
flatpak override --show -vv gnucash.org.GnuCash
 +
</Syntaxhighlight>
 +
#;Flatpak Paket-Übersicht: <Syntaxhighlight lang="sh>
 +
flatpak list
 
</Syntaxhighlight>
 
</Syntaxhighlight>
werden alle Log-Daten auf der Konsole statt in einer schwer erreichbaren Trace-Datei geschrieben.
+
#Bei einem Absturz kommgt man an einen '''Stacktrace''' mit {{Flatpak-coredumpctl_hlp}}
;Siehe auch: [[De/Feedback|Feedback]]
+
#Weitere Debugging-Optionen: [{{URL:FP-docs|de}}debugging.html Debugging].
 +
 
 +
==Bekannte Problemlösungen==
 +
===Nach Update startet Programm auf Englisch===
 +
<syntaxhighlight lang="console">
 +
$ flatpak config
 +
languages: *unset* (default: en)
 +
extra-languages: *unset*
 +
</syntaxhighlight> Hier stimmt mit der '''Flatpak-Konfiguration''' etwas nicht. Abhilfe: <syntaxhighlight lang="sh">
 +
flatpak config --set languages de
 +
flatpak update
 +
</syntaxhighlight><ref>{{ListURL}}/pipermail/gnucash-de/2021-April/012137.html</ref>
  
 
==[[De/Flatpak/Migrationsanleitung|Migrationsanleitung]] von einer Distributions-Installation ausgehend==
 
==[[De/Flatpak/Migrationsanleitung|Migrationsanleitung]] von einer Distributions-Installation ausgehend==
  
[[Category:De|Flatpak]][[Category:Flatpak|de]]
+
[[Category:De|Flatpak]][[Category:Flatpak|de]][[Category:De/FinTS|Flatpak]]

Latest revision as of 18:02, 22 June 2024

Languages English

Flatpaks sind Bündel, welche neben dem Programm auch alle erforderlichen Bibliotheken enthalten. Falls Ihre Linux-Distribution für erforderliche Bibliotheken zu alt ist, aber Flatpak-Unterstützung hat, können Sie damit dennoch eine aktuelle GnuCash-Version — auch parallel zu der ihrer Distribution — installieren.

Das Programm läuft dabei in einer teilweise abgeschotteten Umgebung—Sandkasten—, kann also beispielsweise nur auf das Heimat-Verzeichnis des aufrufenden Benutzers schreibend zugreifen und in der Regel weite Teile des Dateisystems, welche zur Programmausführung nicht notwenig sind, nicht einmal lesen. Damit es keine Konflikte mit einer normalen Installation gibt, befinden sich die Anwendungsdaten für Konfiguration etc. in

$HOME/.var/app/org.gnucash.GnuCash/ und
$HOME/.local/share/flatpak/app/org.gnucash.GnuCash/

Bekannte Einschränkungen

  • Wir haben darauf verzichtet, die Python Bindings zu bündeln,
  • kein direkter Druck von Berichten, aber Ihr Druck in eine Datei und direkter Scheckdruck funktionieren.
  • Wenn Sie Ihre Smart Card beim Online-Banking benutzen wollen, benötigen Sie mindestens Flatpak 1.3.2 auf Ihrem Computer. Die weiteren Schritte sind in #Zugriff auf zusätzliche Resourcen beschriebenen.
  • Die englische Version dieser Seite hat noch einen Absatz zur Speicherung der GnuCash Präferenzen.
  • Ein nur in Ubuntu-Derivaten beobachteter Fehler, der Guile veranlaßt, alle scm-Quellen neu zu übersetzen:
    :
    ;;; note: source file /app/share/guile//2.2/ice-9/eval.scm
    ;;;       newer than compiled /app/lib/guile/2.2/ccache/ice-9/eval.go
    :
    
Workaround:
# --system install
cd /var/lib/flatpak/app/org.gnucash.GnuCash
# OR --user install
cd $HOME/.local/share/flatpak/app/org.gnucash.GnuCash

sudo find . -name '*.go' -exec touch '{}' ';'

Installation

Viele Paketmanager wie Gnome Software oder KDE's Discover können so konfiguriert werden, daß sie zumindest Flatpaks von Flathub installieren und aktualisieren können, aber auf dieser Seite verwenden wir das mächtigere flatpak Befehlszeilen-Werkzeug. Das Beispiel zur Installation von Flatpak selbst wurde für Debian —ab Buster ist Flatpak regulär, für Stretch/Jessie in den „Backports“ enthalten— und Derivate wie Ubuntu geschrieben.

Tip
Für andere Distributionen ist also apt … durch das jeweilige Software-Installationswerkzeug zu ersetzten, z.B. für viele rpm-basierte
zypper install flatpak
Flatpak selbst hat aber auch Anleitungen für verschiedene Distributionen.

Serverübersicht

  • Die #Stabile_Version_von_Flathub.org entspricht offiziellen GnuCash-Versionen und eignet sich für Distributionen, die kein aktuelles GnuCash mitliefern, aber über ein genügend aktuelles FlatPak-Paket verfügen.
  • #Testversion_von_Gnucash.org sind aktuelle Schnappshüsse, um Flicken (Patches) zu testen. An anderer Stelle können aber neue Löcher aufgetreten sein.
Anmerkung zu den folgenden Beispielen
sudo muß nicht angegeben werden. flatpak ist smart genug, bei Bedarf einen entsprechenden Dialog vom verwendeten Desktop anzufordern wie z.B. bei KDE FP-Auhentication-KDE.png

Offizielle Versionen auf Flathub.org

Auf Flathub steht neben der aktuellen stabilen —GnuCash 5.9— in der Testphase von einigen Monaten vor einer neuen Haupversion auch eine Vorschau als unstable (instabile) —GnuCash 5.9xx— bereit. Die genauen Daten werden im Release Schedule angekündigt.

  • Beide Zweige können parallel installiert werden.
Siehe auch
Flathub
Hinweis zu PSD2
Die Version Gnucash 3.7 enthielt noch Aqbanking 5.8.2 und war damit für „PSD2ungeeignet, Online-Banking per FinTS/HBCI oder chipTAN ging damit seit September 2019 nicht mehr. Seitdem enthielt jede Version der 3.x-Serie noch weitere Verbessserungen dazu.
Die aktuellen Versionen enthalten Aqbanking 6.5.4.
Das Team bittet daher darum, davon abzusehen, Probleme zu melden, welche längst gelöst wurden!
Stabile Version
# Install FlatPak (on debian based distributions, others have to replace 'apt-get install'):
sudo apt-get install flatpak

# Register FlatHub repository for a system app (available to all users):
sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
# or only you:
flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Install GnuCash ...
# for all users:
#  sudo is only needed for a --system install, if the user is not in the 'sudo' group
#  --system is the default if --user is not specified
sudo flatpak install --system flathub org.gnucash.GnuCash
# or only you:
flatpak install --user flathub org.gnucash.GnuCash

# Run GnuCash:
flatpak run org.gnucash.GnuCash
Tip
Am Ende jeden Quartals erscheint eine neue Gnucash-Version. Um danach darauf zu aktualisieren,
flatpak update
aufrufen.
Beta-Version ("unstable")
In den letzten Monaten vor einer neuen Hauptversion erscheinen Vorschauen, genannt Beta-Version. In dieser Testphase erscheint mindestens am Ende jeden Monats eine neue Gnucash-Beta-Version.
Für die Beta-Version, führen Sie "im Prinzip" dieselben Schritte aus wie für die stabile, aber register, install und run wie folgt:
# Register:
flatpak remote-add --user --if-not-exists flathub https://flathub.org/beta-repo/flathub-beta.flatpakrepo
# Install
flatpak install --user flathub-beta org.gnucash.GnuCash
# Run
flatpak run --branch=beta org.gnucash.GnuCash

Tägliche Testversionen —Nightlies— auf gnucash.org

Gewöhnlich gibt es Schnappschüsse der aktuellen Programmentwicklung auf dem Build-Server.

Die aktuellen Versionen enthalten Aqbanking 6.5.12beta.
Warnung
Vor Gebrauch von Testversionen unbedingt Daten sichern!

Zu finden sind die aktuellen Versionen hier (das sind nicht die eigentlichen Programmpakete, sondern Referenzdateien, die Flatpak' sagen, was heruntergeladen werden soll):

Stable
Testversion 5.9 mit aktuellen Fehlerbehebungen, aber ohne neue Programmeigenschaften (aus Stabilitätsgründen zu bevorzugen):
https://code.gnucash.org/builds/flatpak/stable/?C=M;O=D
Future
Erst verfügbar, wenn das erste Feature aus Release Schedule#Goals for 6.0 implementiert ist!
Testversion 5.900 mit verzögerten Fehlerbehebungen, aber neuen Programmeigenschaften: https://code.gnucash.org/builds/flatpak/future/?C=M;O=D

Die Dateinamen aus diesen Verzeichnissen können im Beispiel unten verkürzt eingesetzt werden: vorne „gnucash-“ und hinten „.flatpakref“ weglassen.

sudo apt install flatpak  #Nur beim allerersten Mal: Flatpak installieren
# Auch einmalig: Repositorien registrieren:
sudo flatpak remote-add --if-not-exists gnucash https://code.gnucash.org/builds/flatpak/gnucash-nightlies.flatpakrepo
sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
# Anzeige aller im Repositorium vorhandenen Programmpakete:
flatpak --arch=x86_64 remote-ls gnucash
# Ausgabe ist ähnlich:
# org.gnucash.GnuCash
# org.gnucash.GnuCash.Debug
# org.gnucash.GnuCash.Locale
sudo flatpak install gnucash org.gnucash.GnuCash/x86_64/maint-C3.7-254-g1af8e272c-D3.7-57-g022975e  # <-- Version anpassen!
flatpak run org.gnucash.GnuCash  # Beliebig oft: Programmstart

Konfiguration

Zugriff auf zusätzliche Resourcen

Jedes Flatpak ist zunächst ein abgeschotteter Sandkasten. Um Zugriff auf zusätzliche Resourcen zu erlangen, ist eine entsprechende Freigabe erforderlich.

USB- oder Netzwerk-Laufwerk
mit festem Mountpoint
# After configuring automatic mounting of the drive in the host system
sudo flatpak override org.gnucash.GnuCash --filesystem=$PATH_TO_DRIVE
mit wechselndem Mountpoint
sudo flatpak override org.gnucash.GnuCash --talk-name=org.gtk.vfs.* --filesystem=xdg-run/gvfs
Das GnuCash Flatpak kann dann die Freigabe, sofern gemountet, unter Andere Orte sehen. [1]
Kartenleser Smartcard Reader
Damit AqBanking auf eine Karte für FinTS zugreifen kann, muß
  1. Auf dem Wirtssystem —Ihrem Linux-PC— der Dienst pcscd laufen,
  2. der zugehörige Sockel freigeschaltet werden:
    sudo flatpak override org.gnucash.GnuCash --socket=pcsc
    
Statt dieser einmaligen Freigabe könnte man das Programm auch jedesmal mit
flatpak --socket=pcsc run org.gnucash.GnuCash
starten, aber wer will das schon?
Siehe auch
https://docs.flatpak.org/de/latest/sandbox-permissions.html

Tips

Befehlszeilen-Werkzeuge aufrufen

Man kann mit --command ein Kommando angeben, dass flatpak run statt des eigentlichen Programms ausführen soll.

Beispiel 1
Shell (Befehlsinterpreter) starten, um mehrere Befehle einzu geben
flatpak run --command=sh org.gnucash.GnuCash
öffnet eine Shell innerhalb der Flatpak-Umgebung von GnuCash, in der man dann auch aqbanking-cli oder gnc-fq-* Skripte aufrufen kann.
Beispiel 2
Einzelnes Programm ausführen, z.B. die Kursdatenbank aktualisieren
flatpak run --command=gnucash-cli org.gnucash.GnuCash --quotes get /path/to/file.gnucash
Beachte die Reihenfolge der Argumente!
Das ist hilfreich, wenn man Befehle zeitgesteuert durch einen modernen systemd timer oder klassisch als cron-Job starten will.

Online-Banking FinTS

Optische TANs

Zur Anzeige optischer TANs haben einige AqBanking-Werkzeuge den Parameter --opticaltan=<Pfad/zum/Anzeige-Programm>, z.B. /usr/bin/gwenview. Sollte Flatpak das in seinem Sandkasten nicht finden, kann man stattdessen /usr/bin/xdg-open angeben, welches dann alle passenden Programme zur Auswahl anbietet. Es ist Bestandteil des Pakets '[flatpak-]xdg-utils', welches man dann natürlich installiert haben sollte.

Schlüsselkarte, ChipTAN

siehe oben, #Zugriff auf zusätzliche Resourcen.

SQL Verbindung

Verwende 127.0.0.1 statt localhost. Bei Letzterem verwendet MySQL Unix-Sockel, welche normalerweise im Sandkasten unerlaubt sind. Man kann natürlich auch den Zugriff erlauben. Dafür muß man zunächst durch Beobachtung des Dateisystems herausfinden, wo die angelegt werden und dann den Zugrif für das org.gnucash.GnuCash Paket erlauben.

Der Aufruf von 127.0.0.1 zwingt dagegen MySQL, eine echte Netzwerk-Verbindung aufzubauen, die im GnuCash Flatpak nicht eingeschränkt ist.

Details: FlatHub GnuCash issue 17

Wartung

Flatpak-Komponenten aktualisieren

Von Zeit zu Zeit sollte man — auch wenn keine neue GnuCash-Version angekündigt wurde —
[sudo] flatpak update
aufrufen, um zu sehen, für welche Komponenten es Aktualisierungen gibt. Das kann dann so aussehen:
        ID                                    Zweig  Op  Remote   Download
 1.     org.freedesktop.Platform.GL.default   19.08  u   flathub   < 85,1 MB
 2.     org.freedesktop.Platform.VAAPI.Intel  19.08  u   flathub    < 8,7 MB
 3.     org.gnome.Platform.Locale             3.34   u   flathub  < 322,2 MB (partial)
 4.     org.gnome.Platform                    3.34   u   flathub  < 320,4 MB
 5.     org.gnome.Sdk.Locale                  3.34   u   flathub  < 325,8 MB (partial)
 6.     org.gnome.Sdk                         3.34   u   flathub  < 663,9 MB

Proceed with these changes to the user installation? [Y/n]:
Das ist vor allem wichtig, wenn man ein Problem gemeldet hat, zu dem die Gnucash-Entwickler meinen, es liegt nicht in Gnucash, sondern in den von Flatpak verwendeten Gnome-Bibliotheken. Aber auch aus Sicherheitsgründen sollte man immer aktuelle Umgebungen verwenden.

Flatpak aufräumen

Gerade wenn man flatpaks aus verschiedenen Quellen, etwa Release undn Nightlies, installiert hat, empfiehlt es sich, nicht länger benötigte Versionen zu deinstallieren.

Übersicht verschaffen
Folgede Ausgabe ist sehr weit, eventuell Fenster vergrößern:
$ flatpak list
Name                             Application ID                 Version  Zweig                                       Ursprung         Installation
default                          …eedesktop.Platform.GL.default          19.08                                       flathub          user
Mesa                             …eedesktop.Platform.GL.default 21.1.7   20.08                                       flathub          system
Mesa                             …eedesktop.Platform.GL.default 21.1.7   20.08                                       flathub          user
Mesa                             …eedesktop.Platform.GL.default 21.2.2   21.08                                       flathub          user
Intel                            …edesktop.Platform.VAAPI.Intel          19.08                                       flathub          user
Intel                            …edesktop.Platform.VAAPI.Intel          20.08                                       flathub          system
Intel                            …edesktop.Platform.VAAPI.Intel          20.08                                       flathub          user
Intel                            …edesktop.Platform.VAAPI.Intel          21.08                                       flathub          user
openh264                         …freedesktop.Platform.openh264 2.1.0    2.0                                         flathub          system
openh264                         …freedesktop.Platform.openh264 2.1.0    2.0                                         flathub          user
GNOME Application Platform vers… org.gnome.Platform                      3.38                                        flathub          user
GNOME Application Platform vers… org.gnome.Platform                      40                                          flathub          system
GNOME Application Platform vers… org.gnome.Platform                      40                                          flathub          user
GNOME Application Platform vers… org.gnome.Platform                      41                                          flathub          user
GNOME Software Development Kit … org.gnome.Sdk                           3.38                                        flathub          user
GNOME Software Development Kit … org.gnome.Sdk                           40                                          flathub          user
GNOME Software Development Kit … org.gnome.Sdk                           41                                          flathub          user
GnuCash                          org.gnucash.GnuCash                     4.8a+ (Flathub 4.8-1) stable                flathub          system
GnuCash                          org.gnucash.GnuCash            fbf8284+ maint-C4.8a-62-gfbf828476f-D4.8-3-g9d2b4e95 gnc-testing-repo user
Nicht länger beötigte GnuCash-Flatpaks löschen
$ flatpak uninstall GnuCash
Similar installed refs found for ‘GnuCash’:

   1) app/org.gnucash.GnuCash/x86_64/stable (system)
   2) app/org.gnucash.GnuCash/x86_64/maint-C4.11-8-geb48f0830e-D4.11-5-g9b8cf9ed (user)
   3) app/org.gnucash.GnuCash/x86_64/maint-C4.11-152-g1b384df622-D4.11-38-g414840da (user)
   4) app/org.gnucash.GnuCash/x86_64/maint-C4.10-49-g27e5515c43-D4.10.1-5-g937e8a81 (user)
   5) All of the above

Which do you want to use (0 to abort)? [0-5]: 4


        KENNUNG                                  Zweig                                                        Op
 1. [-] org.gnucash.GnuCash                      maint-C4.10-49-g27e5515c43-D4.10.1-5-g937e8a81               r
 2. [-] org.gnucash.GnuCash.Locale               maint-C4.10-49-g27e5515c43-D4.10.1-5-g937e8a81               r

Deinstallation abgeschlossen.
$
Nicht länger beötigte Runtimes etc. löschen
$ flatpak uninstall --unused

These runtimes in installation 'user' are pinned and won't be removed; see flatpak-pin(1):
  runtime/org.gnome.Platform/x86_64/40
  runtime/org.gnome.Platform/x86_64/41
  runtime/org.gnome.Sdk/x86_64/40
  runtime/org.gnome.Sdk/x86_64/41


        KENNUNG                                       Zweig          Op
 1. [-] org.freedesktop.Platform.GL.default           19.08          r
 2. [-] org.freedesktop.Platform.VAAPI.Intel          19.08          r
 3. [-] org.gnome.Platform                            3.38           r
 4. [-] org.gnome.Platform.Locale                     3.38           r
 5. [-] org.gnome.Sdk                                 3.38           r
 6. [-] org.gnome.Sdk.Locale                          3.38           r

Uninstall complete.

Fehlersuche

  1. Falls es irgendwelche Probleme gibt, hilft es bisweilen, die Konsolen-Ausgabe zu beobachten:
    flatpak run org.gnucash.GnuCash
    
  2. In der nächsten Stufe
    flatpak run org.gnucash.GnuCash --logto stdout
    
    werden alle Log-Daten auf der Konsole statt in einer schwer erreichbaren Trace-Datei geschrieben.
    Siehe auch
    Feedback
  3. Zur Kommunikation mit Anderen ist es hilfreich, ein paar Infos zum aktuellen System zusammenzustellen:
    Programm Info
    flatpak info org.gnucash.GnuCash/x86_64/stable
    
    ggf. geänderte Privilegien
    flatpak override --show -vv gnucash.org.GnuCash
    
    Flatpak Paket-Übersicht
    flatpak list
    
  4. Bei einem Absturz kommgt man an einen Stacktrace mit
    $ flatpak-coredumpctl --help
    usage: Debug in gdb an application that crashed inside flatpak. It uses (and thus requires) coredumpctl to retrieve the coredump file.
           [-h] [-b BUILD_DIRECTORY] [--extra-flatpak-args EXTRA_FLATPAK_ARGS] [-m [COREDUMPCTL_MATCHES]]
           [--gdb-arguments GDB_ARGUMENTS]
           [app]
    
    positional arguments:
      app                   The flatpak application to use. eg. `org.gnome.Epiphany//3.28`.
    
    optional arguments:
      -h, --help            show this help message and exit
      -b BUILD_DIRECTORY, --build-directory BUILD_DIRECTORY
                            The build directory to use. It allows you to retrieve a coredump for applications being built
      --extra-flatpak-args EXTRA_FLATPAK_ARGS
                            Extra argument to pass to flatpak
      -m [COREDUMPCTL_MATCHES], --coredumpctl-matches [COREDUMPCTL_MATCHES]
                            Coredumpctl matches, see `man coredumpctl` for more information.
      --gdb-arguments GDB_ARGUMENTS
                            Arguments to pass to gdb.
    
  5. Weitere Debugging-Optionen: Debugging.

Bekannte Problemlösungen

Nach Update startet Programm auf Englisch

$ flatpak config
languages: *unset* (default: en)
extra-languages: *unset*
Hier stimmt mit der Flatpak-Konfiguration etwas nicht. Abhilfe:
flatpak config --set languages de
flatpak update
[2]

Migrationsanleitung von einer Distributions-Installation ausgehend