Maven多模块实现统一版本管理

在使用Maven多模块结构工程时，配置版本号是一个比较头疼的事。继承版本、依赖版本、自身版本都需要单独定义，很是麻烦。比如在微服务系统中，所有服务都依赖一个包，里面进行版本管理。每个服务的version版本管理却是单独使用一个版本号。然后我们在版本快速迭代中，通常是要不断地切换version，当服务众多的时候，修改起版本来就很麻烦。

Maven官方文档说：自 Maven 3.5.0-beta-1 开始，可以使用 ${revision}, ${sha1} and/or ${changelist} 这样的变量作为版本占位符。

命令

mvn clean install versions:set -DnewVersion=2.0.2

 单模块项目

1.  
   <project>
2.  
   <modelVersion>4.0.0</modelVersion>
3.  
   <groupId>com.xh</groupId>
4.  
   <artifactId>personal-platform</artifactId>
5.  
   <version>${project.build.version}</version>
6.  
   ...
7.  
   <properties>
8.  
   <project.build.version>2.0.3</project.build.version>
9.  
   </properties>
10.  
     
11.  
    </project>

这种情况比较简单，只使用了 ${project.build.version} 来替换版本。

多模块项目

现在来看看多模块构建的情况，有一个父项目和一个或多子模块。

父pom

1.  
   <project>
2.  
       <modelVersion>4.0.0</modelVersion>
3.  
       <groupId>com.xh</groupId>
4.  
       <artifactId>personal-platform</artifactId>
5.  
       <packaging>pom</packaging>
6.  
       <version>${project.build.version}</version>
7.  
    
8.  
       ...
9.  
       <properties>
10.  
            <project.build.version>2.0.3</project.build.version>
11.  
        </properties>
12.  
     
13.  
        <modules>
14.  
            <module>commons-center</module>
15.  
        </modules>
16.  
    </project>

子pom

1.  
   <project>
2.  
       <parent>
3.  
           <artifactId>personal-platform</artifactId>
4.  
           <groupId>com.anchnet</groupId>
5.  
           <version>${project.build.version}</version>
6.  
       </parent>
7.  
    
8.  
       <modelVersion>4.0.0</modelVersion>
9.  
       <artifactId>commons-center</artifactId>
10.  
        <packaging>pom</packaging>
11.  
     
12.  
    </project>

多模块项目中子模块的版本应该使用父工程的版本，单独设置版本的话会导致版本混乱。

打包

package、install、deploy

如果使用以上设置来发布，必须使用 flatten-maven-plugin

1.  
   <build>
2.  
       <plugins>
3.  
           <plugin>
4.  
               <groupId>org.codehaus.mojo</groupId>
5.  
               <artifactId>flatten-maven-plugin</artifactId>
6.  
               <version>1.3.0</version>
7.  
               <configuration>
8.  
                   <!--true：更新pom文件，不然无法更新module里的pom版本号，此处还有更高级的用法，具体参靠官方文档-->
9.  
                   <updatePomFile>true</updatePomFile>
10.  
                    <flattenMode>resolveCiFriendliesOnly</flattenMode>
11.  
                </configuration>
12.  
                <executions>
13.  
                    <execution>
14.  
                        <id>flatten</id>
15.  
                        <phase>process-resources</phase>
16.  
                        <goals>
17.  
                            <goal>flatten</goal>
18.  
                        </goals>
19.  
                    </execution>
20.  
                    <execution>
21.  
                        <id>flatten.clean</id>
22.  
                        <phase>clean</phase>
23.  
                        <goals>
24.  
                            <goal>clean</goal>
25.  
                        </goals>
26.  
                    </execution>
27.  
                </executions>
28.  
            </plugin>
29.  
        </plugins>
30.  
    </build>

最终执行 package、install、deploy 后，maven会将该module的pom文件中的 ${project.build.version} 替换为实际的版本号，轻松解决pom中版本号的问题。

官网

Maven – Maven CI Friendly Versions

这篇好文章是转载于：学新通技术网