Maven и библиотеки инструментов?
Я изучал Maven в свободное время в течение последних нескольких дней, но не могу понять, как организовать проект, чтобы использовать библиотеки JOGL. Я бы предпочел следующее:
- автоматическая загрузка, при необходимости, специфичного для ОС jogl zip-файла из здесь (содержит 4 файла jar и некоторые собственные файлы библиотеки (.so/.dll)); или зависит от проекта Maven, который является оболочкой одного из файлов.
- распаковать зип файл соответствующим образом, так что:
- файлы jar добавляются в путь к классам и развертываются по мере необходимости, и
- собственные файлы библиотеки добавляются в окончательный файл 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 вытащит все зависимости при следующей попытке построить проект.
имея дело с 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.