某些情況下(這種情況一般很少見),使用maven構(gòu)建項(xiàng)目時(shí),需要一個(gè)不重復(fù)的序列號(hào),比如說,打包時(shí),包名稱以當(dāng)前構(gòu)建時(shí)間結(jié)尾,或者每次生成的jar包中包含唯一的序列號(hào),等等;
這個(gè)時(shí)候,就用到了buildnumber插件,官方網(wǎng)址:
http://mojo.codehaus.org/buildnumber-maven-plugin/index.html
該插件能按照指定的方案生成序列號(hào);首先引入該插件
?
<!-- 根據(jù)系統(tǒng)時(shí)間生成唯一序列號(hào) -->
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>buildnumber-maven-plugin</artifactId>
<version>1.2</version>
</plugin>
常用以下兩個(gè)目標(biāo):
?
buildnumber:create
(基于SCM版本生成)
buildnumber:create-timestamp
(基于系統(tǒng)時(shí)間生成)
兩個(gè)目標(biāo)都默認(rèn)綁定在
initialize
生命周期;其中create-timestamp目標(biāo)是
1.0-beta-5
版本新增;
以下分別介紹:
buildnumber:create
其參數(shù)介紹如下:
?
Name
|
Type
|
Since
|
Description
|
buildNumberPropertiesFileLocation
|
File
|
1.0-beta-2
|
當(dāng)使用"format"參數(shù),并且"item"參數(shù)包含"buildNumber"值時(shí),會(huì)創(chuàng)建屬性文件;此屬性定義文件生成位置;
默認(rèn)值:
?
${basedir}/buildNumber.properties
|
buildNumberPropertyName
|
String
|
1.0-beta-1
|
自定義"
buildNumber
"屬性名;默認(rèn)值:
buildNumber
|
doCheck
|
boolean
|
1.0-beta-1
|
若設(shè)置為true,會(huì)檢查文件是否修改,若有修改,則構(gòu)建失敗;
?Note that this used to be inverted (skipCheck), but needed to be
changed to allow releases to work. This corresponds to 'svn status'.
默認(rèn)值
:?
false
.
|
doUpdate
|
boolean
|
1.0-beta-1
|
若設(shè)置為true,版本號(hào)會(huì)更新為最新;否則會(huì)保持為本地值;
Note that this used to be inverted (skipUpdate),
but needed to be changed to allow releases to work.
This corresponds to 'svn update'.
默認(rèn)值
:?
false
.
|
format
|
String
|
1.0-beta-1
|
使用java.text.MessageFormat類格式化信息;和"items"參數(shù)一起使用;設(shè)置該參數(shù)會(huì)讀取"items"參數(shù)
|
getRevisionOnlyOnce
|
boolean
|
1.0-beta-3
|
若設(shè)置為true,在多模塊的項(xiàng)目中,只會(huì)從SCM獲取一次版本號(hào);
Default value is
:?
false
.
|
items
|
List
|
1.0-beta-1
|
和"format"參數(shù)一起使用;填充"format"參數(shù)的占位符;
有效值為:"scmVersion",?"timestamp", "buildNumber[digits]";
其中[digits]可選,用于選取指定的序列號(hào);
|
locale
|
String
|
1.0-beta-2
|
該屬性使用本地Locale信息格式化date和time.該屬性值由
Locale.toString()
方法得到;
默認(rèn)值
:由
Locale.getDefault()
.toString()
方法得到;
|
password
|
String
|
1.0-beta-1
|
連接SCM系統(tǒng)時(shí)的密碼;
|
providerImplementations
|
Map
|
1.0-beta-3
|
SCM具體實(shí)現(xiàn)的替代方案;其值表示了SCM URL地址,比如"cvs","svn";
|
revisionOnScmFailure
|
String
|
1.0-beta-2
|
當(dāng)執(zhí)行SCM某些操作失敗時(shí),可使用此參數(shù)值作為替代方案;
|
scmBranchPropertyName
|
String
|
1.0-beta-4
|
自定義"
buildScmBranch
"屬性名稱;
Default value is
:?
scmBranch
.
|
scmDirectory
|
File
|
1.0-beta-
|
Local directory to be used to issue SCM actions;
Default value is
:?
${basedir}
.
|
shortRevisionLength
|
int
|
1.1
|
版本號(hào)長(zhǎng)度(僅用于git)
|
timestampFormat
|
String
|
1.0-beta-2
|
Apply this java.text.MessageFormat to the timestamp only (as opposed to the?
format
?parameter).
|
timestampPropertyName
|
String
|
1.0-beta-1
|
自定義"
timestamp
"屬性名;
Default value is
:?
timestamp
.
|
useLastCommittedRevision
|
boolean
|
1.0-beta-2
|
whether to retrieve the revision for the last commit, or the last revision of the repository.
Default value is
:?
false
.
|
username
|
String
|
1.0-beta-1
|
連接SCM的用戶名
|
?
?
buildnumber:create-timestamp
其有兩個(gè)可選參數(shù)
?
Name
|
Type
|
Since
|
Description
|
timestampFormat
|
String
|
1.0-beta-5
|
使用ava.text.SimpleDateFormat類格式化序列號(hào);默認(rèn)格式不友好,推薦自定義該參數(shù);
|
timestampPropertyName
|
String
|
1.0-beta-5
|
自定義屬性名;默認(rèn)屬性名稱是:?
timestamp
.
|
個(gè)人認(rèn)為,使用
create-timestamp
目標(biāo)就足夠了。
?
有關(guān)"format"和"items"參數(shù)的使用,例子如下:
?
<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>
產(chǎn)生的?
${buildNumber}
值分別如下:
At
12
:
30
PM on
Jul
3
,
2053
,
there was a disturbance
in
the
Force
on planet
7.
2005
-
10
-
06
2
:
22
:
55
其他詳細(xì)信息,請(qǐng)參考官網(wǎng)
http://mojo.codehaus.org/buildnumber-maven-plugin/usage.html
PS:一個(gè)有用的實(shí)踐,自定義屬性,將生成的序列號(hào)賦值其中,便于其他插件等地方使用;
?
<properties>
<buildtimestamp>${timestamp}</buildtimestamp>
</properties>
?
?
Maven插件之buildnumber-maven-plugin