在jar版本中包含git commit hash

时间:2016-11-06 05:21:52

标签: java maven maven-versions-plugin

我正在使用maven,我的目标是在版本号中包含git commit hash。类似的东西:1.1。{git_hash}。

我试图遵循这个tutorial

问:是否有可能以某种方式覆盖pom文件的version元素中指定的版本号?

2 个答案:

答案 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>

补充说明:

  1. 我展示了git-commit-id-plugin的简单配置。在他们的网站上,您可以找到更多选项和属性。除了可以在pom.xml中使用的属性之外,插件还可以生成包含有关修订信息的属性文件。

  2. 作为git-commit-id-plugin的替代方案,您可能更喜欢buildnumber-maven-plugin。为了获得修订号,这个插件需要在pom.xml中配置SCM插件。

  3. 此设置可能会干扰转换或重命名工件的其他插件(在我的情况下,它是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>