Getting started with the emnify Java SDK

Installation

The emnify Java SDK is open source and the source code is available on GitHub.

To install the SDK, add the emnify dependency to your existing project and use build automation tools, like Maven or Gradle, or install it manually.

Prerequisites

Supported Java versions

• OpenJDK 8
• OpenJDK 11
• OracleJDK 8
• OracleJDK 11

TLS requirements

Refer to the SSL Report table for the supported Transport Layer Security (TLS) versions.

Install with Maven

Use the following dependency in your project to grab via Maven:

1
    <dependency>
2
        <groupId>com.emnify.sdk</groupId>
3
        <artifactId>emnify</artifactId>
4
        <version>SDK_VERSION</version>
5
    </dependency>

Replace SDK_VERSION with the version of the emnify Java SDK you’re using.

Install with Gradle

Use the following to add the emnify dependency to your project via Gradle:

1
    implementation group: "com.emnify.sdk", name: "emnify", version: "SDK_VERSION"

Replace SDK_VERSION with the version of the emnify Java SDK you’re using.

Install manually

If you want to compile it yourself, here’s how:

$
    git clone git@github.com:emnify/emnify-sdk-java.git
$
    cd emnify-sdk-java
$
    mvn install # Requires Maven

If you want to build your own .jar, execute the following from within the cloned directory:

$
  mvn package

Configuration

Environment variables

To store configuration settings, like an application token or a base URL, use environment variables instead of hardcoding them in your application. Here are some examples:

Explore more

If you’re new to IoT connectivity and emnify, start by learning some common terminology and concepts and explore some use cases that show what the SDK is capable of.

Also, see the API reference.