是否可以创建一个“uber”jar，其中包含项目类和项目依赖项（作为jar）以及自定义清单文件？

Question

我正在尝试创建一个包含项目类及其包含依赖项的清单文件的可执行jar（使用maven），清单文件具有主类的条目和指向jar根目录中包含的依赖项的类路径条目;类似的东西：

Manifest File:

..... 
Main-Class：com.acme.MainClass 
Class-Path：dependecy1.jardependecy2.jar 
.....

Jar:

jar-root
|-- ....
|-- com/acme/../*.class
|-- dependecy1.jar
`-- dependecy2.jar

我正在使用maven-jar-plugin创建清单文件，并使用maven-shade-plugin创建“超级” jar，但是解压缩了依赖关系并将其作为类添加到我的jar中。

Answer 1

实际上，我没有检查它到底在maven-shade-plugin做什么（或任何其他插件），因为maven 2具有内置的所有功能来创建megajar或uberjar。你只需要使用带有预定义jar-with-dependencies描述符的maven-assembly-plugin即可。

只需将此代码段添加到你pom.xml的自定义清单中即可：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-assembly-plugin</artifactId>
  <configuration>
    <archive>
      <manifest>
        <mainClass>my.package.to.my.MainClass</mainClass>
      </manifest>
    </archive>
  </configuration>
</plugin>

然后以下命令将生成你的uberjar：

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

但是，同样，此描述符的默认行为是解压缩依赖项（例如maven-shade-plugin）。老实说，我不明白为什么会出现这个问题，但是，如果这不是你想要的，那么你可以使用自己的自定义程序集描述符。

为此，首先，创建src/assembly/uberjar.xml具有以下内容的程序集描述符：

<assembly>
  <id>uberjar</id>
  <formats>
    <format>jar</format>
  </formats>
  <includeBaseDirectory>false</includeBaseDirectory>
  <dependencySets>
    <dependencySet>
      <unpack>false</unpack>
      <scope>runtime</scope>
      <useProjectArtifact>false</useProjectArtifact>
    </dependencySet>
  </dependencySets>
  <fileSets>
    <fileSet>
      <directory>${project.build.outputDirectory}</directory>
      <outputDirectory>/</outputDirectory>
    </fileSet>
  </fileSets>
</assembly>

然后，配置maven-assembly-plugin以使用此描述符，并将依赖Class-Path项添加到清单的条目中：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-assembly-plugin</artifactId>
  <configuration>
    <descriptors> 
      <descriptor>src/assembly/uberjar.xml</descriptor>
    </descriptors>
    <archive>
      <manifest>
        <mainClass>my.package.to.my.MainClass</mainClass>
        <addClasspath>true</addClasspath>
      </manifest>
    </archive>
  </configuration>
  <!--
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>single</goal>
      </goals>
    </execution>
  </executions>
  -->
</plugin>

最终运行mvn assembly:assembly以生成你的uberjar。

（可选）取消注释executions元素以在package阶段上绑定程序集插件（并使程序集作为常规构建的一部分生成）。