Maven и библиотеки инструментов?

Я изучал Maven в свободное время в течение последних нескольких дней, но не могу понять, как организовать проект, чтобы использовать библиотеки JOGL. Я бы предпочел следующее:

  1. автоматическая загрузка, при необходимости, специфичного для ОС jogl zip-файла из здесь (содержит 4 файла jar и некоторые собственные файлы библиотеки (.so/.dll)); или зависит от проекта Maven, который является оболочкой одного из файлов.
  2. распаковать зип файл соответствующим образом, так что:
    1. файлы jar добавляются в путь к классам и развертываются по мере необходимости, и
    2. собственные файлы библиотеки добавляются в окончательный файл jar (позволит ли это автоматически использовать их, или мне нужно что-то более активное?)

Я думаю, что часть моей проблемы заключается в том, что я не полностью понимаю использование JOGL, где разместить собственные библиотеки при запуске кода и т. д. Мне нужно вернуться в основы и написать JOGL Привет мир, скомпилировать его из командной строки и запустить его из командной строки, чтобы увидеть, что именно требуется, насколько размещение каталогов собственных библиотек; я могу пойти сделать это прямо сейчас, на самом деле.

с пунктом 1 я нашел некоторые особенности ОС; профили Maven могут быть активированы на основе свойств системы, которые включают операционную систему. Итак, я мог бы активировать профиль Windows, который имеет зависимость от специфичного для Windows JOGL библиотека, то же самое для Linux, и оба имеют 64-битное альтер-эго. (Активация официальные документы / неофициальные документы.)

Я попытался создать репозиторий Maven на основе файла jogl jar, а затем добавить проект jogl jar file в качестве зависимости от моего проекта; зависимость загружается, но не используется. Я понятия не имею, куда идет файл jar или как его использовать, распаковывать и т. д. вот команда, которую я использовал.

Так, короче: JOGL состоит из четырех .файлы jar и некоторые собственные библиотеки. Как я могу интегрировать эти файлы в свой проект Maven, чтобы я мог написать приложение JOGL с Maven, обрабатывающим мой процесс сборки? кроме того, как я могу использовать другой набор файлов в зависимости от операционной системы, потому что, конечно, собственные библиотеки и даже .файлы jar отличаются между Windows, Linux и Mac.

7 ответов


Jogamp теперь содержит поддержку Maven, для компонентов jogl (поддержка jocl и joal ожидается). Начиная с 2.0-rc11 пакеты перемещаются в Maven Central.

просто поместите это в свой pom:

 <dependencies>
   <dependency>
     <groupId>org.jogamp.gluegen</groupId>
     <artifactId>gluegen-rt-main</artifactId>
     <version>2.0-rc11</version>
   </dependency>
   <dependency>
     <groupId>org.jogamp.jogl</groupId>
     <artifactId>jogl-all-main</artifactId>
     <version>2.0-rc11</version>
   </dependency>
 </dependencies>

Maven вытащит все зависимости при следующей попытке построить проект.

Подробнее читайте здесь на wiki


имея дело с JNI и Maven,проекты с JNI и ссылка следует начать с. Он охватывает гораздо больше, чем ваша текущая проблема (которая "просто" использует библиотеку, которая полагается на JNI и собственные библиотеки), но, ну, тот, кто может сделать больше, может сделать меньше.

если вы внимательно прочтете его, вы увидите, что одним из решений для использования библиотек JNI является их связывание в специфичных для архитектуры банках, чтобы вы могли зависеть от них, как и от любого другого зависимость с точки зрения Maven. Это на самом деле, как jogl версии 1.1.1 упакован вhttp://download.java.net/maven/2/net/java/dev/jogl/, есть один артефакт JAR с классами Java и несколько архитектурных артефактов Jars с собственными библиотеками.

библиотека JNI архивируется в банке

решение, которое я использовал, было сохраните скомпилированную библиотеку jni в банку вместе с классом файлы.

это означает либо кросс-компиляции для все возможные архитектуры или более просто, имеющ Различный опарник для каждая архитектура. Это последнее подходит довольно хорошо с нашей установкой-где почти все наши машины Линукс-для i386, с поверхностным знанием с Win32 ящики.

к сожалению System.load() не могу справиться с загрузка библиотек из jar, поэтому нам понадобится заказ загрузчик, который извлекает библиотеки временный файл во время выполнения; Это однако, очевидно, достижимо.

затем, как объяснено, идея состоит в том, чтобы использовать пользовательский загрузчик библиотеки для загрузки собственной библиотеки. Хорошей новостью является то, что такой загрузчик "предоставляется", как описано ниже.

