Java: Как создать автономные дистрибутивы проектов на основе Maven?

Question

Я часто сталкиваюсь с дистрибутивами Java-приложений или библиотек, которые используйте Maven в качестве инструмента для сборки.

К сожалению, некоторые из них не предоставляют автономных (или распространяемых) банок.

Можно ли создавать приложения на основе Maven таким образом, чтобы результат сборки содержит все зависимости и может быть перераспределен для работы "из коробки"?

Я пытался собрать модуль OCM Джекраббита. По некоторым очень «умным» причинам нет отдельного загружаемого версия.
Итак, я построил Jackrabbit с Maven (исходный пакет Jackrabbit включает в себя OCM) и получил тот же самый jar-файл, что и в apache-репозитории . Кувшин не содержит необходимые зависимости и для меня бесполезен .

Answer 1

Используйте плагин Maven Shade

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

Также будьте предельно осторожны с настройкой плагина Shade. Я случайно использовал двойные теги <configuration> один раз, и трансформаторы вообще не применялись, и плагин позволил мне не предупреждать меня.

Не использовать плагин Maven Assembly

assembly:single распакует ваши JAR-файлы зависимостей как есть, и это не может быть тем, что вы хотите. Например. такие вещи, как META-INF/spring.schemas будут переопределены с последним JAR-файлом зависимости Spring, который был оценен, и поэтому ваши XSD не будут найдены (кроме тех, что в последнем JAR, конечно) Вот почему такие системы, как Alfresco, создали свой плагин AMP, который связывает зависимости внутри lib/ внутри создаваемого вами AMP. Последнее, однако, поднимает проблемы управления зависимостями.

Answer 2

Как сказал Доминик, использование плагина сборки поможет. Обычно вы настраиваете его в POM вашего собственного проекта, чтобы собрать и упаковать все необходимые зависимости:

  ...
  <plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
      <descriptorRefs>
        <descriptorRef>jar-with-dependencies</descriptorRef>
      </descriptorRefs>
    </configuration>
  </plugin>
  ...

jar-with-dependencies предопределено плагином сборки и будет включать все зависимости в окончательном пакете (см. Документацию здесь ).

Если вы не хотите использовать Maven для своего собственного проекта, вам необходимо изменить POM библиотек и упаковать их самостоятельно (скачайте исходные коды, добавьте приведенный выше фрагмент в pom.xml и запустите mvn package). Остерегайтесь дублирующихся или несовместимых транзитивных зависимостей, если вы используете несколько библиотек. exclusions может помочь в этом случае (см. Документацию здесь ).

Answer 3

Вам может повезти с плагином appassembler . В противном случае взгляните на сборочный плагин . Это более гибкий, но более низкий уровень. Если вы используете сборочный плагин, вы можете найти главу о нем в maven: полное руководство будет полезным.

Answer 4

Как было сказано в нескольких постерах, плагин сборки - хороший способ создания полного jar-файла со всеми зависимостями проекта. Однако вам на самом деле не нужно изменять файл pom.xml . Просто запустите:

mvn assembly:single -DdescriptorId=jar-with-dependencies

... чтобы создать файл jar. Если вы хотите сделать что-то более сложное, вам, вероятно, следует изменить pom.xml и создать собственный дескриптор сборки.

Answer 5

Я считаю, что Maven Shade Plugin удовлетворит ваши потребности. Я использую его при создании инструментов интерфейса командной строки для создания Uber JAR, включая мои классы и классы из всех моих зависимостей.

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

Answer 6

Измените файл pom.xml и используйте директиву <Embed-Dependency>. Подобный пример можно найти здесь , чтобы вы могли адаптировать его к своему сценарию.

<Embed-Dependency>*;scope=!test;inline=true</Embed-Dependency>

Я думаю, что это должно сработать.

---

Вот пример по приведенному выше URL, который, кажется, дает время ожидания.

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>br.gov.lexml</groupId>
    <artifactId>toolkit</artifactId>
    <packaging>bundle</packaging>
    <version>3.0</version>
    <parent>
        <artifactId>lexml</artifactId>
        <groupId>br.gov.lexml</groupId>
        <version>1.0</version>
    </parent>
    <build>
        <finalName>Lexml_Toolkit-2.0</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.5</source>
                    <target>1.5</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.felix</groupId>
                <artifactId>maven-bundle-plugin</artifactId>
                <extensions>true</extensions>
                <configuration>
                    <instructions>
                        <!--_include>src/toolkit/resources/META-INF/MANIFEST.MF</_include-->

                        <Export-Package>*;-split-package:=merge-last</Export-Package>
                        <Bundle-Activator>br.gov.lexml.borda.Toolkit</Bundle-Activator>
                        <Bundle-Name>Toolkit</Bundle-Name>
                        <Private-Package />
                        <Embed-Dependency>*;scope=!test;inline=true</Embed-Dependency>
                        <Bundle-ClassPath>.,{maven-dependencies}</Bundle-ClassPath>
                    </instructions>
                </configuration>
            </plugin>
        </plugins>
    </build>
    <dependencies>
        <dependency>
            <groupId>org.apache.xmlbeans</groupId>
            <artifactId>xmlbeans</artifactId>
            <version>2.4.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.xmlbeans</groupId>
            <artifactId>xmlbeans-xmlpublic</artifactId>
            <version>2.4.0</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.15</version>
        </dependency>
        <dependency>
            <groupId>br.gov.lexmlbeans</groupId>
            <artifactId>lexmlbeans</artifactId>
            <version>3.0</version>
        </dependency>
    </dependencies>
</project>