Die Einrichtung und Verwendung von Hibiscus bereitet Usern des Betriebssystems Mac OS häufig Probleme. Das liegt zum einen daran, dass dem Autor von Hibiscus bis vor kurzem kein entsprechender Test-Rechner zur Verfügung stand, um die Anwendung auf dieser Plattform testen zu können. Zum anderen unterscheidet sich Mac OS (trotz seiner Abstammung von FreeBSD) recht stark von vergleichbaren unixoiden Systemen. Die folgende FAQ soll Mac-Usern bei den typischsten Problemen helfen, die beim Betrieb von Hibiscus auf diesem Betriebssystem auftreten.

Falls das Problem erst seit OSX 10.10 (Yosemite) auftritt, ist die Ursache vermutlich die Java-Version (siehe folgender Absatz).

Falls deine OSX-Version stattdessen eher recht alt ist: Aktuelle Hibiscus-Versionen laufen nur noch in OS X 10.5 (nur Intel) oder höher. Siehe auch Installation unter OS X 10.4

Falls das Problem erst seit OSX 10.10 (Yosemite) auftritt, liegt das an einer falschen Java-Version. Installiere die hier - http://support.apple.com/kb/dl1572 - angegebene Java-Version.

Das Problem ist in den folgenden Foren-Beiträgen näher beschrieben.

• http://www.apfeltalk.de/community/threads/geloest-problem-mit-java.469130/
• https://discussions.apple.com/thread/6602340

Ob und wann Apple eine korrigierte Java-Version bereistellen wird, ist derzeit nicht bekannt.

Nachtrag vom 02.11.2014: Jan schreibt in einem Kommentar meines Blogs, dass der verlinkte Workaround nicht wirklich sinnvoll ist, da hierbei eine veraltetes JRE in Version 6 installiert wird. Funktionieren solle wohl stattdessen auch die Installation des JDK (statt JRE) von der Oracle-Webseite. Da ich selbst kein OS X Yosemite habe, kann ich alle beschriebenen Lösungsansätze nicht verifizieren sondern nur so weitergeben.

Neben Hibiscus existieren noch weitere Plugins, die innerhalb des Jameica-Frameworks laufen (z.B. JVerein, Jollina, SynTAX). Nicht jeder User, der Jameica nutzt möchte also unbedingt auch Hibiscus installieren.

Die Problematik existierte nur bis Jameica 1.6. Seit Jameica 1.7 wird das Benutzerverzeichnis in folgendem Verzeichnis abgelegt (Das gilt jedoch nur für Neuinstallationen seit Jameica 1.7 - nicht für Updates von vorherigen Jameica-Installationen):

/Users/<username>/Library/jameica

Siehe hierzu auch der Blog-Beitrag http://www.willuhn.de/blog/index.php?/archives/388-Mac-Das-Problem-mit-dem-versteckten-Benutzerverzeichnis.html.
Falls der Ordner „Library“ nicht sichtbar ist, mit gedrückter ALT-Taste auf das Finder-Menü „Gehe zu“ klicken und dort „Library“ auswählen (Siehe auch hier).

Verzeichnisse, deren Namen mit einem „.“ beginnen, werden von Mac OS ausgeblendet. Auf unixoiden Systemen (also insbesondere Linux) ist es gängige Praxis, die Benutzerdaten von Anwendungsprogrammen in einem solchen Verzeichnis zu speichern. In Mac OS existieren folgende Möglichkeiten, solche Verzeichnisse im „Finder“ (also mit Bordmitteln) anzuzeigen: in der Menüleiste auswählen:„Gehe zu“/„Gehe zum Ordner…“ oder Tastatur: Befehl-Umschalt-G, dann Eingabe ins dann sich öffnende Suchfenster:

/Users/<Benutzername>/.jameica

oder einfach:

~/.jameica

Alternativ kann es mit folgendem Befehl in einem Terminal angezeigt werden:

ls -la ~/.jameica

Eine andere Möglichkeit besteht darin, dass man Finder alle Verzeichnisse (auch die ausgeblendeten/„versteckten“) anzeigen lässt. Wer das möchte kann einfach die Befehle

sudo defaults write com.apple.Finder AppleShowAllFiles YES
sudo killall Finder

ausführen. Nun werden alle Dateien angezeigt.

Wenn man das nicht mehr möchte (z.B., weil man versteckte Dateien in .dmgs nicht sehen möchte), dann ersetzt man YES im obigen Befehl einfach mit NO und führt beide Befehle nochmals aus.

Mac OS X beendet Prozesse - abhängig davon, wie sie beendet werden - unter Umständen „unsanft“. Vermutlich wird der Prozess hierbei nicht sauber mit einem SIGTERM sondern mit einem SIGKILL abgebrochen. Das führt dazu, dass Shutdown-Hooks der Java-VM nicht ausgeführt werden. Es findet kein sauberer Shutdown von Jameica statt sondern ein Programmabbruch, wodurch auch kein Backup mehr erstellt werden kann. Es existierene folgende Möglichkeiten, einen Prozess unter Mac OS X zu beenden:

