我正在使用maven,我的目标是在版本号中包含git commit hash。类似的东西:1.1。{git_hash}。
我试图遵循这个tutorial。
问:是否有可能以某种方式覆盖pom文件的version元素中指定的版本号?
答案 0 :(得分:25)
实现此目的的一种方法是使用git-commit-id-plugin。将其添加到pom.xml的build
部分中的插件列表中:
<plugin>
<groupId>pl.project13.maven</groupId>
<artifactId>git-commit-id-plugin</artifactId>
<version>${git-commit-id-plugin.version}</version>
<executions>
<execution>
<id>get-the-git-infos</id>
<goals>
<goal>revision</goal>
</goals>
<phase>validate</phase>
</execution>
</executions>
<configuration>
<dotGitDirectory>${project.basedir}/.git</dotGitDirectory>
</configuration>
</plugin>
请注意,我已将阶段更改为validate
,因此在打包工件时,版本号属性已可用。
然后,将以下内容添加到build
部分:
<build>
<finalName>${project.artifactId}-${project.version}-${git.commit.id.describe-short}</finalName>
<!-- your list of plugins -->
</build>
git.commit.id.describe-short
属性由git-commit-id-plugin
生成。它包含当前的git修订版号(缩写为7位数)和可选的dirty
指示符。
生成的工件将如下所示:examplelib-1.0.2-efae3b9.jar
(或examplelib-1.0.2-efae3b9-dirty.jar
,以防存储库中存在未提交的更改。)
此外,您可能还希望将此信息放入工件的MANIFEST.MF中。在这种情况下,将其添加到插件列表中(该示例假定工件为jar
):
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<configuration>
<archive>
<manifestEntries>
<SCM-Revision>${git.commit.id.describe-short}</SCM-Revision>
</manifestEntries>
</archive>
</configuration>
</plugin>
补充说明:
我展示了git-commit-id-plugin
的简单配置。在他们的网站上,您可以找到更多选项和属性。除了可以在pom.xml中使用的属性之外,插件还可以生成包含有关修订信息的属性文件。
作为git-commit-id-plugin
的替代方案,您可能更喜欢buildnumber-maven-plugin。为了获得修订号,这个插件需要在pom.xml中配置SCM插件。
此设置可能会干扰转换或重命名工件的其他插件(在我的情况下,它是maven-shade-plugin - 它生成的jar源之一不包含正确的修订版号。)
答案 1 :(得分:0)
上面接受的答案对我不起作用。我找到了链接https://dzone.com/articles/maven-git-commit-id-plugin,从这里复制了下面的插件代码。它对我来说是第一次。现在,我的目标JAR文件中自动包含了git.properties文件。对于跟踪非常有用。
<plugin>
<groupId>pl.project13.maven</groupId>
<artifactId>git-commit-id-plugin</artifactId>
<version>2.2.4</version>
<executions>
<execution>
<id>get-the-git-infos</id>
<goals>
<goal>revision</goal>
</goals>
</execution>
</executions>
<configuration>
<dotGitDirectory>${project.basedir}/.git</dotGitDirectory>
<prefix>git</prefix>
<verbose>false</verbose>
<generateGitPropertiesFile>true</generateGitPropertiesFile>
<generateGitPropertiesFilename>${project.build.outputDirectory}/git.properties</generateGitPropertiesFilename>
<format>json</format>
<gitDescribe>
<skip>false</skip>
<always>false</always>
<dirty>-dirty</dirty>
</gitDescribe>
</configuration>
将finalName添加到构建部分,以使版本也包含在目标文件名中
<build>
<finalName>${project.artifactId}-${project.version}-${git.commit.id.describe-short}</finalName>
...
</build>