中国 帮助

上架与发布

这一页只讲中心上架服务(wujiesmarket,控制台在 wujiesmarket/web/)从「手上有一个 zip 包」到「租户能在应用市场里装到它」之间的每一步: 接口、版本行字段、状态流转,以及每一步会因为什么被拒绝。 ⚠️ 上

上架与发布
封面

> 本文整理自平台文档 docs/wujies/5.x/platform/package/publish.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-3ff0f9a8b19f-cover.svg)

这一页只讲中心上架服务(wujies-market,控制台在 wujies-market/web/)从「手上有一个 zip 包」到「租户能在应用市场里装到它」之间的每一步: 接口、版本行字段、状态流转,以及每一步会因为什么被拒绝。

> ⚠️ 上架端已经不在平台侧了。2026-11-01 起,平台自带的上架端(AppConsoleController / AppVersionController / > AppPackageController / AppCategoryController 与 wujies-admin 的「应用上架」页面、/appconsole/ 路由)全部删除, > wujies-app-market 只剩 5 个控制器(/app/install、/app/market、/app/runtime、/app/workbench、/app/dev)。 > 传包、建版本、发布、上下架现在都在独立部署的中心上架服务 wujies-market 里做(它把路径 app/console、app/version、 > app/package、app/category 原样复用,但鉴权改成口令换令牌,不再是 Sa-Token 权限点);「部署 / 落位 / 安装」仍只在各部署自己的平台侧。 > 中心服务是私有的,没有公开仓库**,不要把它的地址当公开链接发出去。

前置的、已经在别处写清的三件事不在这里重复:

主题去哪看
包怎么打、包内目录规范[打包应用](/docs/wujies/5.x/platform/package/build)、[打包与上架](/docs/wujies/5.x/platform/package/)
签名、密钥、安全模式(off / warn / enforce)[密钥与签名](/docs/wujies/5.x/platform/package/signing)、[包安全模式](/docs/wujies/5.x/platform/package/security-modes)
平台安装侧端点(落位 / 安装 / 升级 / 就绪度自检)[HTTP 接口索引](/docs/wujies/5.x/platform/reference/api)

下文用 market/… 指代中心服务源码前缀 wujies-market/src/main/java/cn/wujies/market/; 用 market-core/… 指代两端共用的内核 wujies-platform/wujies-modules/wujies-market-core/src/main/java/cn/wujies/appmarket/。

中心服务没有用户表、没有权限点,唯一那道闸是控制台口令:POST /market/login(body {"password":"<控制台口令>"}) 换回一个令牌,后续每个管理请求都放进 X-Market-Token 头。口令由环境变量 MARKET_CONSOLE_PASSWORD 提供, 没配时中心拒绝登录、所有管理接口关闭。要做的四件事(传包、建/改版本、发布、上下架)全靠这一个令牌, 不再区分 app:console:list/add/edit/remove。

---

链路总览:中心服务四个动作都不动磁盘,落位在平台

#动作在哪接口鉴权改了什么
①上传包中心服务POST /app/package/parseX-Market-Token包落到中心磁盘(内容寻址 <sha256>.zip);返回清单、地址与 MD5/SHA256。不落位到任何部署
②保存版本中心服务POST /app/versionX-Market-Token插一行 app_version,status 默认 0
③发布版本中心服务POST /app/version/{versionId}/publishX-Market-Token该行 status=1 + release_time;回写 app_info.latest_version
④上架应用中心服务POST /app/console/{appId}/status?status=1X-Market-Tokenapp_info.status=1;要求 latest_version 非空
⑤落位 / 安装平台(各部署)POST /app/install/version/{versionId}/deploy、POST /app/installapp:install:edit / app:install:add按中心目录里的 package_url 下载 → 校验和 → 安全检查 → 解包落位 → 热加载。只有这一步写宿主磁盘

> ①–④ 全在中心服务、走 X-Market-Token;⑤ 是各部署自己的平台动作、走登录态 + Sa-Token 权限。 > 中心服务没有 /app/version/{id}/deploy —— 部署是「把产物落到这台机器的运行目录」, > 而安装实例表(app_install)在各部署本地、不在中心库。

①②③④ 都只是登记与状态变更,磁盘上什么都没有。产物要等 ⑤(平台「落位」/POST /app/install/version/{versionId}/deploy), 或者等租户在自己那台点「安装」(安装/升级走服务内部的 AppPackageDeployService.deploy(versionId, false),只落位,加载推迟到迁移之后)。

少了 ⑤ 的表现:市场里看得见、点得开,但接口报「应用未安装或未启用」,菜单点开是「远程视图不可用」。

控制台里的顺序与之对应:新增应用(登记 appCode、名称等)→ 版本管理(上传包、保存版本、发布)→ 回应用列表上架。

POST /app/console 新增应用时有四个默认值(都在 market/controller/AppAdminController.java 的 add 方法里):不传 status 落 0 草稿、不传 appType 落 module、不传 installMode 落 optional、 不传 audience 落 tenant。另有两条由服务端强制:latestVersion 置 null(只由发布流程写)、 installCount 置 0;PUT /app/console 同样忽略请求体里的 latestVersion。

appType 在两个接口里都会先过 normalizeAppType:转小写后只接受 module / app / plugin, 其余一律 参数不正确。校验放在服务端是因为写错的值不会立刻报错 —— 它要等到某个租户点安装才炸成 「没有可处理该应用的安装器」,而那时包与迁移可能已经跑过了。deploy 不在白名单里:没有执行器认领它。 新增时留空按 module 登记(与 DDL 默认值一致),编辑时留空表示不改这一列。

---

① 上传包:POST /app/package/parse

项值
请求multipart/form-data(consumes 已声明,别的类型不匹配)
表单字段file(zip,必填)、appId(可选,Long)
鉴权X-Market-Token 头(中心服务)
实现market/controller/PackageAdminController.java 的 parse

appId 传了会先按 ID 查 app_info(不存在报「应用不存在: N」),再用该应用的 app_code 校验包内清单的 code,不一致报「清单中的 code(X) 与所属应用(Y) 不一致」。

限制全部是类里的常量,越界文案如下:

限制值越界时
MAX_PACKAGE_BYTES(PackageAdminController)200MB应用包不能超过 200MB
MAX_MANIFEST_BYTES(market-core 的 AppPackageManifestReader)1MB应用清单超过 1024KB,疑似异常文件
文件名后缀.zip(忽略大小写)应用包必须是 zip 格式,当前文件: <文件名>
清单位置包根 app.json;退一步接受一层嵌套的 */app.json应用包内未找到 app.json,请确认包结构(清单需位于压缩包根目录)

AppPackageManifestReader 会跳过 __MACOSX/ 与目录项;根目录那份优先,一层嵌套那份只作兜底。 不要依赖这个兜底:产物白名单是按 zip 根目录判定的,多套一层会被判成非法顶层目录 (见 [打包应用](/docs

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-3ff0f9a8b19f-guide.svg)

章节导览
THE END

喜欢就支持以下吧

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

回到内容