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

+18 -8
View File
@@ -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-<target>.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-<target>.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-<target>.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`):