How to configure your environment

When testing the HERE Data SDK for Java & Scala, you can use the following version numbers. Unless otherwise stated, version numbers higher than those recommended are more likely to work properly than version numbers lower than recommended.

Operating system requirements

Windows 10 or later
MAC OSX 10 or later
Linux (Ubuntu 20.04 or later)

Java 17

The HERE Data SDK for Java & Scala requires Java 17, To install Java JDK and JRE 17 (Java Development Kit and Java Runtime Environment), use your operating system’s package manager or binaries available from the OpenJDK project, Amazon, Oracle or another trusted JDK provider. We recommend installing Java version 17, as newer major releases of Java (for example, Java 21) may not be fully backwards compatible with all Workspace components.

After you have installed Java 17, set the JAVA_HOME environment variable to point to your installation directory. On Windows 10 for example, the value could be C:\Program Files\Java\jdk-17. To add the Java compiler, add %JAVA_HOME%\bin to your PATH environment variable.

To verify you have successfully installed the Java package, open a terminal and enter java -version. This command displays the current Java version number, for example, java version 17.0.x.

Maven 3.9.4 or later

To install Apache Maven 3.9.4, follow the instructions from the download and installation pages on the Apache Maven site.

After you install Maven 3.9.4, add your Maven installation directory to your Path environment variable. On Windows 10 for example, the value could be C:\Maven\apache-maven-3.9.4\bin.

To verify you have successfully installed Maven, open a terminal and enter mvn -v. This command displays the current Maven version number and other information; for example, Apache Maven 3.9.4.

Note

If dependency downloads are causing long Maven build times, configuring another repository connector such as the OkHttp Aether Connector may speed up the downloads. It can be enabled by creating a .mvn/extensions.xml file. For more information, see the Maven documentation.