maven 本地打包

原创 已于 2024-06-07 07:45:13 修改 · 1.9k 阅读 · 29 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#maven #java

于 2024-06-06 23:51:50 首次发布

文章目录

1. 简介

Maven和POM的基本概念

Maven 是一个强大的构建工具，广泛用于 Java 项目的构建和管理。它不仅可以用于构建和打包，还可以用于依赖管理、项目文档生成、项目报告生成等。

POM（Project Object Model）是 Maven 的核心，它是一个 XML 文件，定义了项目的基本信息、构建规则、依赖关系等。通过 POM，我们可以简洁地描述出项目的构建过程。

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.mycompany.app</groupId>
  <artifactId>my-app</artifactId>
  <version>1.0-SNAPSHOT</version>
</project>

上面的 POM 文件定义了一个最简单的 Maven 项目，包括项目的组织信息、项目的唯一标识符和版本号。

本地打包的意义和场景

本地打包，即在本地环境中将项目打包成为一个可执行的文件（如 JAR、WAR 或 EAR 文件）。这个过程通常包括编译源代码、运行测试、生成文档和打包等步骤。

本地打包的主要场景包括：

  • 使用本地jar包：有一些jar包并没有在远程仓库里，比如公司私有的jar包，需要通过maven来管理打包

  • 在本地环境中测试和验证项目：通过本地打包，我们可以在本地环境中快速运行和测试项目，验证项目的功能和性能。

  • 为部署做准备：通过本地打包，我们可以生成可部署的文件，然后将这个文件部署到生产环境中。

  • 分享和分发项目：通过本地打包，我们可以生成一个包含了项目所有代码和资源的文件，方便分享和分发。

2. Maven POM 文件结构

POM 文件的基本结构

POM (Project Object Model) 文件是 Maven 项目的核心配置文件。它使用 XML 格式来描述项目的基本信息、依赖关系、构建配置等。下面是一个 POM 文件的基本结构：

<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.example</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <!-- dependencies go here -->
    </dependencies>

    <build>
        <!-- build configuration goes here -->
    </build>
</project>

重要的POM元素介绍

1. modelVersion: 这是 POM 模型的版本，当前版本为 4.0.0，这是一个固定的值。

2. groupId, artifactId, version (GAV): 这三个元素组合起来用于唯一地标识一个 Maven 项目：

  • groupId: 定义了当前 Maven 项目所属的组或者说是项目的唯一标识。通常是公司或组织的域名反写，如 com.example。

  • artifactId: 定义了当前 Maven 项目在组中的唯一名字。通常是项目的名字，如 my-app。

  • version: 定义了当前 Maven 项目的版本号。

3. dependencies: 这个元素用于定义项目的依赖关系。每一个依赖都是一个 dependency 元素，包含了依赖项目的 GAV 信息。

4. build: 这个元素用于定义项目的构建配置，例如源代码目录、目标代码目录、插件配置等。

3. Maven 本地打包的关键配置

在Maven的POM文件中，插件（plugins）扮演着非常重要的角色。插件提供了一种方式来扩展Maven的功能，包括编译、测试、打包等。下面我们将介绍几个用于本地打包的关键插件。

spring-boot-maven-plugin

spring-boot-maven-plugin是一个为Spring Boot应用提供的Maven插件。它的主要功能是将Spring Boot应用打包成一个可执行的JAR文件。这个JAR文件包含了所有的依赖、类和资源，并且它可以直接运行，不需要额外的服务器容器。

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

maven-surefire-plugin

Maven Surefire插件是Maven项目中一个非常重要的插件，它主要用于执行项目的单元测试，并生成相应的测试报告。它支持多种流行的测试框架，如JUnit，TestNG等。

当你运行mvn test命令时，Maven会自动执行项目中的单元测试，并通过Surefire插件生成测试报告。这是一个非常重要的步骤，因为它可以帮助你快速发现和修复代码中的问题。

如何配置和使用Maven Surefire插件

Maven Surefire插件的配置非常简单，你只需要在pom.xml文件的<plugins>标签中添加如下配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <configuration>
        <!-- 插件配置项 -->
    </configuration>
</plugin>

在<configuration>标签中，你可以添加一些配置项来定制插件的行为。例如，你可以通过<includes>和<excludes>标签来指定哪些测试类或测试方法应该被执行，哪些应该被忽略。

