Files
admin 50911ea7d6 feat(version): 构建身份四件套,为按版本发标准包打底
- 新增 build.rs 注入 version/gitSha/target/buildTime;`--version` 打印一行。
  gitSha 带 `-dirty` 后缀,避免「sha 对得上但代码其实改过」的误判。
- 版本行同时拼成静态字符串(TDC_VERSION_LINE):armv7 产物在 x86 打包机上
  跑不起来,打包脚本要靠 strings 捞同一行。
- /api/health 增 gitSha/target/buildTime(纯新增,既有字段一个不动)。
- 版本 0.1.0 → 0.2.0。

动机:设备上跑的到底是哪个构建,此前只能靠 md5 比对几十兆的 `.bak`;
排查 carol 上一个 1.27M 的 mpc 时就卡在无法自证来源。
2026-11-14 11:57:08 +08:00

115 lines
4.9 KiB
Rust
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 构建期元信息注入:版本号之外,再钉住 **git sha / 构建时间 / 目标三元组**。
//!
//! 🔴 为什么需要:此前二进制里只有 `CARGO_PKG_VERSION`(恒为 `0.1.0`),
//! 而版本一直没 bump ⇒ 三台设备上跑的到底是哪个构建,只能靠 md5 猜。
//! 2026-11-14 排查 carol 上一个 1.27M 的 `mpc` 时,正因为无版本串而无法自证来源。
//!
//! 🔴 本仓 `[dependencies]` 为空(平台走预编译 rlib 闭包),所以 build.rs 只用 std。
//!
//! 🔴 **不注入 GLIBC 需求**:build.rs 跑的时候二进制还不存在,算不出来。
//! 那个交给打包脚本对**产物**跑 `objdump -T` 得出并写进 manifest —— 以实物为准,
//! 不以声明为准(声明会和实际脱钩,实物不会)。
use std::process::Command;
fn main() {
// 🔴 构建期自检:`#[cfg(test)]` 在 build.rs 里**不会**被 `cargo test` 执行,
// 所以日历换算只能这样验 —— 错了就让构建失败,而不是留个永不运行的测试。
assert_eq!(fmt_utc(0), "1970-01-01T00:00:00Z");
assert_eq!(fmt_utc(1_794_628_200), "2026-11-14T03:50:00Z");
assert_eq!(fmt_utc(1_709_208_000), "2024-02-29T12:00:00Z"); // 闰日
// sha:允许构建脚本用环境变量覆盖(容器里没装 git 时也能钉版本),否则现场问 git。
let sha = std::env::var("TDC_GIT_SHA")
.ok()
.filter(|s| !s.trim().is_empty())
.or_else(git_sha)
.unwrap_or_else(|| "unknown".to_string());
let epoch = std::time::SystemTime::now()
.duration_since(std::time::UNIX_EPOCH)
.map(|d| d.as_secs())
.unwrap_or(0);
let target = std::env::var("TARGET").unwrap_or_else(|_| "unknown".to_string());
let utc = fmt_utc(epoch);
// 🔴 版本行**只在这里拼一次**,`--version` 直接打印它。
// 第二个用途:armv7 产物在 x86_64 打包机上**跑不了**,拿不到 `--version` 输出,
// 打包脚本只能用 `strings` 从二进制里捞这一行 ⇒ 它必须是**完整的静态字符串**
// (`println!` 的格式串加参数在二进制里是碎的,捞不出来)。
let ver_line = format!(
"tdc-connector {} ({sha} {target} {utc})",
env!("CARGO_PKG_VERSION")
);
println!("cargo:rustc-env=TDC_GIT_SHA={sha}");
println!("cargo:rustc-env=TDC_BUILD_EPOCH={epoch}");
println!("cargo:rustc-env=TDC_BUILD_UTC={utc}");
println!("cargo:rustc-env=TDC_BUILD_TARGET={target}");
println!("cargo:rustc-env=TDC_VERSION_LINE={ver_line}");
// 不设这个的话 sha 会永远停在第一次构建的值 —— git 换了也不重跑 build.rs。
println!("cargo:rerun-if-changed=build.rs");
println!("cargo:rerun-if-changed=.git/HEAD");
println!("cargo:rerun-if-changed=.git/index");
println!("cargo:rerun-if-env-changed=TDC_GIT_SHA");
}
/// `git rev-parse --short HEAD`,工作区有未提交改动时追加 `-dirty`。
///
/// `-dirty` 很重要:否则「sha 对得上但代码其实改过」会造成误判,
/// 而这正是本轮要消灭的那类问题(设备状态与源码无法对应)。
fn git_sha() -> Option<String> {
let out = Command::new("git")
.args(["rev-parse", "--short", "HEAD"])
.output()
.ok()?;
if !out.status.success() {
return None;
}
let sha = String::from_utf8_lossy(&out.stdout).trim().to_string();
if sha.is_empty() {
return None;
}
// --untracked-files=no:未跟踪的临时文件不算脏,避免每轮都标 -dirty。
let dirty = Command::new("git")
.args(["status", "--porcelain", "--untracked-files=no"])
.output()
.ok()
.filter(|o| o.status.success())
.map(|o| !o.stdout.is_empty())
.unwrap_or(false);
Some(if dirty { format!("{sha}-dirty") } else { sha })
}
/// epoch 秒 → `YYYY-MM-DDTHH:MM:SSZ`(UTC),手写以免引入 chrono 依赖。
///
/// 算法照 Howard Hinnant 的 `civil_from_days`(把 1970-01-01 起的日数转年月日)。
fn fmt_utc(secs: u64) -> String {
let days = (secs / 86_400) as i64;
let rem = secs % 86_400;
let (y, m, d) = civil_from_days(days);
format!(
"{y:04}-{m:02}-{d:02}T{:02}:{:02}:{:02}Z",
rem / 3600,
(rem % 3600) / 60,
rem % 60
)
}
fn civil_from_days(z: i64) -> (i64, u32, u32) {
let z = z + 719_468;
let era = if z >= 0 { z } else { z - 146_096 } / 146_097;
let doe = (z - era * 146_097) as u64; // [0, 146096]
let yoe = (doe - doe / 1460 + doe / 36_524 - doe / 146_096) / 365; // [0, 399]
let y = yoe as i64 + era * 400;
let doy = doe - (365 * yoe + yoe / 4 - yoe / 100); // [0, 365]
let mp = (5 * doy + 2) / 153; // [0, 11]
let d = (doy - (153 * mp + 2) / 5 + 1) as u32; // [1, 31]
let m = if mp < 10 { mp + 3 } else { mp - 9 } as u32; // [1, 12]
(if m <= 2 { y + 1 } else { y }, m, d)
}