библиотека погрузчик

теперь у нас есть библиотека JNI на путь класса, поэтому нам нужен способ его загрузки. Я создал отдельный проект, который будет извлекать JNI библиотеки из пути к классу, затем загружать их. Найти ее на http://opensource.mxtelecom.com/maven/repo/com/wapmx/native/mx-native-loader/1.2/. Это добавляется как зависимость к пом, очевидно.

чтобы использовать его, позвоните com.wapmx.nativeutils.jniloader.NativeLoader.loadLibrary(libname). Дополнительная информация находится в javadoc для NativeLoader.

Я вообще предпочитаю заворачивать такие вещи в блоке try / catch, следующим образом:

public class Sqrt {
    static {
        try {
            NativeLoader.loadLibrary("sqrt");
        } catch (Throwable e) {
            e.printStackTrace();
            System.exit(1);
        }
    }
    /* ... class body ... */
}

теперь мы должны быть в точке, где наши тесты junit работают от maven; mvn тест должен работать! Он также должны работать отлично от IDE.

теперь, чтобы ответить на ваши вопросы, как:

автоматически загружать, если необходимо, специфичный для ОС jogl zip-файл отсюда (содержит 4 файла jar и некоторые собственные файлы библиотеки (.so/.dll)); или зависит от проекта Maven, который является оболочкой одного из файлов.

к сожалению, банки JOGL 2.0 недоступны в репозитории Maven java.net так что вам придется иметь дело с этим и либо сделать они доступны в частном репозитории или устанавливаются вручную в локальном репозитории каждого разработчика. Для этого используйте mvn install:install-file как описано в руководство по установке сторонних банок (а не mvn deploy:deploy-file как и вы, эта цель используется для установки артефактов в удаленный репозиторий).

лично я бы загрузил Jogl 2.0 ZIPs из URL-адресом вы предоставили, упакуйте его, как они сделали с JOGL 1.1.1 (один java JAR и несколько конкретных банок для native библиотеки) и установить банки в каждом локальном репозитории на данный момент. Затем объявите стандартную зависимость от артефакта Java и, действительно, используйте профили для конкретной зависимости архитектуры. Что-то вроде этого:--13-->

<project>
  ...
  <dependencies> 
    <dependency>
      <groupId>net.java.dev.jogl</groupId>
      <artifactId>jogl</artifactId>
      <version>2.0-beta10</version>
    </dependency>
    ...
  </dependencies>
  ...
  <profiles>
    <profile>
      <id>linux-i586</id>
      <activation>
        <os>
          <arch>i386</arch>
          <family>unix</family>
          <name>linux</name>
        </os>
      </activation>
      <dependencies>
        <dependency>
          <groupId>net.java.dev.jogl.jogl-linux-i586</groupId>
          <artifactId>jogl-linux-i586</artifactId>
          <version>2.0-beta10</version>
        </dependency>
      </dependencies>
    </profile>
    ...
  </profiles>
  ...
</project>

Не забудьте добавить репозиторий, необходимый для пользовательского загрузчика библиотек, и зависимость:

<project>
  <repositories>
    <repository>
      <id>opensource.mxtelecom.com</id>
      <url>http://opensource.mxtelecom.com/maven/repo</url>
    </repository>
    ...
  <repositories>
  ...
  <dependencies> 
    <dependency>
      <groupId>com.wapmx.native</groupId>
      <artifactId>mx-native-loader</artifactId>
      <version>1.2</version>
    </dependency>
    ...
  </dependencies>
  ...
</project>

относительно второй части вашего вопроса:

распакуйте этот zip-файл соответствующим образом, чтобы (...)

как я уже объяснял, вы на самом деле не будете зависеть от ZIP-файлов, а от банок, и вам не нужно будет распаковывать их ни во время разработки, ни для распространения вашего проекта. Для дистрибутива вам просто нужно создать jar, включая зависимости. Это можно сделать с помощью Maven-assembly-plugin. См.ответ например для более подробной информации по этому.


здесь есть РЕПО maven для JOGL 2.0:http://jogamp.org/deployment/maven/

Я использую SBT для создания своих проектов. Решатель, который нужно добавить в build.sbt:

resolvers += MavenRepository("jogamp", "http://jogamp.org/deployment/maven")

и зависимость, например, для базовой библиотеки jogl:

libraryDependencies += "org.jogamp.jogl" % "jogl-all" % "2.0-rc9"

