flatten-maven-plugin使用

一、简介

1.1 作用

将pom工程父子pom的版本，提出作为变量定义在properties。

这样仅修改变量的值(如在运行mvn命令时指定) 即可实现版本整体切换

1.2 goal介绍

• flatten:clean

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

配置参数有：

1. flattenedPomFilename: 插件生成的pom的名字，默认为 .flattened-pom.xml

2. outputDirectory：插件生成pom的目录，默认为 ${project.basedir}

• flatten:flatten

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

主要配置参数有：

1. flattenedPomFilename: 插件生成的pom的名字，默认为 .flattened-pom.xml

2. outputDirectory：插件生成pom的目录，默认为 ${project.basedir}

3. updatePomFile: packing=pom的module也进行reversion变量替换，默认为false

4. 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.0modelVersion>
    <packaging>pompackaging>
    <version>${reversion1}version>
    <modules>
        <module>no-flatten-childmodule>
    modules>
    <groupId>com.wsl.my.mavengroupId>
    <artifactId>no-flatten-pluginartifactId>
    <properties>
        <maven.compiler.source>8maven.compiler.source>
        <maven.compiler.target>8maven.compiler.target>
        <reversion1>1.1.0-SNAPSHOTreversion1>
    properties>
project>

子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">
    <parent>
        <artifactId>no-flatten-pluginartifactId>
        <groupId>com.wsl.my.mavengroupId>
        <version>${reversion1}version>
        <relativePath>../pom.xmlrelativePath>
    parent>
    <modelVersion>4.0.0modelVersion>
    <artifactId>no-flatten-childartifactId>
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.0modelVersion>
    <version>${reversion2}version>
    <packaging>pompackaging>

    <artifactId>use-flatten-parentartifactId>
		<groupId>com.wsl.my.mavengroupId>
    <modules>
        <module>use-flatten-childmodule>
    modules>

    <properties>
        <maven.compiler.source>8maven.compiler.source>
        <maven.compiler.target>8maven.compiler.target>
        <reversion2>1.2.0-SNAPSHOTreversion2>
    properties>

    <build>
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojogroupId>
                <artifactId>flatten-maven-pluginartifactId>
                <version>1.2.7version>
                <configuration>
                    <updatePomFile>trueupdatePomFile>
                    <flattenMode>resolveCiFriendliesOnlyflattenMode>
                configuration>
                <executions>
                    <execution>
                        <id>flattenid>
                        <phase>process-resourcesphase>
                        <goals>
                            <goal>flattengoal>
                        goals>
                    execution>
                    <execution>
                        <id>flatten-cleanid>
                        <phase>cleanphase>
                        <goals>
                            <goal>cleangoal>
                        goals>
                    execution>
                executions>
            plugin>
        plugins>
    build>
project>