skip 标签

在Maven Surefire插件的配置中，<skip>标签用于控制是否跳过测试。如果你设置<skip>true</skip>，那么在执行mvn test命令时，Maven将不会执行任何测试，也就不会生成测试报告。

这个配置项在某些情况下非常有用。例如，当你正在进行开发，并且想要快速构建项目而不执行测试时，你可以设置<skip>true</skip>。然后，当你准备提交代码时，你可以将其设置回false，以确保所有的测试都被执行。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

在POM文件中，我们可以配置maven-surefire-plugin来指定测试框架、测试类、测试方法等。

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.22.2</version>
            <configuration>
                <!-- specify test classes -->
                <includes>
                    <include>**/*Test.java</include>
                </includes>
            </configuration>
        </plugin>
    </plugins>
</build>

maven-compiler-plugin

Maven Compiler插件的主要作用是编译项目的源代码。当你运行mvn compile命令时，Maven会自动执行项目中的源代码编译，并将编译后的.class文件放到target/classes目录下。

如何配置和使用Maven Compiler插件

Maven Compiler插件的配置相对简单，你只需要在pom.xml文件的<plugins>标签中添加如下配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <!-- 插件配置项 -->
    </configuration>
</plugin>

在<configuration>标签中，你可以添加一些配置项来定制插件的行为。例如，你可以通过<source>和<target>标签来指定Java的源代码和目标代码版本，通过<encoding>标签来指定源代码的编码格式。

source 和 target 标签

<source>和<target>标签用于指定Java的源代码和目标代码版本。在这里，<source>1.8</source>表示源代码是1.8版本的Java代码，<target>1.8</target>表示编译后的.class文件需要运行在1.8版本的Java环境中。

encoding 标签

<encoding>标签用于指定源代码的编码格式。在这里，<encoding>UTF-8</encoding>表示源代码是UTF-8编码的。

compilerArguments 标签

<compilerArguments>标签用于传递一些特定的编译器参数。在这个例子中，<extdirs>${project.basedir}/src/main/webapp/WEB-INF/lib</extdirs>配置了额外的类路径，这意味着编译器会在这个路径下查找类文件。

maven-war-plugin

Maven War插件的主要作用是将Web应用程序打包成一个WAR文件，这个WAR文件可以被部署到任何支持Java EE的Web服务器或应用服务器上，如Tomcat，Jetty，GlassFish等。当你运行mvn package或mvn install命令时，Maven会自动使用War插件将你的项目打包成WAR文件。

如何配置和使用Maven War插件

Maven War插件的配置也是在pom.xml文件的<plugins>标签中进行。一个基本的配置如下：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <configuration>
        <!-- 插件配置项 -->
    </configuration>
</plugin>

在<configuration>标签中，你可以添加一些配置项来定制插件的行为。例如，你可以通过<warName>标签来指定生成的WAR文件的名称，通过<webResources>标签来配置Web资源的处理方式。

resourceEncoding 标签

<resourceEncoding>标签用于指定Web资源文件的编码格式。在这里，<resourceEncoding>UTF-8</resourceEncoding>表示Web资源文件是UTF-8编码的。这是非常重要的，因为如果你的Web资源文件包含非ASCII字符（如中文），那么你需要确保它们被正确地编码和解码。

webResources 标签

<webResources>标签用于配置Web资源的处理方式。你可以在这个标签中指定一些资源目录，并定义这些资源目录的处理规则。例如，你可以指定某些资源目录下的文件需要经过过滤处理，或者指定某些资源文件需要被排除。

一个基本的<webResources>配置如下：

<webResources>
    <resource>
        <directory>src/main/webapp</directory>
        <filtering>true</filtering>
    </resource>
</webResources>

在这个配置中，我们指定了src/main/webapp目录作为Web资源目录，并开启了过滤功能。这意味着在构建过程中，Maven会对这个目录下的文件进行过滤处理，替换其中的占位符。

maven-war-plugin是用于生成WAR文件的Maven插件。WAR文件是一种Web应用程序归档文件，它包含了JSP、Servlet、XML、HTML、图片和其他Web资源。我们可以将WAR文件部署到任何支持Java的Web服务器或应用服务器上。

4.实战：POM本地打包

<plugins>
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
    </plugin>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <configuration>
            <skip>true</skip>
        </configuration>
    </plugin>
    <plugin>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
            <source>1.8</source>
            <target>1.8</target>
            <encoding>UTF-8</encoding>
            <!--配置本地jar包在项目的存放路径-->
            <compilerArguments>
                <extdirs>${project.basedir}/src/main/webapp/WEB-INF/lib</extdirs>
            </compilerArguments>
        </configuration>
    </plugin>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <configuration>
            <resourceEncoding>UTF-8</resourceEncoding>
            <webResources>
                <resource>
                    <!--配置本地jar包在项目中的存放路径-->
                    <directory>src/main/webapp/WEB-INF/lib/</directory>
                    <!--配置打包时jar包的存放路径-->
                    <targetPath>WEB-INF/lib</targetPath>
                    <includes>
                        <include>**/*.jar</include>
                    </includes>
                </resource>
            </webResources>
        </configuration>
    </plugin>
