flatten-maven-plugin使用教程

更新時間：2023年07月13日 14:44:26 作者：2021不再有雨

這篇文章主要介紹了flatten-maven-plugin使用，本文通過示例代碼給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下

一、簡介

1.1 作用

將pom工程父子pom的版本，提出作為變量定義在properties。

這樣僅修改變量的值(如在運行mvn命令時指定) 即可實現(xiàn)版本整體切換。

1.2 goal介紹

flatten:clean

刪除flatten插件生成的 .flattened-pom.xml

配置參數(shù)有：

flattenedPomFilename: 插件生成的pom的名字，默認為 .flattened-pom.xml

outputDirectory：插件生成pom的目錄，默認為 ${project.basedir}

flatten:flatten

在resources-process生成 .flattened-pom.xml，并在install/deploy時替換原始pom.xml

主要配置參數(shù)有：

flattenedPomFilename: 插件生成的pom的名字，默認為 .flattened-pom.xml

outputDirectory：插件生成pom的目錄，默認為 ${project.basedir}

updatePomFile: packing=pom的module也進行reversion變量替換，默認為false

flattenMode：用來定義生成 .flattened-pom.xml所包含的元素，常用值有：

oss：開源軟件常用，除了repositories/pluginRepositories外其他所有FlattenDescriptor定義的元素都生成

ossrh：所有FlattenDescriptor定義的元素都生成

bom：在ossrh基礎上增加dependencyManagement和properties

defaults：除了repositories其他所有FlattenDescriptor定義的元素都不生成

clean：所有FlattenDescriptor定義的元素都不生成

fatjar：所有FlattenDescriptor定義的元素和dependencies都不生成

resolveCiFriendliesOnly：只替換原始pom中的revision, sha1 and changelist，其他否保持原樣

常用oss/ossrh/resolveCiFriendliesOnly

FlattenDescriptor定義的pom.xml元素有：

modelVersion
groupId
artifactId
version
packaging
licenses
dependencies
profiles
name
description
url
inceptionYear
organization
scm
developers
contributors
mailingLists
pluginRepositories
issueManagement
ciManagement
distributionManagement
prerequisites
repositories
parent
build
dependencyManagement
properties
modules
reporting

二、使用總結

不用flatten-maven-plugin

1.父pom定義版本為變量reversion并作為version,子pom復引用變量reversion作為version

2.結果能正常運行compile/test, 但install或deploy時父子pom中的version還是reversion變量未被替換

3.沒有version別人無法引用你的包

父pom.xml

<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>
    <packaging>pom</packaging>
    <version>${reversion1}</version>
    <modules>
        <module>no-flatten-child</module>
    </modules>
    <groupId>com.wsl.my.maven</groupId>
    <artifactId>no-flatten-plugin</artifactId>
    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <reversion1>1.1.0-SNAPSHOT</reversion1>
    </properties>
</project>

子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">
    <parent>
        <artifactId>no-flatten-plugin</artifactId>
        <groupId>com.wsl.my.maven</groupId>
        <version>${reversion1}</version>
        <relativePath>../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>no-flatten-child</artifactId>
</project>

install/deploy后父子pom.xml中的${reversion1}沒有被替換

使用了flatten-maven-plugin

1.父pom定義版本為變量reversion并作為version,子pom復引用變量reversion作為version

2.使用flatten-maven-plugin并設置updatePomFile=true,并綁定goal到maven周期

3.在process-resources階段時會在父子project目錄下生成.flattened-pom.xml(version已替換為具體值)

4.運行install或deploy時會將.flattened-pom.xml替換原來的pom.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>
    <version>${reversion2}</version>
    <packaging>pom</packaging>
    <artifactId>use-flatten-parent</artifactId>
		<groupId>com.wsl.my.maven</groupId>
    <modules>
        <module>use-flatten-child</module>
    </modules>
    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <reversion2>1.2.0-SNAPSHOT</reversion2>
    </properties>
    <build>
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>flatten-maven-plugin</artifactId>
                <version>1.2.7</version>
                <configuration>
                    <updatePomFile>true</updatePomFile>
                    <flattenMode>resolveCiFriendliesOnly</flattenMode>
                </configuration>
                <executions>
                    <execution>
                        <id>flatten</id>
                        <phase>process-resources</phase>
                        <goals>
                            <goal>flatten</goal>
                        </goals>
                    </execution>
                    <execution>
                        <id>flatten-clean</id>
                        <phase>clean</phase>
                        <goals>
                            <goal>clean</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

到此這篇關于flatten-maven-plugin使用的文章就介紹到這了,更多相關flatten-maven-plugin使用內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: