Das signoPAD-API für Java ist grundsätzlich auf allen Windows-Versionen ab Windows 7 mit vollem Funktionsumfang lauffähig. Andere Betriebssysteme werden mit einem eingeschränkten Funktionsumfang unterstützt. Details finden Sie weiter unten.
JRE-Abhängigkeit
Das signoPAD-API Java benötigt die Java Runtime Environment (JRE) ab Version 1.8. Es werden sowohl die 32 Bit als auch die 64 Bit Version unterstützt.
Die folgende Tabelle enthält Internet-Adressen unter denen Java kostenlos heruntergeladen werden kann.
Alle nicht standardmäßig in der JRE vorhandenen Komponenten werden mitgeliefert. In den folgenden Tabellen sind die Abhängigkeiten aufgeführt:
|
Abhängigkeit |
Bemerkung |
|---|---|
|
stpad-lib.jar |
signoPAD-API Java Bibliothek |
|
stlic-lib.jar |
- |
|
bcprov-jdk18on.jar |
- |
|
jna.jar |
- |
|
jna-platform.jar |
- |
|
swt-gtk-linux-x86_64.jar swt-gtk-linux-x86.jar swt-win32-win32-x86_64.jar swt-win32-win32-x86.jar |
Nur bei Verwendung des SWT Controls |
|
jpen.jar jpen.dll jpen-64.dll libjpen.so libjpen-x86_64.so |
Nur bei Verwendung der PenDisplayFacade mit der Bibliothek
. Siehe auch Methode |
|
jni4net.j.jar jwinpointer-se.jar |
Nur bei Verwendung der PenDisplayFacade mit der Bibliothek Siehe Methode |
“Pure” Java-Schnittstelle
Die signotec LCD Signature Pads können (je nach Ausstattung) über TCP/IP verwendet werden. Für auf diese Art angeschlossene Geräte steht eine Schnittstelle mit eingeschränkter Funktionalität zur Verfügung, die keine plattformabhängige Bibliothek benötigt und somit auf allen Systemen verwendet werden kann, auf den Java-Anwendungen ausgeführt werden können. Details zu dieser Schnittstelle finden Sie im Kapitel SigPadPureFacade.
Windows
Unter Windows wird bei Verwendung der SigPadFacade eine native Bibliothek aus der Datei stpad-lib.jar benötigt. Die darin enthaltene Bibliothek wird automatisch mit der Bibliothek Java Native Access (JNA) geladen.
Alternativ kann die Datei STPadJava.dll aus der stpad-lib.jar extrahiert werden und dessen Speicherort mit dem System-Property jna.library.path beim Start der Anwendung festgelegt werden. Andere DLL- und MANIFEST-Dateien, die in den Version 8.0.22 und früher enthalten waren, werden nicht mehr benötigt.
Linux
Unter Linux wird bei Verwendung der SigPadFacade eine native Bibliothek aus Datei stpad-lib.jar benötigt. Die darin enthaltene Bibliothek wird automatisch mit der Bibliothek Java Native Access (JNA) geladen.
Alternativ kann die Datei libSTPadJava.so aus der stpad-lib.jar extrahiert werden und dessen Speicherort mit dem System-Property jna.library.path beim Start der Anwendung festgelegt werden.
OpenSSL (libssl)
Bei Verwendung der SigPadFacade muss die Bibliothek OpenSSL (libssl) in Version 3.0 im System installiert sein.
libusb
Bei Verwendung von HID/WinUSB-Geräten wird außerdem eine im System installierte libusb ab Version 1.0.16 benötigt, die unter https://libusb.info kostenlos heruntergeladen werden kann.
Ggf. müssen noch die Berechtigungen für libusb angepasst werden. Hierzu muss der MODE für USB auf 0666 geändert werden:
# libusb device nodes
SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0666"
Anschließend muss udev neugestartet werden:
udevadm control --reload-rules
In Debian befindet sich diese Einstellung in der Datei /lib/udev/rules.d/50-udev-default.rules bzw. /lib64/udev/rules.d/50-udev-default.rules. Bei anderen Distributionen kann sich die Einstellung an einem anderen Ort befinden.
Java Advanced Imaging
Unterstützte Bildformate sind JPEG, BMP, WBMP und PNG. Um Unterschriften in anderen Bildformaten (JPEG 2000, PNM, RAW oder TIFF) exportieren zu können werden die Java Advanced Imaging Image I/O Tools benötigt. Diese sind als Open-Source-Projekte jai-imageio-core (u. a. TIFF, PNM, RAW) und jai-imageio-jpeg2000 (JPEG 2000) verfügbar.
Security Policies
Die SigPadPureFacade sowie die Methode SigPadApi.decryptSignatureData() verwenden kryptographische Verfahren, die in Oracle Java bis Version 9 standardmäßig deaktiviert sind.
Bis Java 8u150 müssen die Dateien local_policy.jar und US_export_policy.jar im Ordner %JRE_HOME%/lib/security ausgetauscht werden. Sie finden die Dateien für die unterschiedlichen Java-Versionen im mitgelieferten policy Verzeichnis.
Ab Java 8u151 liegen die benötigten Policy Dateien der Java Installation bei und müssen mit dem Security-Property crypto.policy=unlimited ausgewählt werden bevor das JCE-Framework initialisiert wird. Die signoPAD-API Java setzt dieses Property automatisch so früh wie möglich. Wenn aber die umschließende Anwendung das JCE-Framework verwendet und initialisiert, muss es sicherstellen, dass das Security-Property gesetzt ist:
java.security.Security.setProperty("crypto.policy", "unlimited");
Weitere Informationen finden Sie in den Java 8u151 Release Notes.
JPen Bibliothek
Bei Verwendung der PenDisplayFacade kann die Bibliothek JPen zur Kommunikation mit dem Gerät verwendet. JPen Projektseite: https://sourceforge.net/projects/jpen
JPen lädt abhängig vom System eine native Bibliothek mit JNI. (siehe auch JRE-Abhängigkeit). Der Ordner, aus dem JNI die nativen Bibliotheken lädt, kann mit dem System-Property java.library.path beim Start der Anwendung festgelegt werden.
Beispiel für den relativen Unterordner ‚lib‘:
> java -Djava.library.path=lib
Für die Erfassung mit dem Stift wird eine native Schnittstelle zum Pen Display benötigt, die i. d. R. in den Treibern des Herstellers enthalten ist. Unter Windows verwendet JPen bspw. die WinTab Schnittstelle. Für signotec Geräte sind alle benötigten Komponenten im Treiber „signotec Pen Display Manager“ enthalten.
JWinPointer Bibliothek
Bei Verwendung der PenDisplayFacade kann die Bibliothek JWinPointer zur Kommunikation mit dem Gerät verwendet werden. JWinPointer funktioniert im Gegensatz zu JPen nur unter Microsoft Windows, benötigt .NET 4.5 oder höher und verwendet die Systemeigene API zur Erfassung der Daten. Weiterhin unterstützt JWinPointer nur Java 1.8.
JWinPointer benötigt Schreibrechte im Temp-Ordner des Benutzers, um dort native Bibliotheken abzulegen. Der Ordner wird standardmäßig der Umgebungsvariable java.io.tmpdir entnommen. Ein benutzerdefinierter Ordner kann mit der Variable jwinpointer.library.path festgelegt werden.
> java -Djwinpointer.library.path=C:\Temp
Für die Erfassung mit dem Stift wird eine native Schnittstelle zum Pen Display benötigt, die i. d. R. in den Treibern des Herstellers enthalten ist. Für signotec Geräte sind alle benötigten Komponenten im Treiber „signotec Pen Display Manager“ enthalten.