127 lines
6.0 KiB
Bash
Executable File
127 lines
6.0 KiB
Bash
Executable File
#!/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
|