如何使用 Maven 创建 JarJar 工件，其中工件的使用不会拉动传递依赖项？

Question

我目前有一个 Java 测试库，它是用 Maven 构建的，并作为 jar 分发。我的项目依赖于一个非常常见的库（Objectweb ASM），并且我遇到过以下问题：早期且不兼容的 ASM 版本已位于类路径中。因此，我开始使用 jarjar-maven-plugin 创建 jar，重新打包ASM 内部不能与 ASM 的其他版本冲突。

这执行得很好，我的库可以作为依赖项引入，没有问题。

但是，由于我的项目对 ASM 具有编译范围依赖项，因此每当客户端项目添加我的库时，传递依赖项也会全部被拉入。因此，假设，如果他们使用特定版本的 ASM，并且他们还将我依赖的版本添加到类路径中，他们就会有未定义的行为。我想避免这种情况，并允许客户端依赖于 JarJar'd 工件，而不会让 Maven 不必要地和潜在地危险地拉下传递依赖项。

如何创建用户可以依赖的 JarJar 工件，而无需拉动传递依赖项？

Answer 1

我通过放弃 jarjar-maven-plugin 并恢复到 maven-shade-plugin 找到了这个问题的解决方案。这允许在您自己的命名空间中重新打包类，设置 jar 的主类，最重要的是，重写生成的 pom 以不包含现在捆绑的编译时依赖项。

我的 pom.xml 实现这一点的部分是：

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>1.4</version>
<executions>
    <execution>
        <phase>package</phase>
        <goals>
            <goal>shade</goal>
        </goals>
        <configuration>

            <shadedArtifactAttached>false</shadedArtifactAttached>
            <createDependencyReducedPom>true</createDependencyReducedPom>

            <relocations>
                <relocation>
                    <pattern>org.objectweb.asm</pattern>
                    <shadedPattern>${repackage.base}.org.objectweb.asm</shadedPattern>
                </relocation>
            </relocations>
            <transformers>
                <transformer
                    implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                    <mainClass>${package.base}.my.MainClass</mainClass>
                </transformer>
            </transformers>
        </configuration>
    </execution>
</executions>

此配置的重要部分是：

• shadedArtifactAttached，当设置为 false 时，意味着着色 jar 将替换通常生成的主要工件。默认为 false，但值得指出。
• createDependencyReducedPom 当设置为 true 时，意味着当部署或安装阴影 jar 时，部署的 pom.xml 将不包含已重新打包到 jar 中的编译范围依赖项。
• relocation 这些元素配置如何将依赖项中的文件重新打包到阴影 jar 中。在上面的示例中，任何规范名称以 org.objectweb.asm 开头的类都将被移动到 ${package.base}.org.objectweb.asm ，因此当打包在 jar 中将在 jar 内具有等效的文件路径。

使用此配置，当部署我的项目时，当客户端声明对我的项目的编译范围依赖项时，它只会引入阴影 jar，而不会引入传递依赖项。

Answer 2

考虑尝试使用 maven-shade-plugin，它允许各种精细控制。

Answer 3

也许设置 属性适合您的情况。在您的 java 测试库 pom.xml 中指定类似以下内容：

  <dependencies>
    <dependency>
      <groupId>asm.group</groupId>
      <artifactId>asm</artifactId>
      <version>x.y</version>
      <optional>true</optional>
    </dependency>
    ...
  </dependencies>