View source for De/Flatpak

{| class="wikitable" style="margin: auto;"
! scope="row"|Languages
| [[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.

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=
* 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 [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.
* Die [[Flatpak#Known Issues|englische Version dieser Seite]] hat noch eine 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}}
* [https://github.com/flathub/org.gnucash.GnuCash/issues/ Aktuelle Liste]

=Installation=
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.
;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==
* 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.

===Offizielle Versionen auf ''Flathub.org''===
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}}.

;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):
: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/]
:Testversion {{BetaVersion}} mit ''verzögerten'' Fehlerbehebungen, aber neuen Programmeigenschaften: [{{BuildURL}}/builds/flatpak/master/?C=M;O=D {{BuildServer}}/builds/flatpak/master/]
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">
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
</Syntaxhighlight>

=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-Laufwerk: {{Flatpak overwrite-fs.sh}}
;Kartenleser <q>Smartcard Reader</q>: Damit AqBanking auf eine Karte für FinTS zugreifen kann, muß
:# Auf dem Wirtssystem —Ihrem Linux-PC— der Dienst <tt>pcscd</tt> laufen,
:# muß der zugehörige Sockel freigeschaltet werden: {{Flatpak_PCSC_Socket.sh}}
:::Statt dieser ''einmaligen'' Freigabe könnte man das Programm auch ''jedesmal'' mit <syntaxhighlight lang="sh">
flatpak --socket=pcsc run org.gnucash.GnuCash 
</syntaxhighlight> starten, aber wer will das schon?
;Siehe auch: {{URL:FP-docs}}de/latest/sandbox-permissions.html

=Tips=
==Befehlszeilen-Werkzeuge aufrufen==
Man kann mit <tt>--command</tt> ein Kommando angeben, dass <tt>flatpak run</tt> statt des eigentlichen Programms ausführen soll.
;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.
;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==
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.

==Fehlersuche==
# 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>
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>
#Bei einem Absturz kommgt man an einen '''Stacktrace''' mit {{Flatpak-coredumpctl_hlp}}
#Weitere Debugging-Optionen: [https://docs.flatpak.org/de/latest/debugging.html Debugging].

==Bekannte Problemlösungen==
===Nach Update startet Programm auf Enlisch===
<syntaxhighlight lang="console">
$ flatpak config
languages: *unset* (default: en)
extra-languages: *unset*
</syntaxhighlight> Hier ging die Konfiguration verloren. 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==

[[Category:De|Flatpak]][[Category:Flatpak|de]][[Category:De/FinTS|Flatpak]]