Files
ssw-platform/CHANGELOG.md
T
admin 39201143c5 feat(armv7): 交叉编译 32 位 ARM 平台包,自建 pglite 引擎
上游 pglite-rs 只有 aarch64/x86_64 四架构引擎,没有 armv7 ⇒ 自建。
上游认 PGLITE_LIB_DIR,用它喂自建的 libpglite.a + pglite-runtime.tar。

构建链(amd64 容器 + arm-linux-gnueabihf 交叉工具链 + zig cc 链接):
- build-pglite-engine.sh / build-libpglite-cross.sh / relocate-runtime-cross.sh
- zig-cc-armv7.sh(改写 -Wl,/abs/path + 注入 armhf sysroot)
- build-armv7.sh(一键:引擎 → Rust 交叉编译 → arm/v7 容器冒烟)

三个坑(详见 docs/armv7-build.md):
- strip="symbols" 让 rustc 重建 native 静态库时破坏全局符号 ⇒ 交叉构建强制 strip=none
- PG configure 在 cross_compiling 时假定不支持 --export-dynamic ⇒ 强制 cache 变量
- 上游把 runtime 可移植化拆成独立脚本(RPATH + libpq + libz)⇒ 新增交叉版

release.sh 支持 --target <triple>:跳过宿主消费方编译自检改验架构,
rlib 走隔离目录,解包目录名带 target 后缀(多平台互不覆盖)。

实测(linux/arm/v7 容器):initdb、单用户模式、pglite 读写探针、
sspf-admin 启动 + 14255 条示例数据、登录接口、CurrentUser 菜单树全部通过;
从发布包 tar 解出的二进制端到端复测同样通过。
2026-11-12 20:17:26 +08:00

7.9 KiB
Raw Blame History

CHANGELOG

2026-11-12(v0.5.0 内增量,不升版本号)—— armv7(32 位 ARM)交叉编译与发布

  • 上游 Midwess/pglite-rs 只发布 aarch64/x86_64 四架构引擎,没有 armv7 ⇒ 自建引擎:pglite-rs-sys 0.2.7 的 build.rs 认 PGLITE_LIB_DIR,用它喂自建引擎(上游 engine-06c837c6a303-p3,postgres-pglite commit 06c837c6a303…)。
  • 新增 scripts/build-pglite-engine.sh / build-libpglite-cross.sh / relocate-runtime-cross.sh / zig-cc-armv7.sh / build-armv7.sh:amd64 容器 + gcc-arm-linux-gnueabihf 交叉工具链编 PostgreSQL 17.5,Rust 侧用 zig cc 链接(zig 自带 lld + armv7 libc)。不走 qemu 原生编译(apt 装依赖 9 分钟未完,PG 全量 make 要数小时)。
  • 踩平三个坑(都记在 docs/armv7-build.md):① 仓库 strip="symbols" 会让 rustc 重建 native 静态库、破坏 ProcessStartupPacket/pgl_shmem_reset 全局符号 ⇒ 交叉构建强制 CARGO_PROFILE_RELEASE_STRIP=none;② PG configure 在 cross_compiling=yes 时直接假定不支持 --export-dynamic(postgres 动态导出 0 符号 vs 官方 10802)⇒ 强制 cache 变量 + make 直传 LDFLAGS_EX_BE;③ 上游把 runtime 可移植化拆成独立的 relocate-runtime.sh(RPATH + libpq + libz)⇒ 新增交叉版补上。
  • scripts/release.sh 支持 --target <triple>:交叉出包跳过宿主消费方编译自检、改为二进制架构校验,rlib 走隔离目录 target/rlibbuild-<triple>,解包目录名带 target 后缀(同版本多平台互不覆盖)。
  • 实测(linux/arm/v7 容器):initdb 成功、单用户模式退出码 0、pglite 探针读写全通、sspf-admin 启动并导入 14255 条示例数据(1709 个数据文件)、/api/oauth/Login 返回 token、/api/oauth/CurrentUser 返回 99 菜单节点 + 6 路由。从发布包 tar 解出的二进制端到端复测同样通过。
  • 发布:Gitea Release v0.5.0 追加 sspf-v0.5.0-armv7-unknown-linux-gnueabihf.tar.gz(平台包,自包含——runtime 已 include_bytes! 内嵌进二进制)与 pglite-armv7-unknown-linux-gnueabihf.tar.gz + .sha256(引擎,给二次开发者)。
  • 影响:不带 --target 时 release.sh 行为逐字不变;宿主机 x86_64 构建不受影响。

