- fetch-platform.sh: 解包加 --exclude=crates/src/frontend/Cargo.toml/Cargo.lock, 只留 lib/ + rust-toolchain.toml + bin/ + docs/README(vendor 少解 ~62M 源码) - 校验改为认 vendor/.../lib/libsspf-*.rlib,不再读 crates/sspf/Cargo.toml - 所有「dev 回退 path 到 vendor 源码」改为「极端回退用 git tag 依赖」 - 文档同步 SKILL/README/HANDOFF 验证: cargo clean 后 dev 5.14s / release 9.34s,只编本仓 5 crate; vendor 无任何平台源码;二进制 --help 正常(基于 sspf v0.5.0)。
142 lines
8.5 KiB
Bash
Executable File
142 lines
8.5 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
#
|
||
# fetch-platform.sh —— 把平台「自包含发布包」解包到 vendor/,让本仓以【方案 C】消费 sspf
|
||
#
|
||
# 背景(2026-11-05 依赖模型变更):平台仓每个版本产出一个自包含包
|
||
# `dist/sspf-vX.Y.Z.tar.gz`(预编译 sspf-admin 二进制 + 预编译 rlib 闭包 lib/ +
|
||
# 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 复制到本仓根。
|
||
#
|
||
# 🔴 本脚本**只解包 rlib 与工具链**(lib/ + rust-toolchain.toml + bin/ + docs/README),
|
||
# 平台源码(crates/、src/、Cargo.toml/lock、frontend/)**不解包**——本仓依赖的是 rlib,不是源码。
|
||
#
|
||
# 极端回退(要改平台源码,很少用):删掉 .cargo/config.toml,改用 git 依赖(见 docs §6.5):
|
||
# sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "vX.Y.Z" }
|
||
#
|
||
# 用法:
|
||
# 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
|
||
# 🔴 只解包 rlib 闭包 + 工具链(+ bin/docs/README),**跳过平台源码**:
|
||
# 本仓依赖的是预编译 rlib;源码(crates/ ~3M + src/ ~59M + Cargo.toml/lock + frontend/)
|
||
# 解进来纯属浪费,还会诱导「path 依赖源码」的旧用法。用 tar 的 --exclude 过滤。
|
||
tar -xzf "${DIST_DIR}/${TAR}" -C vendor \
|
||
--exclude="${PKG}/crates" \
|
||
--exclude="${PKG}/src" \
|
||
--exclude="${PKG}/frontend" \
|
||
--exclude="${PKG}/Cargo.toml" \
|
||
--exclude="${PKG}/Cargo.lock"
|
||
echo "${VERSION}" > "vendor/VERSION"
|
||
|
||
# ── 校验(认 rlib,不认源码)──────────────────────────────────
|
||
if ! ls vendor/${PKG}/lib/libsspf-*.rlib >/dev/null 2>&1; then
|
||
echo "!! 解包结果异常:vendor/${PKG}/lib/libsspf-*.rlib 不存在(包内缺预编译 rlib?)" >&2
|
||
exit 1
|
||
fi
|
||
LIB_N="$(ls -1 "vendor/${PKG}/lib" | wc -l | tr -d ' ')"
|
||
echo "==> 已就绪:vendor/${PKG}/lib(${LIB_N} 个预编译产物,sspf 版本 ${VERSION},纯 rlib 消费)"
|
||
|
||
# ── 方案 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 锁,否则链接失败)。
|
||
# 极端回退(要改平台源码):删本文件 + 改用 git 依赖 sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "v${VERSION}" }
|
||
[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(旧包?)。请用新版 release.sh 重新出包:" >&2
|
||
echo " 或极端回退:删 .cargo/config.toml + 改用 git 依赖(tag = v${VERSION})" >&2
|
||
fi
|
||
|
||
echo ""
|
||
echo "下一步:"
|
||
echo " • cargo build (方案 C:直接链接预编译 rlib,零编译平台)"
|
||
echo " • 升版本:bash scripts/fetch-platform.sh <新版本>"
|