Java：如何构建基于 Maven 的项目的独立发行版？

Question

我经常遇到 Java 应用程序或库的发行版 使用 Maven 作为他们的构建工具。

遗憾的是，其中一些不提供独立（或可再发行）的 jar。

是否可以通过这种方式构建基于 Maven 的应用程序： 构建结果包含所有依赖项并且可以重新分发以开箱即用吗？

我尝试构建 Jackrabbit 的 OCM 模块。 由于一些非常“聪明”的原因，没有可下载的独立版本 版本。
于是我用Maven构建了Jackrabbit（Jackrabbit的源码包包括 OCM），并获得与 apache 存储库。 该 jar 不包含必要的依赖项，对我来说无用。

Answer 1

正如多米尼克所说，使用程序集插件就可以解决问题。 您通常会在自己的项目的 POM 中对其进行配置，以收集并打包所有必需的依赖项：

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

jar-with-dependencies 由程序集插件预定义，并将在最终包中包含所有依赖项（请参阅文档< a href="http://maven.apache.org/plugins/maven-assemble-plugin/usage.html" rel="nofollow noreferrer">此处）。

如果您不想在自己的项目中使用 Maven，则需要自己修改库的 POM 并重新打包它们（下载源代码，将上述代码段添加到 pom.xml 并运行 mvn package）。 如果您使用多个库，请注意重复或不兼容的传递依赖项。 在这种情况下，排除可能会有所帮助（请参阅文档此处）。

Answer 2

使用 Maven Shade 插件

...但要小心陷阱（类似于我的答案中进一步描述的问题），它有 此处解释了一种解决方法。

另外，对 Shade 插件配置要格外小心。 我有一次不小心使用了双 标签，变压器根本不适用，而且插件也冒昧地没有警告我。

不要使用 Maven Assembly 插件

assembly:single 将按原样解压您的依赖 JAR，而这可能不是您想要的。 例如，像 META-INF/spring.schemas 这样的东西将被评估的最后一个 Spring 依赖 JAR 覆盖，因此您的 XSD 将不会被发现（当然，除了最后一个 JAR 中的 XSD） ）。 这就是为什么像 Alfresco 这样的系统制作了 AMP 插件，它将依赖项捆绑在您正在构建的 AMP 内的 lib/ 内。 不过，后者引发了依赖管理问题。

Answer 3

您可能会对appassembler 插件有一些运气。 如果做不到这一点，请查看程序集插件。 这更灵活，但级别较低。 如果您使用的是程序集插件，则可以在 maven：有用的权威指南。

Answer 4

正如几位发帖者所说，程序集插件是创建包含所有项目依赖项的完整 jar 文件的好方法。 但是，您实际上不必修改 pom.xml 文件。 只需运行：

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

... 即可创建 jar 文件。 如果您想做任何更高级的事情，您可能应该修改 pom.xml，并创建自定义程序集描述符。

Answer 5

更改 pom.xml 文件并使用 指令。 类似的示例可以在此处< /a> 这样您就可以根据您的情况进行调整。

<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>

Answer 6

我相信 Maven Shade 插件 会满足您的需求。 当我构建命令行界面工具来创建 Uber JAR（包括我的类以及所有依赖项中的类）时，我会使用它。

它非常容易使用，我认为这个 示例 是不言自明的。