feat(release): 按 tag+目标平台发包到 Gitea Release(--publish)+ 修包内 README

- release.sh: 产物名带 target 后缀(sspf-vX.Y.Z-<target>.tar.gz,rlib 与平台绑定)
- 新增 --publish:幂等创建/复用 Gitea Release(tag vX.Y.Z) → 删同名 asset → 上传
  (GITEA_URL/REPO/USER/PASS 可覆盖;凭据缺省取本机 git credential)
- 修 README 模板:删掉「保留 axum/tokio 依赖、自己编一次」的旧说法(与 §6.3 矛盾),
  改为「全走 --extern 取 lib/、Cargo.toml 不声明、release 必须 lto=false、注明目标平台」
- docs §6.2/6.3 同步:--publish 用法、Gitea 附件上限 100M→本机已调 500 的告警
This commit is contained in:
admin committed 2026-11-05 13:45:17 +08:00
1 parent 86859a77e2
commit 3f2d56be20
2 files changed
+152 -24

No files matched your search

+134 -16
View File
@@ -46,8 +46,17 @@
# 消费方只需保留**自己代码直用**的依赖(如 axum/tokio/serde/serde_json),这些它本来就要编。
#
# 用法:
# bash scripts/release.sh # 以 crates/sspf 的 version 为版本号出包
# bash scripts/release.sh 0.5.1 # 显式指定版本(覆盖 crates/sspf 的 version)
# bash scripts/release.sh # 以 crates/sspf 的 version 为版本号出包
# bash scripts/release.sh 0.5.1 # 显式指定版本(覆盖 crates/sspf 的 version)
# bash scripts/release.sh 0.5.1 --publish # 出包并**推到 Gitea Release**(tag v0.5.1)
#
# 产物:dist/sspf-vX.Y.Z-<target>.tar.gz(如 sspf-v0.5.1-x86_64-apple-darwin.tar.gz)
# 发布:Gitea Release tag=vX.Y.Z,asset=<同上>;消费方 fetch-platform.sh 按 tag+target 拉取
#
# 环境变量(发布用):
# GITEA_URL 默认 http://127.0.0.1:13300
# GITEA_REPO 默认 ssw/ssw-platform
# GITEA_USER / GITEA_PASS 不给则从 git credential(本机 keychain)取
#
set -euo pipefail
@@ -55,9 +64,18 @@ set -euo pipefail
cd "$(dirname "$0")/.."
export REPO_ROOT="$(pwd)"
# ── 1. 决定版本号 ──────────────────────────────────────────────
if [[ $# -ge 1 ]]; then
VERSION="$1"
# ── 1. 解析参数 + 决定版本号 ───────────────────────────────────
PUBLISH=0
POSITIONAL=()
for _a in "$@"; do
case "${_a}" in
--publish) PUBLISH=1 ;;
-h|--help) sed -n '1,64p' "$0"; exit 0 ;;
*) POSITIONAL+=("${_a}") ;;
esac
done
if [[ ${#POSITIONAL[@]} -ge 1 ]]; then
VERSION="${POSITIONAL[0]}"
else
VERSION="$(python3 - <<'PY'
import re,os
@@ -73,6 +91,13 @@ PKG="sspf-v${VERSION}"
DIST_DIR="dist"
export PKG_DIR="${DIST_DIR}/${PKG}"
# 🔴 目标平台(rlib 与 平台/架构 绑定,同一版本不同平台必须是不同的包)
TARGET="$(rustc -vV 2>/dev/null | sed -n 's/^host: //p')"
TARGET="${TARGET:-unknown}"
# 本仓 git URL(README 里的「极端回退」写法用;去掉 .git 后缀)
GIT_URL="$(git remote get-url origin 2>/dev/null | sed 's/\.git$//')"
GIT_URL="${GIT_URL:-http://127.0.0.1:13300/ssw/ssw-platform}"
echo "==> 出包版本: ${VERSION}"
echo "==> 目标目录: ${PKG_DIR}"
@@ -239,28 +264,41 @@ cat > "${PKG_DIR}/README.md" <<EOF
## 消费方怎么用(方案 C:预编译 rlib,零重编平台)
> ⚠️ 前提:消费方 rustc 版本 == 包内 \`rust-toolchain.toml\` 的版本($(grep -m1 '^channel' rust-toolchain.toml | sed 's/.*= *"//;s/"//'))。不符则链接失败。
> ⚠️ 前提:① 消费方 rustc 版本 == 包内 \`rust-toolchain.toml\` 的版本($(grep -m1 '^channel' rust-toolchain.toml | sed 's/.*= *"//;s/"//')),不符则链接失败;
> ② 本包是 **${TARGET}** 平台产物(rlib 与目标平台/架构绑定),其他平台需取对应平台的包。
1. 把本包解包到消费方仓库的 \`vendor/sspf-v${VERSION}/\`。
2. **复制工具链锁**:\`cp vendor/sspf-v${VERSION}/rust-toolchain.toml ./rust-toolchain.toml\`(消费方根),确保编译器同版本。
3. **喂预编译 rlib**:在消费方 \`.cargo/config.toml\` 加(路径按实际 libsspf-hash.rlib 调整):
**只需 \`lib/\` + \`rust-toolchain.toml\`**;平台源码 \`crates/\`、\`src/\` 仅 dev 回退用,可不解包。
2. **复制工具链锁**:\`cp vendor/sspf-v${VERSION}/rust-toolchain.toml ./rust-toolchain.toml\`(消费方根)。
3. **生成 \`.cargo/config.toml\`**(含本机绝对路径,**勿提交**)—— 必须把 **sspf 与 sspf 公共 API 涉及的外部 crate 一起** 喂进去:
\`\`\`toml
[build]
rustflags = [
"--extern", "sspf=vendor/sspf-v${VERSION}/lib/libsspf-<hash>.rlib",
"--extern", "axum=vendor/sspf-v${VERSION}/lib/libaxum-<hash>.rlib",
"--extern", "tokio=vendor/sspf-v${VERSION}/lib/libtokio-<hash>.rlib",
"--extern", "serde=vendor/sspf-v${VERSION}/lib/libserde-<hash>.rlib",
"--extern", "serde_json=vendor/sspf-v${VERSION}/lib/libserde_json-<hash>.rlib",
"--extern", "http=vendor/sspf-v${VERSION}/lib/libhttp-<hash>.rlib",
"--extern", "bytes=vendor/sspf-v${VERSION}/lib/libbytes-<hash>.rlib",
"-L", "dependency=vendor/sspf-v${VERSION}/lib",
]
\`\`\`
4. 消费方 \`Cargo.toml\` **不要**把 sspf 声明成依赖(去掉 \`[workspace.dependencies] sspf\` 与成员里的 \`sspf = { workspace = true }\`);但**保留你自己代码直用的依赖**(如 axum/tokio/serde/serde_json)——这些你本来就要编。sspf 与其余 12 个 registry 依赖(aes/chrono/uuid/...)+ 全部传递依赖都已在 \`lib/\` 预编译好,靠 \`-L dependency\` 直接链接,**无需在消费方重新声明、也无需重编**。
5. \`cargo build\` 即可——平台内部 crate **不编译**,直接链接 \`lib/\` 预编译 rlib;只有你代码直用的少数依赖(tokio/serde/axum/...)会按你自己的 feature 编一次。
(\`<hash>\` 每版本会变;技能仓 \`fetch-platform.sh\` 会自动生成,无需手写。)
4. 消费方 \`Cargo.toml\` **不要声明** \`sspf\` / \`axum\` / \`tokio\` / \`serde\` / \`serde_json\` —— 它们全部来自 \`lib/\`。
**若自己再编一份 axum,就是「同名 crate 两个实例」(同 version、不同 hash),跨 sspf API 边界传参必报
\`E0308 mismatched types\`(multiple different versions of crate 'axum')**。sspf 的全部 16 个 registry 依赖
+ 传递依赖都已在 \`lib/\` 预编译好,无需声明、无需重编。
5. **release profile 必须 \`lto = false\`**:预编译 rlib 是 bitcode-free 的,开 LTO 会
\`failed to get bitcode from object file for LTO\`。平台 rlib 已 opt-level=2,损失很小。
6. \`cargo build\` —— 平台闭包与 axum/tokio 全部**不编译**,直接链接 \`lib/\` 预编译 rlib。
### dev 回退(path 依赖,多一次编译但能改平台)
### 极端回退(要改平台源码):改用 git 依赖
若版本不符或要改平台源码:在 \`Cargo.toml\` 写 \`sspf = { path = "vendor/sspf-v${VERSION}/crates/sspf", version = "${VERSION%.*}" }\`,去掉上面的 rustflags 即可。
详见平台仓 \`docs/SSPF-PLATFORM-PACKAGE.md\` §6。
在 \`Cargo.toml\` 写 \`sspf = { git = "${GIT_URL}", tag = "v${VERSION}" }\`,把 axum/tokio 等改回 registry 依赖,
删掉 \`.cargo/config.toml\` 即可(多一次编译,但能改平台源码)。详见平台仓 \`docs/SSPF-PLATFORM-PACKAGE.md\` §6。
## 工具链
@@ -270,10 +308,82 @@ EOF
echo "==> README.md"
# ── 4. 打 tar.gz ───────────────────────────────────────────────
TAR="${DIST_DIR}/${PKG}.tar.gz"
TAR="${DIST_DIR}/${PKG}-${TARGET}.tar.gz"
tar -czf "${TAR}" -C "${DIST_DIR}" "${PKG}"
TAR_SIZE="$(du -h "${TAR}" | cut -f1)"
echo "==> 已打包: ${TAR} (${TAR_SIZE})"
echo "==> 已打包: ${TAR} (${TAR_SIZE}) [target=${TARGET}]"
# ── 4.5 发布辅助(--publish):推到 Gitea Release ───────────────
# 幂等:release 已存在则复用;同名 asset 已存在则先删后传。
publish_to_gitea() {
local base="${GITEA_URL:-http://127.0.0.1:13300}"
local repo="${GITEA_REPO:-ssw/ssw-platform}"
local tag="v${VERSION}"
local asset_name; asset_name="$(basename "${TAR}")"
local user="${GITEA_USER:-}" pass="${GITEA_PASS:-}"
if [[ -z "${user}" || -z "${pass}" ]]; then
local cred
cred="$(printf 'protocol=http\nhost=%s\n\n' "${base#http://}" | GIT_TERMINAL_PROMPT=0 git credential fill 2>/dev/null || true)"
user="$(printf '%s\n' "${cred}" | sed -n 's/^username=//p')"
pass="$(printf '%s\n' "${cred}" | sed -n 's/^password=//p')"
fi
if [[ -z "${user}" || -z "${pass}" ]]; then
echo "!! 发布失败:无 Gitea 凭据(设 GITEA_USER/GITEA_PASS,或配置 git credential)" >&2
return 1
fi
local -a AUTH=(-u "${user}:${pass}")
# 1) release:有则复用,无则创建(tag 已存在时 Gitea 直接挂到该 tag)
local code rel_id
code="$(curl -s -o /tmp/sspf_rel.json -w '%{http_code}' --noproxy '*' -m 20 "${AUTH[@]}" \
"${base}/api/v1/repos/${repo}/releases/tags/${tag}" || true)"
if [[ "${code}" == "200" ]]; then
rel_id="$(python3 -c 'import json;print(json.load(open("/tmp/sspf_rel.json"))["id"])')"
echo "==> 复用已有 release ${tag} (id=${rel_id})"
else
code="$(curl -s -o /tmp/sspf_rel.json -w '%{http_code}' --noproxy '*' -m 30 "${AUTH[@]}" \
-X POST "${base}/api/v1/repos/${repo}/releases" \
-H 'Content-Type: application/json' \
-d "{\"tag_name\":\"${tag}\",\"name\":\"sspf ${tag}\",\"target_commitish\":\"main\",\"body\":\"sspf 平台包 ${tag}(${TARGET};方案 C 预编译 rlib 闭包)\"}" || true)"
if [[ "${code}" != "201" ]]; then
echo "!! 创建 release ${tag} 失败 (HTTP ${code}): $(head -c 300 /tmp/sspf_rel.json)" >&2
return 1
fi
rel_id="$(python3 -c 'import json;print(json.load(open("/tmp/sspf_rel.json"))["id"])')"
echo "==> 已创建 release ${tag} (id=${rel_id})"
fi
# 2) 同名 asset 先删(幂等重传)
local old_id
old_id="$(curl -s --noproxy '*' -m 20 "${AUTH[@]}" \
"${base}/api/v1/repos/${repo}/releases/${rel_id}/assets" \
| python3 -c "
import json,sys
try: d=json.load(sys.stdin)
except Exception: d=[]
for a in d:
if a.get('name')=='${asset_name}': print(a['id']); break
" 2>/dev/null || true)"
if [[ -n "${old_id}" ]]; then
curl -s -o /dev/null --noproxy '*' -m 30 "${AUTH[@]}" \
-X DELETE "${base}/api/v1/repos/${repo}/releases/${rel_id}/assets/${old_id}" || true
echo "==> 已删除同名旧 asset (id=${old_id})"
fi
# 3) 上传(Gitea multipart 字段名 attachment)
code="$(curl -s -o /tmp/sspf_asset.json -w '%{http_code}' --noproxy '*' -m 900 "${AUTH[@]}" \
-X POST "${base}/api/v1/repos/${repo}/releases/${rel_id}/assets?name=${asset_name}" \
-F "attachment=@${TAR}" || true)"
if [[ "${code}" != "201" ]]; then
echo "!! 上传 asset 失败 (HTTP ${code}): $(head -c 300 /tmp/sspf_asset.json)" >&2
return 1
fi
local dl
dl="$(python3 -c 'import json;print(json.load(open("/tmp/sspf_asset.json")).get("browser_download_url",""))')"
echo "==> ✅ 已发布 ${tag} / ${asset_name} ($(du -h "${TAR}" | cut -f1))"
echo " ${dl}"
return 0
}
# ── 5. 自检:包内 path 依赖闭包能否被最小消费方离线编译 ────────
echo "==> 自检验证中(构造最小消费方,--offline 编译)"
@@ -360,6 +470,14 @@ else
fi
# 保留临时目录(mktemp 由系统回收;rm -rf 大目录会触发 safe-delete 钩子)
# ── 6. 发布(--publish)───────────────────────────────────────
if [[ "${PUBLISH}" == "1" ]]; then
echo "==> 发布到 Gitea Release ..."
publish_to_gitea || { echo "!! 发布失败(本地包仍在 ${TAR})" >&2; exit 1; }
else
echo "==> 未发布(加 --publish 推到 Gitea Release;或手动上传 ${TAR})"
fi
echo ""
echo "=================================================="
echo "✅ 出包完成: ${PKG}"