maven管理的项目怎么打包

Maven 管理的项目如何打包

在使用 Maven 进行项目管理时，打包是最终的构建步骤之一，它会将项目及其依赖项组合成一个可执行的文件，如 JAR 或 WAR 文件。Maven 项目的打包过程主要通过配置 pom.xml 文件中的插件来实现，常见的打包方式包括使用 Maven Assembly 插件、Shade 插件以及 Spring Boot Maven 插件等。每种插件有其特定的功能，适用于不同的项目需求。本文将深入探讨如何使用这些插件来打包 Maven 项目。

一、MAVEN 项目打包的基本流程

编译源代码
在进行打包之前，首先需要确保项目的源代码已经正确编译。可以通过 mvn compile 命令来编译代码，Maven 会自动处理项目中的所有依赖，确保没有遗漏。
运行单元测试
编译完成后，Maven 会自动执行测试用例，确保项目的正确性。如果测试通过，可以继续进入打包阶段。
打包项目
使用 mvn package 命令进行打包，Maven 会根据 pom.xml 中的配置生成最终的构建结果，通常是 JAR 文件或 WAR 文件。不同类型的项目需要选择不同的打包方式。

二、MAVEN 项目打包的常见插件

1、使用 Maven Assembly 插件打包

Maven Assembly 插件 是一种非常灵活且功能强大的插件，通常用于将项目及其所有依赖项打包到一个 JAR 文件中。它特别适用于需要将所有库和资源打包在一起的场景，比如开发独立的 Java 应用程序。

配置步骤：

在 pom.xml 中配置 Maven Assembly 插件，并指定打包类型为 jar-with-dependencies，这样会将项目及所有依赖打包成一个包含所有必要文件的 JAR 文件。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
        <archive>
            <manifest>
                <mainClass>com.example.MainClass</mainClass>
            </manifest>
        </archive>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

核心步骤：

descriptorRef 配置为 jar-with-dependencies，指示插件将依赖项一起打包。
mainClass 配置为应用程序的入口类，以便打包后的 JAR 文件能够直接执行。

优点：

灵活性高，支持多种打包形式。
可以非常方便地将所有依赖项打包在一起。

缺点：

配置较为复杂，需要理解插件的各种选项(maven 打包详解-阿里云开发者社区)(Java项目打包: 使用Maven将依赖项打包到Jar文件的3种方法 – ByteZoneX社区)。

2、使用 Maven Shade 插件打包

Maven Shade 插件 是另一个常用的插件，它可以帮助开发者将所有项目依赖项打包到一个 JAR 文件中，同时避免依赖冲突。它的优势在于处理和合并资源文件，特别适合生成包含依赖项的 JAR 文件，常用于构建所谓的“uber-jar”。

配置步骤：

在 pom.xml 中配置 Maven Shade 插件，使用 shade 目标并指定主类。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>com.example.MainClass</mainClass>
                    </transformers>
                </configuration>
        </execution>
    </executions>
</plugin>

核心步骤：

使用 shade 目标来创建一个包含所有依赖的 JAR 文件。
配置 ManifestResourceTransformer 来指定应用的入口类。

优点：

适合解决依赖冲突问题。
配置简单，直接生成可执行的 JAR 文件(使用Maven打包Java项目的完整指南_java maven项目打包-CSDN博客)(Java项目打包: 使用Maven将依赖项打包到Jar文件的3种方法 – ByteZoneX社区)。

缺点：

不如 Maven Assembly 插件灵活，无法生成其他类型的打包文件。

3、Spring Boot Maven 插件打包

对于 Spring Boot 项目，使用 Spring Boot Maven 插件 是最推荐的选择。该插件会自动将项目打包成一个包含所有依赖项的可执行 JAR 文件（通常称为“fat JAR”），并支持运行时嵌入一个内嵌的 web 服务器（如 Tomcat）。

配置步骤：

在 pom.xml 中添加 Spring Boot Maven 插件，并执行 repackage 目标。

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>2.5.4</version>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>