Maven：构建可运行的 jar，然后使用 maven-assembly-plugin 添加到 zip

Question

我有一个 maven 问题，应该很容易解决，但事实证明有点困难。

我有一个构建 jar 的项目，并且需要该 jar 才能执行 com.foo.bar.MainClass 类，但我需要能够将它与一些脚本及其依赖项一起部署，例如

some-product-1.0.0.zip
  bin/
    some-product.sh
  lib/
    some-product-1.0.0.jar
    dependency1.jar
    dependency2.jar

我可以很容易地制作这个结构。我的pom.xml 看起来像

<plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
        <archive>
            <manifest>
                <mainClass>com.foo.bar.MainClass</mainClass>
                <addClasspath>true</addClasspath>
            </manifest>
        </archive>
        <descriptors>
            <descriptor>assembly.xml</descriptor>
        </descriptors>
    </configuration>
</plugin>

而我的assembly.xml 是

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
    <id>bin</id>
    <formats>
        <format>zip</format>
    </formats>
    <files>
        <file>
            <source>src/main/scripts/some-product.sh</source>
            <outputDirectory>/bin</outputDirectory>
        </file>
    </files>
    <dependencySets>
        <dependencySet>
            <outputDirectory>/lib</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <scope>compile</scope>
        </dependencySet>
    </dependencySets>
</assembly>

而some-product.sh 看起来像

SCRIPTLOC=$( readlink -f $( dirname "${BASH_SOURCE[0]}" ) )
LIBS="$( dirname $SCRIPTLOC )/lib"
# builds a : joined list of all the jars in the lib directory
MYCLASSES=$(echo $LIBS/*.jar | tr ' ' ':')

java -cp "$CLASSPATH:$MYCLASSES" com.foo.bar.MainClass

但是当我运行脚本时得到的是

Exception in thread "main" java.lang.NoClassDefFoundError: com/foo/bar/MainClass
Cause by: java.lang.ClassNotFoundException com.foo.bar.MainClass
    at ...
Could not find the main class: com.foo.bar.MainClass.  Program will exit.

当我检查包含该类的 jar 时，清单只有

Manifest-Version: 1.0
Archiver-Version: Plexus Archiver
Created-By: Apache Maven
Built-By: <myname>
Build-Jdk: 1.6.0_27

告诉我它没有将主类添加到清单中。

我已经用谷歌搜索了这个问题很长一段时间没有运气，并且程序集插件网站上的示例很糟糕。如何让 maven 正确构建此 jar 并将其添加到 zip 中？

编辑：我的 pom 中确实需要 maven-jar-plugin，但我真正的问题是我使用的是 Cygwin，它预期的类路径分隔符是 ; 而不是 :。我的解决方案是编写一些代码来确定要使用哪个类路径分隔符，并且使用 jar 插件现在可以完美运行。

Answer 1

我看到的两件事是

1. classpath 设置不正确。

    SCRIPTLOC=$( readlink -f $( dirname "${BASH_SOURCE[0]}" ) )
   

   这里的 SCRIPTLOC 不是根目录。是<the_complete_path_from_root>/bin

    LIBS="$( dirname $SCRIPTLOC )/lib"
   

   这最终评估为<the_complete_path_from_root>/bin/lib

   稍后您将向其中添加 lib 文件夹，该文件夹实际上并不包含您的 jar。因此，要添加到类路径的正确路径是存在 jar 的 lib 文件夹，然后它将能够找到 com.foo.bar.MainClass。

2. 要将 Main 类添加到清单文件中，您需要将以下内容添加到 pom.xml 文件中。

   <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-jar-plugin</artifactId>
        <configuration>
          <archive>
            <manifest>
              <mainClass>com.someclass.Main</mainClass>
              <packageName>com.someclass</packageName>
            </manifest>
            <manifestEntries>
                 <mode>development</mode>
                 <url>${pom.url}</url>
             </manifestEntries>
           </archive>
         </configuration>
     </plugin>