Files
ssw-jnpf-lite-rust/scripts/fetch-platform.sh
T
admin bef326ad2f feat(dep): 方案 C —— 消费平台预编译 rlib,零重编平台/axum
- Cargo.toml: [workspace.dependencies] 清空(sspf/axum/tokio/serde/serde_json
  全部改由平台包 lib/ 经 --extern 喂入);release profile lto=false
  (预编译 rlib bitcode-free,开 LTO 会 failed to get bitcode for LTO)
- src/backend/Cargo.toml: 去掉 axum/tokio;packs/*: 去掉 sspf workspace 依赖
- scripts/fetch-platform.sh: 解包前 mv 走旧包目录(避免旧 hash rlib 残留);
  为 sspf/axum/tokio/serde/serde_json/http/bytes 生成 --extern(保证与 sspf
  同一 crate 实例,否则跨 API 边界 E0308 mismatched types);修 channel 解析
- .gitignore: 忽略 .cargo/config.toml(含本机绝对路径,跨机无效)
- rust-toolchain.toml: 新增(锁 rustc 1.95.0)
- 文档同步 SKILL/README/CLAUDE/HANDOFF

实测: cargo build 5.7s / --release 11s,只编本仓 5 个 crate,平台 17 crate 与
axum/tokio 零重编。
2026-11-05 11:41:19 +08:00

131 lines
7.7 KiB
Bash
Executable File
Raw 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.
#!/usr/bin/env bash
#
# fetch-platform.sh —— 把平台「自包含发布包」解包到 vendor/,让本仓以【方案 C】消费 sspf
#
# 背景(2026-11-05 依赖模型变更):平台仓每个版本产出一个自包含包
# `dist/sspf-vX.Y.Z.tar.gz`(预编译 sspf-admin 二进制 + 预编译 rlib 闭包 lib/ + 平台 crate
# 源码 + Cargo.lock + rust-toolchain.toml)。本仓**不再直接依赖 git 仓**。
#
# 方案 C(默认,零重编平台):消费方【不】把 sspf 声明为 cargo 依赖,而是用
# .cargo/config.toml 的 rustflags = ["--extern sspf=.../libsspf-hash.rlib", "-L dependency=.../lib"]
# 把平台预编译 rlib 直接喂给 rustc。前提:消费方 rustc 版本 == 包内 rust-toolchain.toml
# (ABI 锁 rustc 1.95.0),否则链接失败。本脚本会自动把包的 rust-toolchain.toml 复制到本仓根。
#
# dev 回退(path 依赖,多一次编译但能改平台):删掉 .cargo/config.toml,并在 Cargo.toml 写
# sspf = { path = "vendor/sspf-vX.Y.Z/crates/sspf", version = "0.5" }
#
# 用法:
# bash scripts/fetch-platform.sh 0.5.0 # 解包 sspf-v0.5.0 → vendor/sspf-v0.5.0/
# bash scripts/fetch-platform.sh # 默认从 Cargo.toml 推断 sspf 版本
#
# 包来源(按优先级):
# 1. 环境变量 SSPF_DIST_DIR 指向目录里的 sspf-vX.Y.Z.tar.gz
# 2. 默认:$HOME/Desktop/workspace/ssw-platform/dist/
# (未来可扩展为从内网 Gitea release 下载;此处先走本地 dist,单机开发够用)
#
set -euo pipefail
cd "$(dirname "$0")/.."
SKILL_ROOT="$(pwd)"
# ── 版本号 ──────────────────────────────────────────────────────
if [[ $# -ge 1 ]]; then
VERSION="$1"
else
VERSION="$(grep -oE 'sspf-v[0-9]+\.[0-9]+\.[0-9]+' Cargo.toml 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)"
if [[ -z "${VERSION}" ]]; then
VERSION="$(grep -oE 'tag = "v[0-9.]+"' Cargo.toml 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)"
fi
if [[ -z "${VERSION}" ]]; then
echo "!! 无法从 Cargo.toml 推断版本,请显式传版本:bash scripts/fetch-platform.sh 0.5.0" >&2
exit 1
fi
fi
# 🔴 目录/包名带 v 前缀,与 git tag(vX.Y.Z)对齐;crate 自身 version 是无 v 的 X.Y.Z
PKG="sspf-v${VERSION}"
TAR="${PKG}.tar.gz"
# ── 定位包 ──────────────────────────────────────────────────────
DIST_DIR="${SSPF_DIST_DIR:-$HOME/Desktop/workspace/ssw-platform/dist}"
if [[ ! -f "${DIST_DIR}/${TAR}" ]]; then
echo "!! 找不到包: ${DIST_DIR}/${TAR}" >&2
echo " 用环境变量 SSPF_DIST_DIR 指定平台仓 dist 目录,或先在平台仓跑过 bash scripts/release.sh" >&2
exit 1
fi
# ── 解包 ────────────────────────────────────────────────────────
echo "==> 解包 ${DIST_DIR}/${TAR} → ${SKILL_ROOT}/vendor/${PKG}/"
mkdir -p vendor
# 🔴 先移走旧包目录:tar 只覆盖同名文件,不会删掉上一个包里【不同 hash】的 rlib;
# 残留与新的混在 lib/ 里会让 `--extern sspf=$(ls libsspf-*.rlib|head -1)` 选到旧 hash
# → 链接报 `could not parse bitcode` / 版本错乱。用 mv(不是 rm -rf)避开 safe-delete 钩子。
if [[ -e "vendor/${PKG}" ]]; then
OLD="/tmp/old_${PKG}_$(date +%s)"
mv "vendor/${PKG}" "${OLD}" && echo "==> 旧包已移走: ${OLD}"
fi
tar -xzf "${DIST_DIR}/${TAR}" -C vendor
echo "${VERSION}" > "vendor/VERSION"
# ── 校验 ────────────────────────────────────────────────────────
if [[ ! -f "vendor/${PKG}/crates/sspf/Cargo.toml" ]]; then
echo "!! 解包结果异常:vendor/${PKG}/crates/sspf/Cargo.toml 不存在" >&2
exit 1
fi
PKGVER="$(grep -m1 '^version' "vendor/${PKG}/crates/sspf/Cargo.toml" | sed -E 's/.*"([^"]+)".*/\1/')"
echo "==> 已就绪:vendor/${PKG}/crates/sspf(包内 sspf 版本 ${PKGVER})"
# ── 方案 C:预编译 rlib 消费方式 ────────────────────────────────
# 1) 锁工具链:把包的 rust-toolchain.toml 复制到消费方根,确保编译器版本与 rlib ABI 一致
if [[ -f "vendor/${PKG}/rust-toolchain.toml" ]]; then
cp "vendor/${PKG}/rust-toolchain.toml" "./rust-toolchain.toml"
PKG_CHANNEL="$(grep -m1 '^channel' "vendor/${PKG}/rust-toolchain.toml" | sed -E 's/.*"([^"]+)".*/\1/')"
echo "==> 已锁工具链:./rust-toolchain.toml → rustc ${PKG_CHANNEL}"
# 校验当前 rustc 是否会按 cwd 选到它(rustup 行为);不一致仅告警,不阻断
ACTIVE="$(rustc --version 2>/dev/null | sed -E 's/rustc ([0-9.]+).*/\1/')"
if [[ -n "${ACTIVE}" && "${ACTIVE}" != "${PKG_CHANNEL}" ]]; then
echo " ⚠️ 当前 rustc=${ACTIVE} ≠ 包要求 ${PKG_CHANNEL};cargo 会按 ./rust-toolchain.toml 自动切到 ${PKG_CHANNEL}(需 rustup 已装该版本)" >&2
fi
else
echo "!! ⚠️ 包内缺 rust-toolchain.toml,无法锁工具链;rlib ABI 匹配无保证" >&2
fi
# 2) 生成 .cargo/config.toml —— 把平台预编译 rlib 直接喂给 rustc(消费方零编译平台闭包)
# 🔴 关键:不仅 sspf,连 axum/tokio/serde/serde_json/http/bytes 也一并从 lib/ 喂(--extern)。
# 原因:sspf 的公共 API 签名里带 `axum::Json` / `http::HeaderMap` / `bytes::Bytes` 等类型。
# 若消费方自己再编一份 axum,就是「同名 crate 的两个实例」(version 相同、hash 不同),
# 跨 sspf 边界传参必报 E0308 mismatched types(实测已踩)。只有让消费方也用 lib/ 里
# 这份预编译的 axum/tokio/...,类型才同源、能对上。
# ⇒ 消费方 Cargo.toml **不要**再声明这些依赖(否则 cargo 又编一份,冲突)。
# 消费方只编译**自己仓库内的 crate**(packs/backend);外部依赖全来自平台包 lib/。
SSPF_RLIB="$(ls vendor/${PKG}/lib/libsspf-*.rlib 2>/dev/null | head -1)"
if [[ -n "${SSPF_RLIB}" ]]; then
# 逐个从 lib/ 找 rlib,生成 --extern 行(缺哪个就跳过)
EXTERN_LINES=""
for c in sspf axum tokio serde serde_json http bytes; do
rl="$(ls "vendor/${PKG}/lib/lib${c}-"*.rlib 2>/dev/null | head -1)"
[[ -z "${rl}" ]] && continue
EXTERN_LINES="${EXTERN_LINES} \"--extern\", \"${c}=${SKILL_ROOT}/${rl}\","$'\n'
done
mkdir -p .cargo
cat > .cargo/config.toml <<EOF
# 自动生成(scripts/fetch-platform.sh)—— 方案 C:预编译 rlib 消费方式
# 把平台预编译 rlib 直接喂给 rustc,消费方【不编译】平台 17 个 crate 闭包,
# 也不编 axum/tokio/serde/serde_json(全部取自平台 lib/,保证与 sspf 同一 crate 实例)。
# ⚠️ 前提:rustc 版本 == vendor/${PKG}/rust-toolchain.toml(ABI 锁,否则链接失败)。
# 回退(path 依赖,多一次编译):删掉本文件 + Cargo.toml 改回 sspf = { path = "vendor/${PKG}/crates/sspf" }
[build]
rustflags = [
${EXTERN_LINES} "-L", "dependency=${SKILL_ROOT}/vendor/${PKG}/lib",
]
EOF
echo "==> 已生成 .cargo/config.toml(--extern sspf/axum/tokio/serde/serde_json/http/bytes + -L dependency)"
echo " 消费方 Cargo.toml 无需声明这些依赖;代码照用 use sspf:: / use axum::"
else
echo "!! ⚠️ 包内 lib/ 缺 libsspf-*.rlib(旧包?)。改用 dev 回退:" >&2
echo " 在 Cargo.toml 写 sspf = { path = \"vendor/${PKG}/crates/sspf\", version = \"${VERSION%.*}\" }" >&2
fi
echo ""
echo "下一步:"
echo " • cargo build (方案 C:直接链接预编译 rlib,零编译平台)"
echo " • 升版本:bash scripts/fetch-platform.sh <新版本>"