1. 程式人生 > >Idea使用Maven構建可執行的jar包(包含依賴jar包)

Idea使用Maven構建可執行的jar包(包含依賴jar包)

目標:

將依賴的第三方jar包打進去

方法:

maven-assembly-plugin

環境:

IDEA 2016.3

JDK 1.8

遇到的問題:

此處耗時2天時間,遇到過的坑:

1.修改完pom.xml後,不生效。

--改pom.xml後,程式碼不生效,是因為對IDEA工具不熟,在修改完xml後,需要點工具右下角的import changes或者直接點auto-import就可以一勞永逸了。

2.生成jar後,idea可以執行,但是java -jar無法執行,報錯Exception in thread "main" java.lang.NoClassDefFoundError

如果修改pom.xml中的mainClass生效了,說不定是mainClass傳入的不對,使用mvn exec:java -Dexec.mainClass="com.delon.main.Test"可以嘗試main方法是否正確。

如果想用編譯Test.java檔案,可以使用mvn clean compile exec:java -Dexec.mainClass="com.delon.main.Test"

3.生成jar後,idea可以執行,java -jar也可以執行,但是缺少相關依賴,報錯Exception in thread "main" java.lang.NoClassDefFoundError: okhttp3/RequestBody

參考如下解決方式即可。

maven構建jar包的步驟:

1.執行可執行的class,程式碼內需要有入口main方法

2.通過mvn package來構建jar包

3.使用java -jar test.jar來執行jar包

一、包含依賴jar包

 maven的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.xxx.delon</groupId>
    <artifactId>bugly</artifactId>
    <version>1.0-SNAPSHOT</version>

    
    <dependencies>
    <!-- 工程所需jar包引用開始 -->
        <!-- 單元測試 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.7</version>
            <scope>test</scope>
        </dependency>

        <!-- 程式碼所需依賴 -->
        <dependency>
            <groupId>com.squareup.okhttp3</groupId>
            <artifactId>okhttp</artifactId>
            <version>3.3.0</version>
        </dependency>

        <!-- 程式碼所需依賴 -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.2.2</version>
        </dependency>
        <!-- 工程所需jar包引用開始 -->
    </dependencies>


    <build>
        <plugins>

            <plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                    <appendAssemblyId>false</appendAssemblyId>
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <archive>
                        <manifest>
                            <!-- 此處指定main方法入口的class -->
                            <mainClass>com.xxx.uploadFile</mainClass>
                        </manifest>
                    </archive>
               ta </configuration>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <goal>assembly</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

        </plugins>
    </build>

</project>

生成jar包,會生成在target目錄下

mvn package

解壓縮bugly-1.0-SNAPSHOT.jar->META-INF->MANIFEST.MF

Manifest-Version: 1.0
Archiver-Version: Plexus Archiver
Created-By: Apache Maven
Built-By: delon
Build-Jdk: 1.8.0_112
Main-Class: com.xxx.uploadFile

執行:

# 執行jar
java -jar test.jar

也可以通過如下命令

mvn assembly:assembly
#跳過測試 
mvn -Dmaven.test.skip=true  assembly:assembly

注意:在執行這個命令之前,必須先配置Maven的環境變數,檢查是否配置可通過命令: mvn -version

如果上面的命令成功執行,那麼在專案路徑的target檔案下就會有兩個jar檔案,一個是有jar包依賴的,一個是沒jar包依賴的。

二、不包含依賴jar包

如果不想包含依賴的jar包,可以把<build>裡面的程式碼替換成如下code:

<!-- 打包jar檔案時,配置manifest檔案,加入lib包的jar依賴 -->  
            <plugin>  
                <groupId>org.apache.maven.plugins</groupId>  
                <artifactId>maven-jar-plugin</artifactId>  
                <configuration>  
                    <archive>  
                        <manifest>  
                            <addClasspath>true</addClasspath>  
                            <classpathPrefix>lib/</classpathPrefix>  
                            <mainClass>com.xxx.uploadFile</mainClass>  
                        </manifest>  
                    </archive>  
                </configuration>  
            </plugin>  
            <!-- 拷貝依賴的jar包到lib目錄 -->  
            <plugin>  
                <groupId>org.apache.maven.plugins</groupId>  
                <artifactId>maven-dependency-plugin</artifactId>  
                <executions>  
                    <execution>  
                        <id>copy</id>  
                        <phase>package</phase>  
                        <goals>  
                            <goal>copy-dependencies</goal>  
                        </goals>  
                        <configuration>  
                            <outputDirectory>  
                                ${project.build.directory}/lib  
                            </outputDirectory>  
                        </configuration>  
                    </execution>  
                </executions>  
            </plugin>  

三、只包含部分依賴jar包

 如果想只包含部分依賴jar包

比如說,想做一個工具jar包,依賴公共jar和自己本地jar包,本地jar包需要解壓成class打到jar包內,而依賴的公共jar包則不需要。

剔除公共jar包 可以用<scope>

<scope>的值的含義:
compile,預設值,適用於所有階段,會隨著專案一起釋出。 
provided,類似compile,期望JDK、容器或使用者會提供這個依賴。如servlet.jar。 
runtime,只在執行時使用,如JDBC驅動,適用執行和測試階段。 
test,只在測試時使用,用於編譯和執行測試程式碼。不會隨專案釋出。 
system,類似provided,需要顯式提供包含依賴的jar,Maven不會在Repository中查詢它。

編譯的時候採用 compile

<dependency>
     <groupId>log4j</groupId>
     <artifactId>log4j</artifactId>
     <version>1.2.17</version>
     <scope>complie</scope>
     <optional>true</optional>
</dependency>

在用package打包的時候,改成test,生成的jar包裡就不會有該jar包的類了。

<dependency>
     <groupId>log4j</groupId>
     <artifactId>log4j</artifactId>
     <version>1.2.17</version>
     <scope>test</scope>
     <optional>true</optional>
</dependency>

build配置項,mainClass為空因為不是可執行jar。

<build>
        <plugins>
            <plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <archive>
                        <manifest>
                            <mainClass></mainClass>
                        </manifest>
                    </archive>
                </configuration>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>