在 Java jar 清单中嵌入 SVN 版本号的最佳实践？

Question

我看到类似 如何使用 maven 从 subversion 获取修订号？ 但是对于清单中使用的实际字段、版本 # 和存储库 URL（即显示它位于主干还是分支），是否有任何标准（事实上或其他）？我已经看到使用了实现版本，有或没有前导“r”（用于修订），我也看到了实现构建：也被使用。

编辑 我删除了 Maven 标签，它不应该在那里。我的问题是关于 jar 内容，而不是工具本身。

Answer 1

不幸的是，jar 清单本身没有任何版本编号标准。

但实际上，还有另一种标准方法可以自动更新修订号。您可以使用 svn:keywords为了在每次提交后获取文件中的当前修订号。有用于修订替换的 $Revision$ 属性和用于存储库 URL 替换的 $HeadURL$ 属性。您只需将以下字符串放入文件中并将该文件置于版本控制之下：

$Revision$ $HeadURL$

如果您使用 Maven 动态创建清单，我建议将以下内容放入 version.properties 文件中：

revision=$Revision$
repourl=$HeadURL$

然后包含在使用以下语句进入 pom.xml （maven 应该启用属性插件）：

<plugins>
  <plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>properties-maven-plugin</artifactId>
    <version>1.0-alpha-1</version>
    <executions>
      <execution>
        <phase>initialize</phase>
        <goals>
          <goal>read-project-properties</goal>
        </goals>
        <configuration>
          <files>
            <file>version.properties</file>
          </files>
        </configuration>
      </execution>
    </executions>
  </plugin>

然后您将能够将修订号和存储库 URL 添加到清单中：

<manifest>
  <attribute name="Revision" value="${revision}" />
  <attribute name="Repository URL" value="${repourl}" />
</manifest>

另请注意，您将需要 使用 subversion 属性显式启用 svn:keywords 以获得$Revision$ 和 $HeadURL$ 在文件中替换为实际值。如果您决定使用 version.properties，您将需要运行以下命令：

svn propset svn:keywords Revision version.properties
svn propset svn:keywords HeadURL version.properties