version-control - 如何使用fossil自动生成包版本？

Question

我想自动生成我的版本号。在 git ， 我可以用

pkgver() {
    cd local_repo
    printf "%s.%s" "$(git rev-list --count HEAD)" "$(git rev-parse --short HEAD)"
}

但是，我怎么能用化石做类似的事情呢？我知道我可以使用 manifest.uuid，但是不能提供适合比较版本更新的序列号。

Answer 1

建议

我的建议是将带点的版本号视为营销神器。它也可以是代码名称、颜色或其他任何提供识别公开可用构建的快捷方式的东西。但是，使用足够短的名称让人们记住并且还表明某种自然顺序是有好处的，因此人们一眼就知道“kitkat”比“jellybean”更新。

让您的修订控制系统以任何类型的自动化方式提供它是一个令人头疼的问题。对于分布式版本控制系统，您会遇到一个额外的问题，即不同的开发人员在不同的地方构建时可能会为不同的版本分配相同的名称，并且可能具有不同的选项。您甚至不能使用构建计数，因为不同的开发人员会在不同的时间构建。

如果所有“官方”构建都来自单个系统，那么您可以在该系统上使用自动化为每个此类构建分配唯一名称。但是，为许多平台构建的可移植应用程序又如何呢？在这种情况下，它可能构建在许多不同的机器上？

恕我直言，唯一明智的出路是承认版本号对构建系统来说是完全任意和人为的。

当然，作为项目管理的问题，您需要制定关于如何创建和分配版本号的策略，并仔细遵循该策略。

发布分支

使用 fossil ，管理它的一种方法是为每个公开发布创建一个分支。作为该分支上的第一批 checkin 之一，您可以更改文档中显示的版本号并通过代码进行匹配，可能包括一个额外的限定符，如“alpha”、“beta”或“发布候选”。随着发布周期的进展，发现的错误可以在此分支中修复。同时，没有计划发布的功能可以在它们自己的分支和/或主干上开发，而不会破坏发布过程的风险。自然地，一旦发布，它可以并且很可能应该合并回主干，这样就不会丢失任何错误修复。

但是不要关闭该分支，它为您提供了该发布版本的 future 维护的逻辑框架，从而可以轻松检查作为该版本最终发布基础的源代码。

在发行版中包含 UUID

不管是否保留了一个分支，包括足够的 list UUID 来识别在发布本身中实际发布了哪个 checkin 是很重要的。这可能意味着在实践中永远不应该在具有任何未决更改的化石工作区中构建版本。

由于在我自己的项目中犯了这个错误，我已经在项目构建过程中添加了代码来验证工作区是否干净，如果不是，则显示大声警告，并使构建代码显示的版本号表明构建释放也不安全。该过程还通过命令行选项(如 -DUUID=[0123456789] )向编译器提供 UUID 的前几位数字。这个技巧是通过使用 fossil changes 检测脏工作区和 manifest.uuid 文件来提供 UUID 来完成的。 UUID 也可以从 fossil info 获得。

使用 Gnu Make 的示例

我的项目的顶级 Makefile 包括以下代码:

#
# Discover fossil checkin id and public version number
# 
MANIFESTUUID := $(shell sed -e "s/\(.\{10\}\).*/\1/" manifest.uuid)
VERSIONMAJ := $(shell sed -n -e "/define VERSION_MAJ/ s/^[^0-9]*\([0-9]*\)[^0-9]*$$/\1/p" src/version.h)
VERSIONMIN := $(shell sed -n -e "/define VERSION_MIN/ s/^[^0-9]*\([0-9]*\)[^0-9]*$$/\1/p" src/version.h)
VERSIONPAT := $(shell sed -n -e "/define VERSION_PAT/ s/^[^0-9]*\([0-9]*\)[^0-9]*$$/\1/p" src/version.h)
CHECKCLEAN := $(if $(shell fossil changes),-WITH-UNCOMMITTED-CHANGES)

#
# Create a filename-friendly version string like v1.123p42 where
# exacly three digits of the minor version number are displayed.
#
VERSION := v$(VERSIONMAJ).$(shell echo 000$(VERSIONMIN) | sed -n -e s/^.*\([0-9]\{3\}\).*$$/\1/p )p$(VERSIONPAT)$(CHECKCLEAN)

这取决于化石工作区中的两个文件，以及 fossil changes 命令的输出来构造一个字符串，该字符串可用作已发布包的文件名的一部分，其中包括主要编号、次要编号、补丁级别、如果工作区不够干净，则额外的文本 -WITH-UNCOMMITTED-CHANGES 。它还将 UUID 的前 10 个字符放在变量 MANIFESTUUID 中，在那里它可以传递给编译。

根据政策，版本号的主要、次要和补丁部分都保存在 src/version.h 文件中，并随着工作的进行不时更改。