Maven插件之buildnumber-maven-plugin

某些情况下(这种情况一般很少见),使用maven构建项目时,需要一个不重复的序列号,比如说,打包时,包名称以当前构建时间结尾,或者每次生成的jar包中包含唯一的序列号,等等;

这个时候,就用到了buildnumber插件,官方网址:

http://mojo.codehaus.org/buildnumber-maven-plugin/index.html

该插件能按照指定的方案生成序列号;首先引入该插件

    <!-- 根据系统时间生成唯一序列号 -->

<plugin>

	<groupId>org.codehaus.mojo</groupId>

	<artifactId>buildnumber-maven-plugin</artifactId>

	<version>1.2</version>

</plugin>
  

常用以下两个目标:

buildnumber:create (基于SCM版本生成)

buildnumber:create-timestamp (基于系统时间生成)
两个目标都默认绑定在 initialize 生命周期;其中create-timestamp目标是 1.0-beta-5 版本新增;

以下分别介绍:

buildnumber:create

其参数介绍如下:

buildnumber:create-timestamp

其有两个可选参数

个人认为,使用 create-timestamp 目标就足够了。

有关"format"和"items"参数的使用,例子如下:

    <plugin>

	<groupId>org.codehaus.mojo</groupId>

	<artifactId>buildnumber-maven-plugin</artifactId>

	<version>1.2</version>

	<configuration>

		<format>At {1,time} on {1,date}, there was {2} on planet {0,number,integer}.</format>

		<items>

			<item implementation="java.lang.Integer">7</item>

			<item>timestamp</item>

			<item>a disturbance in the Force</item>

		</items>

	</configuration>

	<executions>

		<execution>

			<phase>validate</phase>

			<goals>

				<goal>create</goal>

			</goals>

		</execution>

	</executions>

</plugin>
  

其他常用配置有

    <configuration>

	<format>{0,number}.{1,number}.{2,number}</format>

	<items>

		<item>buildNumber0</item>

		<item>buildNumber1</item>

		<item>buildNumber2</item>

	</items>

</configuration>
  

    <configuration>

	<format>{0,date,yyyy-MM-dd HH:mm:ss}</format>

	<items>

		<item>timestamp</item>

	</items>

</configuration>
  

产生的  ${buildNumber} 值分别如下:

      
        At
      
      
        12
      
      
        :
      
      
        30
      
      
         PM on 
      
      
        Jul
      
      
        3
      
      
        ,
      
      
        2053
      
      
        ,
      
      
         there was a disturbance 
      
      
        in
      
      
         the 
      
      
        Force
      
      
         on planet 
      
      
        7.
      
    

      
        2.0
      
      
        .
      
      
        3
      
    

      
        2005
      
      
        -
      
      
        10
      
      
        -
      
      
        06
      
      
        2
      
      
        :
      
      
        22
      
      
        :
      
      
        55
      
    

其他详细信息,请参考官网

http://mojo.codehaus.org/buildnumber-maven-plugin/usage.html

PS：一个有用的实践,自定义属性,将生成的序列号赋值其中,便于其他插件等地方使用;

    <properties>

	<buildtimestamp>${timestamp}</buildtimestamp>

</properties>


  

Maven插件之buildnumber-maven-plugin