v0.5.0(2026-11-04,业务库操作收进同一个 Db)

  • 新增 Db::query_json_raw(sql, params):持 Db.lock、row_to_json 包裹、不做 JSON 键归一(f_id 原样返回),给自带归一语义的厚业务仓用。
  • 新增 Db::query_rows(sql, params):持锁返回原始 pglite::Row(pg_catalog 元数据 / 取首行首列),业务仓经 sspf::pglite 引用类型、不必自己声明依赖。
  • 新增 Db::lock_owned() -> OwnedMutexGuard<()>:与所有 Db::* / DbTransaction 共用同一把锁;持 guard 期间可在裸句柄上跑自有 SQL。
  • query_json_inner 拆成共用的 query_json_inner_raw(包裹 + 反序列化)+ 归一那一层 ⇒ SQL 包裹只有一份;query_json* 行为一字未改。
  • 新增闸门 AR20(raw 不归一 / 共用包裹段 / 公开入口全持同一把锁)+ 反自证 15/15;新增探针 db_raw_it.rs(4 条:raw 键不归一、归一路径同时成立、guard 期间 Db::exec 被阻塞、query_rows 读 pg_catalog)。
  • Db::pg() 文档补「要与平台共用串行域该走哪个入口」的指路表;销掉 v0.3.0 的「双锁」已知局限(docs/known-limitations.md 的 (bq))。
  • 影响:面 A / 面 B 端点形状、码表、表结构零变化;Platform 的公开签名未改(Finish::default() 路径逐字等价)。sspf 版本 0.5.0。
  • 新增 scripts/release.sh:读 crates/sspf 版本 → cargo build --release -p sspf-admin → 组装自包含发布包 dist/sspf-vX.Y.Z.tar.gz(预编译 sspf-admin 二进制 + 平台 crate 源码闭包 17 个 + src/backend + Cargo.lock + rust-toolchain.toml + 前端源码)。 消费方(技能仓 / 业务仓)解包到 vendor/ 用 path 依赖接入,不再直接依赖 git 仓、不再 clone 整个 monorepo、不再每次重编 20+ crate。详见 docs/SSPF-PLATFORM-PACKAGE.md §6。

2026-11-06(v0.5.0 内增量,不升版本号)

  • 官方示例数据对齐:以 jnpf_dbnull_init.sql 为真值源生成 demo_seed.sql(58 表 / 14242 行)并缺省导入;补 base_province / base_language / base_province_atlas 修掉三个空页面;DDL 幂等化。
  • 修静态托管相对路径 bug:SSW_STATIC_DIR 在配置解析时按 CWD 绝对化(PGlite 会 chdir,否则 / 全返 JSON 404)。
  • 新增 scripts/pack-jnpf-assets.sh:独立产出 dist/jnpf-7.0-assets.tar.gz(官方 web 静态前端 + 示例数据库 + manifest/SHA256SUMS)。资产包只绑定 JNPF 版本,与 sspf 版本 / OS / CPU / 工具链 / 部署环境无关,所有平台复用一份。
  • 新增 SSW_ASSETS_DIR(一个 env 同时定位 web/ 与 db/demo_seed.sql)、SSW_DEMO_SEED_FILE;外置示例数据优先、编译期内嵌兜底 ⇒ 换 JNPF 演示数据不必重编二进制。
  • scripts/release.sh 的 web/ 改以资产包为唯一真源,新增 --no-web 完全剥离静态前端;README 补两种消费方式。
  • 影响:不设新 env 时行为逐字不变;50 个 lib 单测通过、解包资产包端到端启动验证通过。差异明细见 docs/AB-COMPARE-2026-11-06.md。
  • 发布:平台包覆盖上传到 Gitea Release v0.5.0;资产包发到独立 release jnpf-assets-7.0(附 .sha256)。pack-jnpf-assets.sh --publish 幂等重发(同名 asset 先删后传、tag 不存在自动推),不依赖 sspf 发版。

v0.4.0(2026-11-04,平台包零业务清理)

  • 4 个示例业务包与 modules/ 的 4 个面 A 适配器整体移出本仓;packs/ 与 sspf-pack-* 依赖、 example-packs feature、门面 example_packs() 全部移除。
  • sspf-admin 改为纯平台装配:只剩 177 张平台表,面 A 无业务端点;业务改由 sspf::Platform::packs/ddl/menus/router 注入。
  • 生成器 pack-sync.py 把「零包」钉成合法目标态:四处派生位置恒空,出现业务包直接报错。
  • 静态闸门(CP1 / check-module / 契约反自证)与运行时尺子(面 A 21 条、包冒烟)改跑防回流断言:示例业务回流平台仓立即红。
  • 纯业务测试 crud_it.rs 与 new-pack 脚手架随示例移交技能仓;db_it / batch7_it / auth_it 改用平台内置夹具。
  • 门面 sspf 的 cargo 版本同步为 0.4.0(与 tag 一致);技能仓按 tag = "v0.4.0" 锁依赖。
  • 影响:本仓不再自带可跑的业务示例,集成测试数下降;verify.sh --smoke 需先 cargo build --release -p sspf-admin。

v0.3.0(2026-11-04)

  • 新增两阶段装配 Platform::assemble() / Assembled::finish() / serve() 与 Finish 注入点:自带状态类型的业务路由可挂进平台唯一装配链,业务状态可在开库后构造。
  • Db 改用 Arc<PGlite> 并公开 pg() ⇒ 业务仓与平台共用一个库句柄,不必另开 PGlite;Db::clone() 语义不变。
  • Extras 新增自带状态路由 / 可替换兜底 / 全局 middleware 层三个注入点;with_state 前移到 merge 之前,build_app() 默认路径行为不变。
  • 面 A / 面 B、base_* 表、cipher、602 码、panic ⇒ 200 + code=400 全部保持不变;v0.2.0 的公开签名未改。
  • 新增集成探针 business_composition_it.rs 与闸门 AR19(唯一装配链,反自证 14/14);sspf 版本 0.3.0。
  • 已知局限:Db::pg() 绕过 Db.lock 时,平台与业务各自的多语句事务可能交错;业务 413 响应由平台改写为信封。见 docs/known-limitations.md。

v0.2.0(2026-11-04)

  • 新增门面 crate sspf:业务仓唯一依赖,Platform builder + runtime 启动动作;sspf-admin 退化为 CLI 薄壳。
  • 4 个示例包降为 example-packs feature ⇒ 默认依赖树不含 sspf-pack-*;新增 AR17 / AR18 与仓外消费探针。