當你使用 Maven 對項目打包時,你須要瞭解如下 3 個打包 plugin,它們分別是html
plugin | function |
---|---|
maven-jar-plugin | maven 默認打包插件,用來建立 project jar |
maven-shade-plugin | 用來打可執行包,executable(fat) jar |
maven-assembly-plugin | 支持定製化打包方式,例如 apache 項目的打包方式 |
下面咱們就簡單介紹一下 maven-assembly-plugin。apache
<project> [...] <build> [...] <plugins> <plugin> <!-- NOTE: We don't need a groupId specification because the group is org.apache.maven.plugins ...which is assumed by default. --> <artifactId>maven-assembly-plugin</artifactId> <version>3.0.0</version> <configuration> <descriptorRefs> <descriptorRef>jar-with-dependencies</descriptorRef> </descriptorRefs> </configuration> [...] </project>
<project> [...] <build> [...] <plugins> <plugin> <artifactId>maven-assembly-plugin</artifactId> <version>3.0.0</version> <configuration> <descriptors> <descriptor>src/assembly/src.xml</descriptor> </descriptors> </configuration> [...] </project>
<id>release</id>
id 標識符,添加到生成文件名稱的後綴符。若是指定 id 的話,目標文件則是 ${artifactId}-${id}.tar.gzmaven
maven-assembly-plugin 支持的打包格式有zip、tar、tar.gz (or tgz)、tar.bz2 (or tbz2)、jar、dir、war,能夠同時指定多個打包格式ui
<formats> <format>tar.gz</format> <format>dir</format> </formats>
用來定製工程依賴 jar 包的打包方式,核心元素以下表所示。this
元素 | 類型 | 做用 |
---|---|---|
outputDirectory | String | 指定包依賴目錄,該目錄是相對於根目錄 |
includes/include* | List<String> | 包含依賴 |
excludes/exclude* | List<String> | 排除依賴 |
<dependencySets> <dependencySet> <outputDirectory>/lib</outputDirectory> </dependencySet> </dependencySets>
管理一組文件的存放位置,核心元素以下表所示。插件
元素 | 類型 | 做用 |
---|---|---|
outputDirectory | String | 指定文件集合的輸出目錄,該目錄是相對於根目錄 |
includes/include* | List<String> | 包含文件 |
excludes/exclude* | List<String> | 排除文件 |
fileMode | String | 指定文件屬性,使用八進制表達,分別爲(User)(Group)(Other)所屬屬性,默認爲 0644 |
<fileSets> <fileSet> <includes> <include>bin/**</include> </includes> <fileMode>0755</fileMode> </fileSet> <fileSet> <includes> <include>/conf/**</include> <include>logs</include> </includes> </fileSet> </fileSets>
能夠指定目的文件名到指定目錄,其餘和 fileSets 相同,核心元素以下表所示。3d
元素 | 類型 | 做用 |
---|---|---|
source | String | 源文件,相對路徑或絕對路徑 |
outputDirectory | String | 輸出目錄 |
destName | String | 目標文件名 |
fileMode | String | 設置文件 UNIX 屬性 |
<files> <file> <source>README.txt</source> <outputDirectory>/</outputDirectory> </file> </files>
工程目錄結構code
pom.xmlorm
<build> <finalName>scribe-log4j2-test</finalName> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-assembly-plugin</artifactId> <configuration> <descriptors> <descriptor>src/main/assembly/release.xml</descriptor> </descriptors> </configuration> <executions> <execution> <id>make-assembly</id> <!-- this is used for inheritance merges --> <phase>package</phase> <!-- bind to the packaging phase --> <goals> <goal>single</goal> </goals> </execution> </executions> </plugin> </plugins> </build>
release.xmlxml
<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd"> <formats> <format>tar.gz</format> <format>dir</format> </formats> <dependencySets> <dependencySet> <outputDirectory>/lib</outputDirectory> </dependencySet> </dependencySets> <fileSets> <fileSet> <includes> <include>bin/**</include> </includes> <fileMode>0755</fileMode> </fileSet> <fileSet> <includes> <include>/conf/**</include> <include>logs</include> </includes> </fileSet> </fileSets> <files> <file> <source>README.txt</source> <outputDirectory>/</outputDirectory> </file> </files> </assembly>
最終建立生成可執行二進制工程
maven 入門指南
maven 生命週期
Maven 默認插件以及功能
maven 依賴管理
maven-shade-plugin 入門指南
maven-assembly-plugin