Logo

github Download
Java desktop installation

Installing JavaThemis for desktop development #

JavaThemis is available in the Maven Central repository. Additionally, Themis JNI library has to be installed in your system as well.

Themis JNI library is available as a system package for Linux and macOS. Usually you want to install the stable package to benefit from automatic dependency management and security updates. However, you can also build and install the latest version of JNI library from the source code as well.

Installing stable version on Linux #

The easiest way to install JavaThemis on Linux is to use package repositories for your system. Currently we build packages for a multitude of Linux distributions.

  1. Add Cossack Labs package repositories to your system.

  2. Install Themis JNI package.

    For Debian, Ubuntu:

    sudo apt install libthemis-jni

    For CentOS, RHEL:

    sudo yum install libthemis-jni

  3. Configure Gradle to use JavaThemis:

    repositories {
    mavenCentral()
}

dependencies {
    // Add JavaThemis as runtime dependency of your application.
    // Always pin the latest version, you can find it here:
    // https://search.maven.org/artifact/com.cossacklabs.com/java-themis
    implementation 'com.cossacklabs.com:java-themis:0.13.1'
}

    If you use other build tools (e.g., Ant, Maven, SBT, etc.), see Maven Central for configuration snippets.

  4. Locate Java library

By default, the themis.jni library might be installed into different location than Java expects them, for example, to /usr/lib/x86_64-linux-gnu/.... Some Java installations do not search this location, thus you will get an error message that library cannot be located.

You will need to either add it to the “java.library.path” property on application startup, or to move libthemis_jni.so manually to one of these locations so that Java could find it. For example, into /usr/lib/.

Once JavaThemis is installed, you can try out examples on your machine.

Installing stable version on macOS #

The easiest way to install ThemisPP on macOS is to use Homebrew.

  1. Add Cossack Labs tap to your system:

    brew tap cossacklabs/tap

  2. Install Themis JNI package:

    brew install libthemis --with-java

  3. Make sure Java can locate the JNI library.

    Java distributions for macOS typically do not include /usr/local/lib into their java.library.path. You will get a warning from Homebrew if that’s the case for your system:

    Your Java installation does not seem to have "/usr/local/lib" in its
search path for JNI libraries:

    /Users/your_name/Library/Java/Extensions
    /Library/Java/Extensions
    /Network/Library/Java/Extensions
    /System/Library/Java/Extensions
    /usr/lib/java
    .

You will need to either add it to the "java.library.path" property
on application startup, or to move libthemis_jni.dylib manually
to one of these locations so that Java could find it.

  4. Configure Gradle to use JavaThemis:

    repositories {
    mavenCentral()
}

dependencies {
    // Add JavaThemis as runtime dependency of your application.
    // Always pin the latest version, you can find it here:
    // https://search.maven.org/artifact/com.cossacklabs.com/java-themis
    implementation 'com.cossacklabs.com:java-themis:0.13.1'
}

    If you use other build tools (e.g., Ant, Maven, SBT, etc.), see Maven Central for configuration snippets.

Once JavaThemis is installed, you can try out examples on your machine.

Building latest version from source #

If the stable package version does not suit your needs, you can manually build and install the latest version of Themis from source code.

The build system requires Java 8 or later. You need to have JDK 8 (or later) installed and selected as your default JDK. You can learn more about how to get and install JDK in Oracle documentation.

Build JNI library with native code #

  1. Build and install Themis Core library into your system.

  2. In the same source tree, build and and then install the JNI library:

    make themis_jni
sudo make themis_jni_install

  3. Make sure Java can locate the JNI library.

    By default, the library will be installed with the /usr/local prefix. Some Java installations do not search this location. You will get a warning if that’s the case for your system:

    ```
Your Java installation does not seem to have "/usr/local/lib" in its
search path for JNI libraries:

    /usr/java/packages/lib
    /usr/lib/x86
```

    You will need to either add it to the “java.library.path” property on application startup, or to move libthemis_jni.so manually to one of these locations so that Java could find it.

Specifying JDK location #

To build JNI code for Java, the build system needs to know the location of the jni.h header. The build system should automatically detect it in most cases. If automatic detection fails, you can help it by setting the JAVA_HOME variable (the build will look into $JAVA_HOME/include).

On certain macOS systems you may need to specify the JDK location manually:

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.0.2.jdk/Contents/Home
export CFLAGS="-I$JAVA_HOME/include -I$JAVA_HOME/include/darwin"
make themis_jni

Build JAR with Java code #

Since Themis 0.13, JavaThemis uses Gradle build system. A Gradle wrapper is included in the root directory of the project so you do not have to install Gradle manually.

./gradlew :desktop:jar

The resulting JAR file java-themis-X.Y.Z.jar will be placed into src/wrappers/themis/java/build/libs. You then need to add it to your project.

See JavaThemis examples for illustration of how to integrate JavaThemis into your project.

Edit Edit this page