в xml-файлах maven это будет что-то вроде (согласно этой):

 <settings>
   <profiles>
     <profile>
       <id>jogamp</id>
       <activation>
         <activeByDefault>true</activeByDefault> 
       </activation>
       <repositories>
         <repository>
           <id>jogamp-remote</id>
           <name>jogamp test mirror</name>
           <url>http://www.jogamp.org/deployment/maven/</url>
           <layout>default</layout>
         </repository>
       </repositories>
     </profile>
   </profiles>
 </settings>

с зависимостью, объявленной как:

<dependency>
  <groupId>org.jogamp.jogl</groupId>
  <artifactId>jogl-all</artifactId>
  <version>2.0-rc9</version>
</dependency>

для автоматической загрузки правильная родная банка, в sbt я делаю что-то вроде:

sys.props("os.name") match {
  case "Linux" => "org.jogamp.jogl" % "jogl-all-natives-linux-i586" % "2.0-rc9"
  ... etc. ...

Я не знаю библиотеку JOGL, но у меня есть опыт работы с Java3d, который имеет те же проблемы с установкой/сборкой. Есть два способа достичь этого:--2-->

  • скажите разработчикам установить JOGL без посторонней помощи, а затем рассматривать библиотеки JOGL как системные зависимости, как мы делаем с Java3d

    <dependency>
        <groupId>javax.java3d</groupId>
        <artifactId>j3dcore</artifactId>
        <version>1.5.1</version>
        <scope>system</scope>
        <systemPath>${java.home}/lib/ext/j3dcore.jar</systemPath>
    </dependency>
    
  • поместите все банки и системные зависимые библиотеки в собственный репозиторий и создайте для них подходящие poms

Если вы сильно хотите автоматизировать с Maven установку JOGL вы можете попробовать использовать maven-antrun-plugin или создать собственный плагин Maven, который обрабатывает установку (хорошим примером является груз который загружает серверы и распаковывает его).

Я считаю, что использовать первый вариант-сказать разработчикам установить JOGL. В нашем случае приложение Java3d распространяется Java WebStart, поэтому для них установка Java3d полностью автоматизирована WebStart.


здесь, для справки, является частью моей сборки Ant.xml-файл, который загружает и распаковывает библиотеку JOGL (2.0 beta 10).

<target name="libraries" depends="libraries.jogl" />

<target name="libraries.jogl.check">
    <condition property="libraries.jogl.exists">
        <available file="lib/jogl" />
    </condition>
</target>

<target name="libraries.jogl" depends="libraries.jogl.check" unless="libraries.jogl.exists">
    <condition property="joglostype" value="windows-i586">
        <and>
            <os family="windows" />
            <or>
                <os arch="i386" />
                <os arch="x86" />
            </or>
        </and>
    </condition>
    <condition property="joglostype" value="windows-amd64">
        <and>
            <os family="windows" />
            <os arch="amd64" />
        </and>
    </condition>
    <condition property="joglostype" value="linux-i586">
        <and>
            <os name="Linux" />
            <or>
                <os arch="i386" />
                <os arch="x86" />
            </or>
        </and>
    </condition>
    <condition property="joglostype" value="linux-amd64">
        <and>
            <os name="Linux" />
            <or>
                <os arch="AMD64" />
                <os arch="x86_64" />
            </or>
        </and>
    </condition>
    <echo>Detected operating system: ${joglostype}</echo>
    <echo>(if invalid OS, update ant build file)</echo>

    <mkdir dir="lib" />
    <get src="http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/jogl-2.0-${joglostype}.zip" dest="lib/jogl.zip" usetimestamp="true" />

    <mkdir dir="lib/jogl" />
    <unzip src="lib/jogl.zip" dest="lib/jogl">
        <patternset>
            <include name="**/gluegen-rt.jar" />
            <include name="**/jogl.all.jar" />
            <include name="**/nativewindow.all.jar" />
            <include name="**/newt.all.jar" />
            <include name="**/*.so" />
            <include name="**/*.dll" />
        </patternset>
        <mapper type="flatten" />
    </unzip>
</target>

этот скрипт загрузит выпуск из URL-адреса и установит его в локальный (именованный) репозиторий. https://gist.github.com/1624599

пример использования: ./install_jogl_maven http://jogamp.org/deployment/v2.0-rc5 path_to_local_repo 2.0-rc5


нет простого способа сделать это. Попробуйте настроить maven-assembly-plugin чтобы создать исполняемый файл jar и упаковать правильные файлы с вашим кодом. Вы не можете использовать управление зависимостями maven для достижения этого, потому что вам нужно содержимое ZIP, а не сам ZIP. Вы можете попробовать Maven-ant-plugin.