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

Question

Maven 新手，我试图使用 Maven 和 maven-shade-plugin 编译一个项目（因为它似乎是构建一个胖 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 文件”，这应该意味着它不可运行。

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

Answer 1

问题在于您对 Shade Plugin 的配置，该插件目前为

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

目标没有<archive>参数。您使用的配置元素不存在的事实并不是错误，配置将被忽略，这解释了为什么您的主类没有在 Manifest.xml 中设置。shade

要建立与阴影插件可执行的JAR，你需要提供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 将作为辅助工件附加到项目。它将与主 JAR 区分开来，其分类器为launcher，即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，而不是另一个，

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

作为旁注，两个 JAR 都将包含您在 中的资源<directory>src/main/java/resources</directory>，因为它们是项目本身的资源，正如使用<resource>元素声明的那样。但是，最好尊重标准目录布局并将资源放置在其中src/main/resources。