08 Okt

Leap Motion Java SDK - Maven Installation

08 Oktober 2014 Zoltan Ruzman 4638

Abstract

Das Leap Motion Java SDK ist nicht im Maven Central Repository registriert. Dadurch kann Maven die einzelnen Abhängigkeiten nicht automatisch herunterladen. Aus diesem Grund ist es notwendig die Bibliotheken manuell bereitzustellen. Hierfür gibt es mehrere Möglichkeiten. Dieser Artikel ergänzt den Blogpost Leap Motion Java SDK - Installation, bei dem bereits eine programmtechnische Lösung aufgezeigt wurde, um native Bibliotheken zur Laufzeit einzubinden.

Vorbereitung

Leap Motion Treiber installieren
Kostenlos als Leap Motion Developer registrieren
Leap Motion Developer SDK für Windows, OS X und Linux downloaden
Folgende Verzeichnisstruktur anlegen und relevante Dateien kopieren:
1. project
  1. lib
    1. LeapMotion.jar (aus Win-LeapSDK/lib)
  2. native
    1. mac
      1. libLeap.dylib (aus Mac-LeapSDK/lib)
      2. libLeapJava.dylib (aus Mac-LeapSDK/lib)
    2. nux
      1. 32
        
        libLeap.so (aus Linux-LeapSDK/lib/x32)
        
        libLeapJava.so (aus Linux-LeapSDK/lib/x32)
      2. 64
        
        libLeap.so (aus Linux-LeapSDK/lib/x64)
        
        libLeapJava.so (aus Linux-LeapSDK/lib/x64)
    3. win
      1. 32
        
        libLeap.dll (aus Win-LeapSDK/lib/x32)
        
        libLeapJava.dll (aus Win-LeapSDK/lib/x32)
      2. 64
        
        libLeap.dll (aus Win-LeapSDK/lib/x64)
        
        libLeapJava.dll (aus Win-LeapSDK/lib/x64)

Maven - pom.xml

Sofern das Projekt nach dem obigen Muster eingerichtet ist, braucht es nur ein paar Zeilen in der pom.xml, um die LeapMotion.jar einzubinden:

<dependencies>
   <dependency>
      <groupId>com.leapmotion.leap</groupId>
      <artifactId>leapMotion</artifactId>
      <version>2.1.5</version>
      <scope>system</scope>
      <systemPath>${project.basedir}/lib/LeapJava-2.1.5.jar</systemPath>
   </dependency>
</dependencies>

Zum Testen und Laden der nativen Bibliothek ist noch ein Aufruf der NativeLibrary notwendig. Mit diesem Programm lässt sich die Konfiguration testen:

public class Main {
   public static void main(String[] args) {
      if (NativeLibrary.loadSystem("native")) {
         System.out.println("Libraries successful loaded.");
         // Leap Motion Projekt ...
      }
   }
}

Anmerkung

Nach heutigem Standpunkt sollte es laut der Leap Motion | SDK Terms and Conditions keine Probleme geben, wenn die Bibliotheken kostenlos auf GitHub etc. verteilt werden.