TML Messaging Suite  1.1.5
for Java
 All Classes Namespaces Functions Variables Groups Pages
Install libTML-java binary package

Currently the following libTML-java binary packages are tested:

Library dependencies

To use libTML-java binary package various libraries need to be present. Refer to the documentation of the particular library for installation.

If the target platform is Windows or OS-X, the libTML-java binary installer respectively disc image file contain these dependent libraries.

libTML-c

See Installation guide for libTML-c binary package.


Windows installer (32/64 bit)

The TML Messaging Suite Windows binary installer supports both, 32 bit and 64 bit Windows systems. Download and and launch it on your Windows target system. Follow the instructions.

Windows installation content

The installation destination folder contains

Furthermore the libtml-java dynamic link library files are installed into the system folder

Note: The Windows binary installer doesn't change the Windows path environment.

The libTML-java binary package installation is finished now. Continue reading chapter "JNI" of this documentation, building the Java archive (JAR).


Debian package dependencies

The libTML-java debian package depends on the libTML-c debian package.

Install the libTML-c debian package and the packages it depends on first.

libTML-java debian package

Download the libTML-java package onto your target system.

Install the package using shell command

sudo dpkg -i /PATH/TO/PACKAGE/PACKAGENAME.deb 

libTML-java debian package installation content

The libTML-java debian package installation contains

The libTML-java binary package installation is finished now. Continue reading chapter "JNI" of this documentation, building the Java archive (JAR).


OS-X Disk Image

OS-X installation content

The mounted TML Messaging Suite disk image file contains

System Integrity Protection - using OS X 10.11 (El Capitan)

If the System Integrity Protection is enabled (default on El Capitan), root is not permitted to copy to "/usr/lib".

To disable System Integrity Protection, you must boot to Recovery OS and run the csrutil(1) command from the Terminal.
See:Configuring System Integrity Protection.

After disabling System Integrity Protection on a machine, a reboot is required.

Copy shared library files

1) on the command shell out of "superuser mode":

cp /Volumes/libtml/usr/lib32/* /usr/lib

2) on the command shell out of "superuser mode":

cp /Volumes/libtml/usr/lib64/* /usr/lib

The libTML-java binary package installation is finished now. Continue reading chapter "JNI" of this documentation, building the Java archive (JAR).


freeBSD package dependencies

The libTML-java freeBSD package depends on the libTML-c freeBSD package.

Install the libTML-c freeBSD package and the packages it depends on first

libTML-java freeBSD package

Download the libTML-java freeBSD package onto your target system.

Install the package using shell command

pkg install /PATH/TO/PACKAGE/PACKAGENAME 

libTML-java freeBSD package installation content

The libTML-java freeBSD package installation contains

The libTML-java binary package installation is finished now. Continue reading chapter "JNI" of this documentation, building the Java archive (JAR).


JNI

The Java Native Interface consists of a "Java part" and a "C part":

The libTML-java binary package installs the "C part" of the JNI (native libraries):

The "java Part" of the JNI has to be build explicitly out of our JNI Java source files using the Java Development Kit (JDK).

The JNI source files

creating a JAR

Running a Java program using package of Java classes it is usual to bind them into a Java archive (JAR). If you don't already have a JDK, download and install it appropriately. Keep your platform (x86 or x64) in mind.

The following description is a way on how to build a Java Archive (JAR) out of our JNI Java sources.

Example on linux and OS-X platforms:

mkdir class
find . -name "*.java" > targetList.txt
javac -cp class -d class @targetList.txt
cd class
jar cf tmlSidex.jar com

Example on windows:

mkdir class
dir /s /B *.java > targetList.txt
javac -cp class -d class @targetList.txt
cd class
jar cf tmlSidex.jar com

If the pathname contains blanks, you have to edit the text file targetList.txt, set each line lines into quotes and replace backslashes to slashes before using the javac compiler.

Please read the documentation Introduction to libTML-java to get information of how to use the library.