中国 帮助

中心目录:一个应用怎么上架、分发和升级

应用包不是随便一个 zip:包结构、清单、签名、迁移脚本都过检查。中心目录保存应用和版本两条台账,租户侧的安装任务则把下载、校验、落盘、迁移、菜单注册串成一条可回滚的链。

中心目录:一个应用怎么上架、分发和升级

上架不是传个 zip

一个能被安装的应用包有固定结构:app.json 清单、route-index.json 路由、后端 jar、frontend/ 前端产物、migrations/ 迁移脚本,以及 signature.txt 签名。包检查器会扫路径穿越、非法条目与清单字段;主题包的资源统一放在 frontend/themes/<code>/ 与 frontend/templates/cms/<code>/ 下,和插件包走同一套规范。

a

中心目录存什么

中心库里有两层台账:app_info 存应用(编码、名称、类型、作者、标签、安装模式、最新版本、状态),app_version 存版本(版本号、包地址、包大小、校验值、变更日志、清单 JSON)。类型现在只有应用 / 插件 / 主题三类 —— 内置模块是宿主自带功能,由 ModuleAppInstaller 注册菜单,没有可安装产物,不该出现在市场里。

清单 JSON 很关键:租户侧装应用时,菜单、权限与前端路由都从它解析,导入时字符集不对会直接把乱码名字带进租户侧,所以种子 SQL 头部必须声明 SET NAMES utf8mb4。

租户点「安装」之后

b

后端不是解压完就算完,而是一条逐步记录的任务:下载包 → 校验签名与大小 → 落盘到 plugins-dist → 执行迁移脚本 → 注册菜单与权限 → 刷新路由 → 装载插件运行时。每一步都有日志,失败时能一眼看到断在哪。

升级复用同一条链,只是把「落盘」换成「备份旧包 + 换新包」,迁移按编号增量执行。卸载反过来,但菜单归属规则决定了哪些节点能删、哪些是用户改过要保留的。

关于版本

同一个应用的版本号在三个地方要同步:app.json 的 version、assets.backend 里的 jar 文件名、README 里的版本号与 jar 名。漏一处,装上去的表现就是「版本对不上包」。仓库里有个 bump-app-version.cjs 专门干这件事,别手改。

THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容