#!/bin/sh # get-version.sh - 算出版本号,供 Makefile 用 -D 注入 # # 输出六行(顺序固定,Makefile 按行取): # 1. CalVer 主版本号 YYYY.MM.DD # 2. git 短哈希 abc1234 / 1a2b3c4.dirty / unknown # 3. 分支名 master / unknown(detached HEAD 或非 git) # 4. 构建日期 YYYY-MM-DD(UTC) # 5. 构建时间 HH:MM:SS(UTC) # 6. 本脚本算出的版本串(仅供人看/调试) # # 版本方案:**CalVer(发布日的 YYYY.MM.DD)+ git 短哈希**。 # # 2026.02.14 打在 tag 上的发布版 # 2026.02.14-1a2b3c4 tag 之后又提交了 # 2026.02.14-1a2b3c4.dirty 工作区还有没提交的改动 # # 为什么 CalVer 而不是 SemVer:ligent 是个终端工具,不是被别人链接的库, # "第几个大版本"这种信息对它没什么用;"这是哪天的东西"才有用 —— 用户看到 # 2026.02.14 立刻知道新旧。真需要表达破坏性变更时,git 历史和 README 比版本 # 号数字说得清楚。 # # 为什么还要带哈希:CalVer 的粒度是"天",同一天可能发好几次;而且用户手上 # 的二进制未必来自 tag(可能自己改了源码)。带上哈希,报 bug 时能精确定位。 # # 分隔符用 "-" 而不是 git describe 传统的 "+g":我们只用 git,不存在"区分是 # 哪种 SCM"的需求(那正是 g 前缀存在的理由),而 2026.09.22-1a2b3c4 少两个 # 符号、念起来也顺。 # # 取版本号的优先级(从高到低): # 1. 环境变量 LIGENT_VERSION_OVERRIDE —— 给 CI 用,tag 打得不对时能手动指定 # 2. git tag 里最新的 CalVer 形态的 tag(v2026.02.14 或 2026.02.14) # 3. 源码目录的 mtime(从 tarball 解出来时没有 .git,用文件的日期当版本) # # 任何一步失败都不算致命:退回一个明确的默认值,绝不让构建挂掉 —— # 版本号不对只是难看,构建挂掉是真的不能用。 set -eu ROOT=$(cd "$(dirname "$0")/.." && pwd) # ------------------------------------------------------- 构建日期与时间 # SOURCE_DATE_EPOCH 是"可复现构建"的标准约定:设了它就用它当构建时间, # 这样同一个源码在不同时间编出来的二进制是**逐字节相同**的。 # 不认这个约定的话,CI 上每次构建的产物哈希都不一样,没法校验。 if [ -n "${SOURCE_DATE_EPOCH:-}" ]; then BUILD_DATE=$(date -u -d "@$SOURCE_DATE_EPOCH" +%Y-%m-%d 2>/dev/null \ || date -u -r "$SOURCE_DATE_EPOCH" +%Y-%m-%d 2>/dev/null \ || echo unknown) BUILD_TIME=$(date -u -d "@$SOURCE_DATE_EPOCH" +%H:%M:%S 2>/dev/null \ || date -u -r "$SOURCE_DATE_EPOCH" +%H:%M:%S 2>/dev/null \ || echo unknown) else BUILD_DATE=$(date -u +%Y-%m-%d 2>/dev/null || echo unknown) BUILD_TIME=$(date -u +%H:%M:%S 2>/dev/null || echo unknown) fi # ---------------------------------------------------------------- 主版本号 if [ -n "${LIGENT_VERSION_OVERRIDE:-}" ]; then CALVER=$LIGENT_VERSION_OVERRIDE else CALVER= # 只在真的在 git 工作区里、且 git 可用时才问 git if command -v git >/dev/null 2>&1 && [ -d "$ROOT/.git" ]; then # 找最近的、长得像 CalVer 的 tag。用 grep 过滤而不是 --match:不同 # git 版本对 --match 的 glob 支持略有差异,而这里只要"第一个符合 # YYYY.MM.DD 形态的"就够了,过滤更直观也更可移植。 CALVER=$(git -C "$ROOT" tag --list 2>/dev/null \ | grep -E '^v?[0-9]{4}\.[0-9]{2}\.[0-9]{2}$' \ | sed 's/^v//' \ | sort \ | tail -1 || true) fi # 没有 tag:用源码目录的日期当版本。tarball 场景下这是"这份源码什么时候 # 打的包",虽然不如 tag 精确,但比写死一个 0.0.0 有用。 if [ -z "$CALVER" ]; then CALVER=$(date -u -r "$ROOT/src/main.c" +%Y.%m.%d 2>/dev/null || true) fi [ -n "$CALVER" ] || CALVER=0.0.0-unknown fi # ---------------------------------------------------------------- git 哈希 # LIGENT_HASH_OVERRIDE:给容器/CI 用。容器里没有 .git(.dockerignore 排除了), # 那里问不出哈希来,只能由外面算好传进来。 HASH=${LIGENT_HASH_OVERRIDE:-} if [ -z "$HASH" ] && command -v git >/dev/null 2>&1 && [ -d "$ROOT/.git" ]; then if h=$(git -C "$ROOT" rev-parse --short=7 HEAD 2>/dev/null); then HASH=$h # 工作区脏了就标出来。**这一条很重要**:不带这个标记的话,一个改过 # 源码的构建和一个干净的构建会报出同样的版本号,排查时会被误导。 if ! git -C "$ROOT" diff --quiet HEAD -- 2>/dev/null; then HASH="$HASH.dirty" elif [ -n "$(git -C "$ROOT" ls-files --others --exclude-standard 2>/dev/null)" ]; then # 未跟踪的新文件也算脏 —— 它可能正是被编译进去的那个源文件 HASH="$HASH.dirty" fi fi fi [ -n "$HASH" ] || HASH=unknown # ---------------------------------------------------------------- 分支名 # LIGENT_BRANCH_OVERRIDE 同理给容器/CI 用。 BRANCH=${LIGENT_BRANCH_OVERRIDE:-} if [ -z "$BRANCH" ] && command -v git >/dev/null 2>&1 && [ -d "$ROOT/.git" ]; then b=$(git -C "$ROOT" rev-parse --abbrev-ref HEAD 2>/dev/null || true) # detached HEAD(CI 上 checkout 某个 tag/commit 时就是这种状态)会返回 # 字面量 "HEAD" —— 那不是分支名,照实说成 unknown,别让读的人以为 # 有个叫 HEAD 的分支。 if [ -n "$b" ] && [ "$b" != "HEAD" ]; then BRANCH=$b fi fi [ -n "$BRANCH" ] || BRANCH=unknown printf '%s\n' "$CALVER" printf '%s\n' "$HASH" printf '%s\n' "$BRANCH" printf '%s\n' "$BUILD_DATE" printf '%s\n' "$BUILD_TIME" # 第 6 行只是给人看的完整串。哈希未知时**不要**拼出 "…-unknown" —— # 那既丑又会被误读成一个真实的哈希。src/version.c 的拼接遵循同一规则, # 两处必须一致,否则这个"调试输出"会误导人。 if [ "$HASH" = unknown ]; then printf '%s\n' "$CALVER" else printf '%s-%s\n' "$CALVER" "$HASH" fi