</plugins>

执行打包命令

一旦POM文件和插件配置完成，我们就可以执行Maven的打包命令了。在命令行中，我们可以运行以下命令来打包项目：

mvn clean package

这个命令将会清理之前的构建结果，然后编译、测试（如果没有被跳过的话）和打包项目。

验证打包结果

执行完打包命令后，我们可以在target目录下找到生成的JAR或WAR文件。我们可以检查这个文件来验证打包是否成功。例如，我们可以使用jar命令（对于JAR文件）或unzip命令（对于WAR文件）来查看文件的内容。

此外，如果我们在maven-compiler-plugin和maven-war-plugin的配置中指定了本地jar包的路径，我们也应该在打包结果中看到这些jar包。

进一步的学习资源

CC大煊
关注
【Maven】将本地项目打包、安装、引用
莱克博尔德的博客
06-20 1932
一、先构建一个简单Java项目 使用骨架创建Maven的Java工程 1.选择Create New Project按钮 2、选中左侧的Maven，并将Create from archetype选中，在下方选择骨架quickstart，点击Next。 3、填写项目的名称以及存储的位置。点击下方的Artifact Coordinates，填写项目坐标的基本信息。 4、确认信是否正确 5、生成的目录结构 6、手动将Maven文件夹补齐。 7、同样在test文件夹下创建resources文件夹，最后的目
maven本地打包依赖无法引用
format_push的博客
02-05 983
问题在于pom.xml文件，正常打包的maven文件应该可以显示出来，但是由于未删除spring-boot-maven-plugin。的打包和启动，它会将所有依赖合并到一个 JAR 文件中，并生成。手动输入对应的包显示找不到，但是在Maven可以找到。再重新执行mvn install即可成功引入。描述：写了一个RPC的starter包。，它不需要也不应该是。原来的pom.xml。移除后pom.xml。
maven本地打包
y525794266的博客
06-06 2883
mvninstall:install-file-Dfile=D:\alipay-sdk-0.0.3.jar-DgroupId=com.ceshi-DartifactId=alipay-pay-sdk-Dversion=0.0.1-Dpackaging=jar-DgeneratePom=true <dependency> <groupId>com.ce...
Maven 项目打包时添加本地 Jar 包
最新发布
博客
05-20 998
在Maven项目开发中，引入本地Jar包是常见需求，尤其是当依赖未发布到中央仓库或需要自定义版本时。本文详细介绍了如何通过Maven命令将本地Jar包安装到本地仓库，并在项目中正确引用。核心操作包括使用mvn install:install-file命令安装Jar包，指定文件路径、groupId、artifactId、version等参数，并在pom.xml中添加依赖配置。文章还提供了常见问题的解决方案，如路径错误、坐标冲突和环境变量配置问题，帮助开发者顺利完成本地Jar包的引入和使用。
MAVEN--本地jar打包
细心程度决定你的成败
08-17 545
Maven打包 在开发项目的时候，使用了第三方公司提供的jar包，只能引用器jar包。开发时候使用 &amp;lt;systemPath&amp;gt;${project.basedir}/lib/dcms-mq-client-1.0-SNAPSHOT.jar&amp;lt;/systemPath&amp;gt; 进行引用，当打包时候 不成功，因此需要更改为 &amp;lt;systemPath&amp;gt;${p...
maven打本地JAR包
m0_67401761的博客
08-20 472
在跑一个程序的时候，发现项目报错了，无法从maven仓库中下载一个JAR包，上网查找资料之后，发现原来这是一个第三方的jar包，没有上传到阿里云的maven仓库。所以找到这个第三方的jar包之后，打了一个本地的jar包。
maven打包本地资源
enthan809882的博客
06-11 249
直接上干货： <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <version>2.2</version> <configuration>
maven 本地包使用
windsummer的专栏
10-14 8019
采用Maven进行项目开发过程中，有的时候需要直接使用本地的包进行开发，以下是使用本地包的相关步骤及配置。将本地JAR包放到lib目录下将本地包放到WEB-INF文件夹lib目录下，这里以IKAnalyzer的包为例，如图所示： 依赖配置在pom中进行配置的区别在于scope作用域要设置成system,同时需要指定systemPath. <dependency> <g
【maven本地打包脚本】Git/Svn代码更新+maven打包流水线
qq_42442282的博客
11-25 1195
1.使用场景 因为现在项目组的项目未实现自动化发布，所以每次打包部署前各种问题频出，所以整了个简单的脚本，实现部署前的环境选择、代码更新、编译打包这三步骤。 因为部署启动需要到对应环境服务器的权限，还要考虑运行环境、代码拉取、代码更新、状态监测等，实现上还是蛮复杂的（研究这个不如直接研究Jenkins等自动化部署的配置使用）。 2.简单实现 版本1 win10环境下这类按步骤实行的流程，选择用.bat脚本实现，语言不用深究，用啥查啥看的懂就行（语言的本质是相通的），以下是我的打包脚本instal
记录一次 maven 项目打包本地jar包的问题
weixin_45642569的博客
01-28 538
将本地jar包安装到本地仓库里，使用maven打包插件，即可将本地jar包打包进项目的整体jar包内。引入springboot，比如当前工程有个lib目录，lib目录下有很多本地jar包。这种方式也可以将本地依赖打包进项目里。
idea本地jar，使用maven打包本地依赖，实现自动编译到项目里
努力的小方的博客
05-23 2507
首先，如果你的本地 jar 不在 Maven 中央仓库中，你需要将它安装到你的本地 Maven 仓库中。项目需要在代码里面嵌入海康威视sdk的jar,做第二次开发。执行 mvn 指令界面。
Maven仓库理解、如何引入本地包、Maven多种方式打可执行jar包
06-02
Maven仓库理解、如何引入本地包、Maven多种方式打可执行jar包
Maven引入本地Jar包并打包进War包中的方法
08-28
"Maven引入本地Jar包并打包进War包中的方法" Maven是一种流行的项目管理工具，主要用于Java项目的构建、测试和部署。在实际开发中，我们经常需要引入本地Jar包以满足项目的需求。本文将介绍Maven引入本地Jar包并...
Maven打包到本地库
qq_41980255的博客
07-13 297
1、准备需要打到本地仓库的包 2、任意位置打开bash控制台 3、执行下方命令 mvn install:install -file -Dfile="路径/文件名.jar" -DgroupId="com.lol(包名)" -DartifactId="yasuo(新的文件名)" -Dversion=1.0.0 -Dpackaging=jar ...
maven添加本地包
Good_Good_Study
10-20 379
maven添加本地包
maven工程打包 把本地jar包、远程jar包和工程代码打包成一个jar包
九二战歌的博客
05-07 5259
如标题所言，本篇博客讲解一下maven打包如何把依赖包和工程代码打成一个jar包并且可以正常使用（因为有些方式打出来虽然是一个jar包，但是运行时候找不到对应的依赖）。从上面打包后的jar包内部结构图可以看到方式2的结构和方式1差别还是很大的，方式2是把对应jar包的class都拷贝进去，这种方式可能会导致有些需要证书认证的jar包无法使用。
一键搞定！用Maven命令把本地JAR包装进Maven仓库
wcwmsj的博客
01-18 9505
在实际项目开发中，有些场景可能需要将本地的JAR包安装到本地仓库中，本文主要介绍了如何通过maven命令一键将本地jar安装到maven仓库的方法。
maven添加本地jar包
QWERTY55555的专栏
09-23 6009
本地jar包的真实路径，例如我的是： C:\Users\Administrator\Desktop\OrgPublic.jar。如，我需要安装一个本地的ApacheJMeter_core.jar文件，一共。首先，打开本地cmd窗口，按照一定规则将本地的jar包进行安装。)：下载到本地的OrgPublic.jar包的真实存放路径 -->：groupId 这个值，可以根据自己的需求来决定。：版本号，这个不用说了，根据需求自己来决定。点击java ，设置要应用的目录，点击ok。
Maven 导入本地包
理论都是虚的，代码才是王道。
12-04 1456
在Maven中，我们可以将本地的Java包导入到项目中，以便在其他模块中使用。本文将详细介绍如何在Maven中导入本地包，并提供一个详细的实例。这样，我们就可以在项目中使用本地MySQL驱动了。首先，我们需要创建一个本地的Maven项目。然后，我们可以像使用其他Maven依赖项一样使用这个本地依赖。最后，我们可以在项目中使用导入的本地依赖。，表示这是一个系统依赖项，而不是通过Maven仓库下载的依赖项。文件中添加了相应的依赖项，并指定了正确的路径即可。标签，指定本地包的路径。接下来，我们需要在项目的。
maven本地项目打包
03-21
<think>好的，我需要帮助用户了解如何使用Maven对本地项目进行打包，特别是使用mvn package命令。首先，我需要确认用户的需求是什么。他们可能有一个本地Maven项目，想要生成可执行的JAR或WAR文件。接下来，我得整理出步骤，并确保每个步骤都清晰易懂。 用户提供的引用内容中提到了一些关键点，比如默认执行test命令的问题，解决方法是通过配置maven-surefire-plugin来跳过测试。另外，引用中还提到了在Eclipse中使用Maven打包，以及如何通过命令行执行mvn package。这些信息需要整合到回答中。 首先，我应该列出使用mvn package的基本步骤，确保用户了解前提条件，比如安装Maven和正确配置pom.xml文件。然后，详细说明如何运行命令，可能遇到的问题比如测试失败，以及如何跳过测试。此外，用户可能需要知道如何在IDE中操作，比如Eclipse，所以需要包含相关步骤。 还要注意引用中的配置文件示例，正确展示如何跳过测试。同时，用户可能对输出文件的位置和类型有疑问，需要说明target目录下的生成文件。最后，生成相关问题，帮助用户深入理解，比如性能优化、跳过测试的其他方法，以及处理依赖问题。 需要确保回答结构清晰，分步骤说明，引用正确的信息源，并在适当的位置添加引用标识。同时，语言要简洁明了，避免技术术语过于复杂，让新手也能理解。检查是否有遗漏的步骤，比如项目结构是否符合Maven标准，是否需要先执行clean等。最后，验证提供的命令和配置是否正确，避免误导用户。</think>### 如何使用Maven对本地项目进行打包 以下是使用`mvn package`命令打包本地Maven项目的详细步骤： #### 1. 前置条件 - 确保已安装Maven并配置环境变量（通过`mvn -v`验证）[^3]。 - 项目需符合Maven标准结构（包含`pom.xml`文件）。 #### 2. 基础打包命令 在项目根目录（含`pom.xml`的目录）执行： ```bash mvn package ``` 此命令会执行编译、测试（默认）并生成构建产物（如JAR/WAR）到`target/`目录[^3]。 #### 3. 跳过测试的打包方式 若需跳过测试以提高速度或避免失败： ```bash mvn package -DskipTests ``` 或在`pom.xml`中永久配置（引用自示例配置）： ```xml <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>2.22.2</version> <configuration> <skipTests>true</skipTests> </configuration> </plugin> ``` [^1] #### 4. 清理旧构建产物 推荐先清理历史构建： ```bash mvn clean package ``` 这会删除`target/`目录后重新构建[^2]。 #### 5. 在IDE中执行（以Eclipse为例） 1. 右键项目 -> Run As -> Maven build 2. Goals输入框填写`clean package` 3. 后续可通过历史配置快速执行 #### 6. 构建产物说明 - Java项目：默认生成`项目名-版本.jar` - Web项目：生成WAR文件 - 具体路径：`target/`目录下[^3] #### 7. 高级用法 包含测试报告的打包（需TestNG配置）： ```bash mvn package -Dtestng.xml=testng.xml ``` 生成的可执行JAR可通过`java -jar target/xxx.jar`运行[^4]
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值