How To Install JavaPOS-SPF-Test (Windows)

You need only the following files from the project root:

JavaPOS-SPF-Test.cmd
jpos.properties
jpos.xml
jar\JavaPOS-SPF-Test.jar

Even if the services you like to test uses JavaPOS-SPF, the following additional file from the JavaPOS-SPF project must be present in the jar folder:

JavaPOS-SPF.jar

As long as a single jar file for JavaPOS 1.16 is not available, the snapshot jar files for javapos-contracts, javapos-controls and javapos-config-loader must be present in the jar folder as well. See the JavaPOS-SPF wiki for details, downloads can be made from the corresponding sub-folders of https://oss.sonatype.org/content/repositories/snapshots/org/javapos/.

If the device you like to test uses COM ports for communication (no matter if real COM ports, via Usb2Serial or Bluetooth) via the specific JavaPOS-SPF interfaces, you need one of

SerialIOJNAWindows.jar,
SerialIOJSerialComm.jar or
SerialIOJSSC.jar (only if Java version < 9).

from the JavaPOS-SPF project and the corresponding jar files from project JNA (version ≥ 5.5, needed by SerialIOJNAWindows.jar), JSerialComm (version ≥ 2.6, needed by SerialIOJSerialComm.jar) or jSSC (version ≥ 2.7, needed by SerialIOJSSC.jar).
Currently, recommended for serial communication are SerialIOJSerialComm.jar in combination with jSerialComm-2.6.2.jar.

Since you like to test some device services, you need the corresponding jar files as well.

If you like to use one of the device simulators of JavaPOS-SPF, add the corresponding jar file as well.

In addition, you need the jar files from the following projects:

jpos (version 1.15),
log4j (version 1.2),
Log4pos (version 1.0.1)
xalan-j (version ≥ 2.7).

Here the steps for installation:

If not present: Install a Java runtime, recommended is a runtime version ≥ 9 and - if Java version ≥ 9 - JavaFX.
Set the environment variable JAVA_HOME to the folder where you installed the Java runtime.
Set the environment variable JFX_HOME to the folder where you installed JavaFX. If you use a JRE which includes JavaFX, JFX_HOME must not be set.
Copy JavaPOS-SPF-Test.cmd and jpos.xml to any target folder.
Create a sub-folder res in a sub-folder jpos in the target folder
Copy jpos.properties into that jpos\res sub-folder.
Create a sub-folder jar in the target folder.
Copy all necessary jar files into that jar sub-folder.
Add entries for the devices you like to test to jpos.xml in the target folder.

That's all! Start JavaPOS-SPF-Test.cmd to start your tests.

How To Install JavaPOS-SPF-Test (Linux)

The steps are similar to those for installation on Windows. You need only the following files from the project root:

JavaPOS-SPF-Test.sh
jpos.properties
jpos.xml
jar\JavaPOS-SPF-Test.jar

Even if the services you like to test uses JavaPOS-SPF, the following additional file from the JavaPOS-SPF project must be present in the jar folder:

JavaPOS-SPF.jar

And as long as JavaPOS 1.16 is not available, the following jar file from the JavaPOS-SPF project must be present in the jar folder as well:

Jpos116Dummy.jar

Keep in mind: When a JavaPOS version 1.16 becomes available, remove Jpos116Dummy.jar from the jar folder.

If the device you like to test uses COM ports for communication (no matter if real COM ports, via Usb2Serial or Bluetooth) via the specific JavaPOS-SPF interfaces, you need one of

SerialIOJNALinux.jar,
SerialIOJSerialComm.jar or
SerialIOJSSC.jar (only if Java version < 9).

from the JavaPOS-SPF project and the corresponding jar files from project JNA (version ≥ 5.5, needed by SerialIOJNALinux.jar), JSerialComm (version ≥ 2.6, needed by SerialIOJSerialComm.jar) or jSSC (version ≥ 2.7, needed by SerialIOJSSC.jar). if you use SerialIOJNALinux.jar, it can be necessary to create a property file de.gmxhome.conrad.JNALinux.JnaLinuxSerial.properties as well.
Currently, recommended for serial communication are jar\SerialIOJSerialComm.jar in combination with jSerialComm-2.6.2.jar.

Since you like to test some device services, you need the corresponding jar files as well.

If you like to use one of the device simulators of JavaPOS-SPF, add the corresponding jar file as well.

In addition, you need the jar files from the following projects:

jpos (version 1.14),
log4j (version 1.2),
Log4pos (version 1.0.1)
xalan (version 2.7).
xerces (version 2.7).

Here the steps for installation:

If not present: Install a Java runtime with version ≥ 9 and JavaFX.
Set the environment variable JAVA_HOME to the folder where you installed the Java runtime. This should be done automatically by the packet manager.
Set the environment variable JFX_HOME to the folder where you installed JavaFX. If you use a JRE which includes JavaFX, JFX_HOME must not be set.
Copy JavaPOS-SPF-Test.sh and jpos.xml to any target folder.
Create a sub-folder res in a sub-folder jpos in the target folder
Copy jpos.properties into that jpos/res sub-folder.
Create a sub-folder jar in the target folder.
Copy all necessary jar files into that jar sub-folder.
Add entries for the devices you like to test to jpos.xml in the target folder.

That's all! Start JavaPOS-SPF-Test.cmd to start your tests.

Where Are The Necessary Jar-Files?

You can get binary versions of a Java runtime environment at https://adoptopenjdk.net/archive.html?variant=openjdk11&jvmVariant=hotspot .
You can get binary versions of Java FX at https://gluonhq.com/products/javafx/. Keep in mind that OS and architecture must match the OS and architecture of the Java RE.
You can get binary versions of log4j 1.x at http://www.apache.org/dyn/closer.cgi/logging/log4j/1.2.17/log4j-1.2.17.zip.
You can get binary versions of xalan-j at https://archive.apache.org/dist/xml/xalan-j/binaries/xalan-j_2_7_1-bin.zip .
You can get a binary version of JavaPOS 1.15.1 at https://search.maven.org/search?q=org.javapos .
You can get binary versions of jSerialComm 2.6.x at https://fazecast.github.io/jSerialComm/ or a get binary versions of JNA 5.5.x at https://github.com/java-native-access/jna.