diff --git a/docs/SSPF-PLATFORM-PACKAGE.md b/docs/SSPF-PLATFORM-PACKAGE.md index 4bd79c6..831b0da 100644 --- a/docs/SSPF-PLATFORM-PACKAGE.md +++ b/docs/SSPF-PLATFORM-PACKAGE.md @@ -264,16 +264,25 @@ rustflags = [ - 因此消费方 **release profile 必须 `lto = false`**(见 §6.4),否则 LTO 找不到 `__bitcode` 段报 `failed to get bitcode from object file for LTO`。 -### 6.2 平台仓出包 +### 6.2 平台仓出包 + 发布(tag / Gitea Release) -打 tag **`vX.Y.Z`**(与 `crates/sspf` 的 `version` 对齐);然后: +**产物名带目标平台后缀**(rlib 与平台/架构绑定,同一版本不同平台是不同包): ```bash -bash scripts/release.sh # 读 crates/sspf 的 version,出 dist/sspf-vX.Y.Z.tar.gz -bash scripts/release.sh 0.5.1 # 或显式指定版本(覆盖 crates/sspf 的 version) +TARGET=$(rustc -vV | sed -n 's/^host: //p') # 如 x86_64-apple-darwin +bash scripts/release.sh 0.5.1 # 出 dist/sspf-v0.5.1-${TARGET}.tar.gz +bash scripts/release.sh 0.5.1 --publish # 出包 + 推 Gitea Release(tag v0.5.1) ``` -产物 `dist/sspf-vX.Y.Z/` 含: +`--publish` 是**幂等**的:① 确认/创建 Gitea Release `vX.Y.Z`(tag 已存在则直接挂上); +② 删除同名旧 asset;③ 上传 `sspf-vX.Y.Z-.tar.gz`。默认 Gitea `http://127.0.0.1:13300`、 +repo `ssw/ssw-platform`,可用 `GITEA_URL` / `GITEA_REPO` / `GITEA_USER` / `GITEA_PASS` 覆盖 +(凭据缺省取本机 `git credential`)。 + +> ⚠️ Gitea 默认附件上限 100M,本包约 146M;本机已把 `[attachment] MAX_SIZE` 调到 500 +> (`persist/gits/gitea/conf/app.ini`,备份 `app.ini.bak-*`)。换环境需同步调大,否则上传 413。 + +产物 `dist/sspf-vX.Y.Z-.tar.gz` 内含(解包后为 `sspf-vX.Y.Z/`): | 路径 | 用途 | |---|---| @@ -295,9 +304,10 @@ bash scripts/release.sh 0.5.1 # 或显式指定版本(覆盖 crates/sspf ### 6.3 消费方怎么接(方案 C,推荐路径) -1. 把 `dist/sspf-vX.Y.Z.tar.gz` 解包到 `vendor/sspf-vX.Y.Z/`。 - **只需 `lib/` + `rust-toolchain.toml` 即可**(不需要平台源码 `crates/`、`src/`)。 - (技能仓:`bash scripts/fetch-platform.sh vX.Y.Z` 自动**只解 rlib + 工具链**并生成 config。) +1. 取包:优先按 **tag + 目标平台** 从 Gitea Release 拉(`sspf-vX.Y.Z-.tar.gz`), + 解包到 `vendor/sspf-vX.Y.Z/`;**只需 `lib/` + `rust-toolchain.toml`**(不需要平台源码)。 + (技能仓:`bash scripts/fetch-platform.sh vX.Y.Z` —— 自动从 Gitea Release 下载、只解 rlib+工具链、 + 生成 config、锁工具链;本地 `dist/` 与 `SSPF_TAR` 作离线回退。) 2. **复制工具链锁**:`cp vendor/sspf-vX.Y.Z/rust-toolchain.toml ./`(确保 rustc 1.95.0)。 3. **生成 `.cargo/config.toml`**(含本机绝对路径,**不要提交**,加进 `.gitignore`): diff --git a/scripts/release.sh b/scripts/release.sh index bbb9621..d0614e7 100755 --- a/scripts/release.sh +++ b/scripts/release.sh @@ -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-.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" < ⚠️ 前提:消费方 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-.rlib", + "--extern", "axum=vendor/sspf-v${VERSION}/lib/libaxum-.rlib", + "--extern", "tokio=vendor/sspf-v${VERSION}/lib/libtokio-.rlib", + "--extern", "serde=vendor/sspf-v${VERSION}/lib/libserde-.rlib", + "--extern", "serde_json=vendor/sspf-v${VERSION}/lib/libserde_json-.rlib", + "--extern", "http=vendor/sspf-v${VERSION}/lib/libhttp-.rlib", + "--extern", "bytes=vendor/sspf-v${VERSION}/lib/libbytes-.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 编一次。 + (\`\` 每版本会变;技能仓 \`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}"