java - Maven:使用指定主类和属性文件的 shade-plugin 编译项目

Question

Maven 的新手，我尝试使用 Maven 和 maven-shade-plugin 编译一个项目(因为它似乎是构建 fat jar 的最佳插件)。我试图指定我的主类来制作一个可运行的 jar 文件和一些包含翻译字符串的 .properties 文件。

根据 netbeans 的输出，编译和构建似乎已通过，但我无法按如下方式运行它(假设 Maven 构建的 jar 重命名为“程序”):

/usr/bin/java -cp program.jar bot.Main
> could not find or load main class bot.Main

这是我的项目文件结构:

这是我的 pom.xml 文件:

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.mycompany</groupId>
<artifactId>mavenproject1</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<build>
    <resources>
    <resource>
        <directory>src/main/java/resources</directory>
        <includes>
            <include>**/*.properties</include>
        </includes>
    </resource>
</resources>
<plugins>

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>2.4.3</version>
    <configuration>
      <archive>
      <manifest>
        <addClasspath>true</addClasspath>
        <classpathPrefix>lib/</classpathPrefix>
        <mainClass>bot.Main</mainClass>
      </manifest>
    </archive>
    <shadedArtifactAttached>true</shadedArtifactAttached>
    <shadedClassifierName>launcher</shadedClassifierName>
    </configuration>
    <executions>
      <execution>
        <phase>package</phase>
        <goals>
          <goal>shade</goal>
        </goals>
      </execution>
    </executions>
  </plugin>

  <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>exec-maven-plugin</artifactId>
      <version>1.2.1</version>
      <executions>
          <execution>
              <goals>
                  <goal>java</goal>
              </goals>
          </execution>
      </executions>
      <configuration>
          <mainClass>bot.Main</mainClass>
      </configuration>
  </plugin>

</plugins>
</build>
<dependencies>
    <dependency>
        <groupId>org.telegram</groupId>
        <artifactId>telegrambots</artifactId>
        <version>2.4.0</version>
        <classifier>jar-with-dependencies</classifier>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
        <version>3.5</version>
    </dependency>
</dependencies>
<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>
</project>

资源是否正确包含？为什么我不能在不指定主类的情况下使用 java -jar 命令运行我的程序？它说我“无效或损坏的 jar 文件”，这应该意味着它不可运行。

另外，为什么不开始指定主类路径？

Answer 1

问题出在您当前的 Shade 插件配置上

<configuration>
  <archive>
    <manifest>
      <addClasspath>true</addClasspath>
      <classpathPrefix>lib/</classpathPrefix>
      <mainClass>bot.Main</mainClass>
    </manifest>
  </archive>
  <shadedArtifactAttached>true</shadedArtifactAttached>
  <shadedClassifierName>launcher</shadedClassifierName>
</configuration>

没有<archive> shade goal 的参数.事实上，您正在使用一个不存在的配置元素 is not an error ，配置将被忽略，这解释了为什么您的主类没有在 list 中设置。

要使用 Shade 插件构建可执行 JAR，您需要 to provide the ManifestResourceTransformer 作为 transformers .正确的配置是:

<configuration>
  <transformers>
    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
      <mainClass>bot.Main</mainClass>
    </transformer>
  </transformers>
  <shadedArtifactAttached>true</shadedArtifactAttached>
  <shadedClassifierName>launcher</shadedClassifierName>
</configuration>

请注意，使用此配置，阴影 JAR 不会替换主 JAR。 shadedArtifactAttached 设置为 true ，这意味着阴影 JAR 将作为辅助 Artifact 附加到项目。它将通过 launcher 的分类器与主 JAR 区分开来，即 shadedClassifierName 参数。

运行后mvn clean package在这个项目上，您将创建 2 个 JAR:

• mavenproject1-1.0-SNAPSHOT.jar ，这是主要的 JAR。此 JAR 仅包含应用程序的已编译 Java 源代码。它不是可执行的，也不包含所有依赖项的类。
• mavenproject1-1.0-SNAPSHOT-launcher.jar是阴影附加的 JAR，它是由 Shade 插件构建的。这个是可执行的，包含依赖项的类。

这意味着如果您想将应用程序作为可执行 JAR 启动，则必须启动 -launcher.jar ，而不是另一个，与

java -jar mavenproject1-1.0-SNAPSHOT-launcher.jar

---

作为旁注，两个 JAR 都将包含您在 <directory>src/main/java/resources</directory> 中的资源，因为它们是项目本身的资源，如 <resource> 声明的那样元素。但是，最好尊重 standard directory layout并将资源放在 src/main/resources 中相反。