Lösung: Bitte wähle eine der ersten beiden Varianten zum Beenden des Programms.

Chipkartenleser werden von Hibiscus nur unter Linux und Windows unterstützt. Prinzipiell sollte das zwar auch auf Mac OS funktionieren, wurde jedoch noch nicht erfolgreich getestet. Weitere Schwierigkeiten und Lösungsansätze zum Betrieb des Kartenlesers unter OS X 64bit werden derzeit auch in folgendem Bugreport besprochen: https://www.willuhn.de/bugzilla/show_bug.cgi?id=965

Generell gilt: Mac OS X bringt den pcscd-Daemon mit, mit dem man Chipkartenleser ansteuern und verwenden kann.

Um den Chipkartenleser auch unter Mac OS X verwenden zu können, braucht man das Treiber-Package (die PCSC-Treiber) vom Hersteller. Reiner-SCT bietet sowas an.

Dieser Treiber muss zuerst installiert werden (bitte bevor der Kartenleser an das System angeschlossen wird.)

Bitte befolgen Sie dazu die Anweisungen den Herstellers.

Wird der Kartenleser dann an das System angeschlossen (beispielsweise per USB), so wird pcscd automatisch von launchd gestartet und nimmt seine Arbeit auf - mit den neuen Treibern.

Experimentierfreudige Nutzer können nach dem Anstecken das Tool pcsctest verwenden und zwei mal die Zahl 1 eingeben (wenn man dazu aufgefordert wird) - ist kein anderer Kartenleser angeschlossen und hat man eine Karte in den Leser gesteckt sollte jeweils eine Erfolgsmeldung ausgegeben werden und sich das Tool beim zweiten Mal beenden.

Nun kann Hibiscus jedoch nicht auf die PCSC-Schnittstelle zugreifen, da von Hibiscus (bzw. HBCI4Java) nur die ältere API CTAPI unterstützt wird.

Daher braucht man einen Wrapper von PCSC auf CTAPI.

Der Wrapper unter http://sourceforge.net/projects/pcsc-ctapi/files scheint stabil und zuverlässig zu funktionieren, sowie eine grosse Anzahl von Funktionen umbiegen zu können.

Eine bereits kompilierte Version für Mac OS X 10.6 kann direkt hier heruntergeladen werden: http://www.ionic.de/pcsc-ctapi-wrapper-0.3-UNIVERSAL.tar.bz2

Dieses Archiv wird ausgepackt und anschliessend wie im Selbstbau-Prozess beschrieben an die richtige Stelle nach /usr/local/lib kopiert (bitte dazu etwas runterscrollen und den Anweisungen folgen.)

Alternativ kann man die Library auch selbst bauen.

Voraussetzungen

Um den Wrapper bauen zu können, wird XCode (am besten in der jeweils aktuellsten Version) benötigt. Mehr Informationen dazu findet man über die Apple-Seiten.

Bauen und Installieren des Wrappers

Jetzt zur eigentlichen Installation: bitte den Wrapper herunterladen und in ein beliebiges Verzeichnis entpacken.

Anschließend wird mit

cd pcsc-ctapi-wrapper-<version>/

in das entpackte Verzeichnis gewechselt (derzeit ist 0.3 die aktuellste Version.)

Nun werden wir eine Universal Binary bauen, die 3 Architekturen enthält: i686 (32Bit-Version für Intel-Macs), amd64 (64Bit-Version für Intel-Macs) und ppc (32Bit-Version für alle älteren Macs - jedoch NICHT für Mac OS 9!)

Auf diese Weise stellen wir sicher, dass egal welche Java-Version verwendet wird, unser Wrapper stets verwendet werden kann.

Sollten die Voraussetzungen zum Bauen des Wrappers erfüllt sein, so kann man die Library mit folgendem Befehl übersetzen:

gcc -arch i386 -arch x86_64 -arch ppc -dynamiclib -framework PCSC -I . -I /System/Library/Frameworks/PCSC.framework/Versions/Current/Headers/ pcsc-ctapi-wrapper.c -o pcsc-ctapi-wrapper.dylib

Anschließend sollte eine Datei namens pcsc-ctapi-wrapper.dylib im aktuellen Verzeichnis zu finden sein.

Diese müssen wir nur noch an die richtige Stelle kopieren:

sudo mv -v pcsc-ctapi-wrapper.dylib /usr/local/lib

Dies ist alles was nötig war.

Das Problem scheint erst ab Mac OS X 10.5 aufzutreten. Die Ursache ist noch unbekannt. Alternativ kann ein Symbol zum Starten der Anwendung jedoch auch manuell angelegt werden. Hierzu muss lediglich ein Alias zum Start-Script „jameica-macos.sh“ erstellt werden. Das Script befindet sich im Programm-Verzeichnis von Jameica. Passende Icons befinden sich im Unterverzeichnis „plugins/hibiscus/icons“.