German English
German English

signoPAD-API Java - Systemvoraussetzungen

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 SignatureWidget

jpen.jar

jpen.dll

jpen-64.dll

libjpen.so

libjpen-x86_64.so

Nur bei Verwendung der

PenDisplayFacade

mit der Bibliothek

JPen

. Siehe auch Methode PenDisplayFacade.getInstance().

jni4net.j.jar

jwinpointer-se.jar

Nur bei Verwendung der PenDisplayFacade mit der Bibliothek JWinPointer.

Siehe Methode PenDisplayFacade.getInstance().

“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:

Bash
# libusb device nodes
SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0666"

Anschließend muss udev neugestartet werden:

Bash
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
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‘:

Bash
> 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.

Bash
> 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.