中国 帮助

上架与发布

这一页只讲上架端(/appconsole)从「手上有一个 zip 包」到「租户能在应用市场里装到它」之间的每一步: 接口、版本行字段、状态流转,以及每一步会因为什么被拒绝。 前置的、已经在别处写清的三件事不在这里重复: 主题 去哪看

上架与发布
封面

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

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

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

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

主题去哪看
包怎么打、包内目录规范[打包应用](/docs/wujies/1.x/package/build)、[打包与上架](/docs/wujies/1.x/package/)
签名、密钥、安全模式(off / warn / enforce)[密钥与签名](/docs/wujies/1.x/package/signing)、[包安全模式](/docs/wujies/1.x/package/security-modes)
全部端点索引(含安装侧、运行时、目录服务)[HTTP 接口索引](/docs/wujies/1.x/reference/api)

下文用 app-market/… 指代后端源码前缀 wujies-platform/wujies-modules/wujies-app-market/src/main/java/cn/wujies/appmarket/。

1. 形态必须是官方版:app-market.edition 为 official(默认)。用户版(client)下 /app/console、/app/version、/app/package 的全部方法,以及 /app/category 的写方法会被 MarketEditionGuardFilter 拦成 403;唯一例外是 GET /app/console/owned-menus(菜单管理页要用)。 前缀与例外写在 app-market/edition/MarketEdition.java 的 PUBLISH_PREFIXES / PUBLISH_ALLOWLIST。 形态机制见 [目录中心化与版本形态](/docs/wujies/1.x/advanced/catalog-and-edition)。 2. 四个权限点:app:console:list 看、app:console:add 传包与新建、app:console:edit 改 / 发布 / 弃用 / 部署 / 上下架、app:console:remove 删。

---

链路总览:五个动作,只有最后一个动磁盘

#动作接口权限改了什么
①上传包POST /app/package/parseapp:console:add包存入对象存储;返回清单、地址与 MD5/SHA256。不落位
②保存版本POST /app/versionapp:console:add插一行 app_version,status 默认 0
③发布版本POST /app/version/{versionId}/publishapp:console:edit该行 status=1 + release_time;回写 app_info.latest_version
④上架应用POST /app/console/{appId}/status?status=1app:console:editapp_info.status=1;要求 latest_version 非空
⑤部署POST /app/version/{versionId}/deployapp:console:edit下载 → 校验和 → 安全检查 → 解包落位 → 热加载。只有这一步写宿主磁盘

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

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

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

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

---

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

项值
请求multipart/form-data(consumes 已声明,别的类型不匹配)
表单字段file(zip,必填)、appId(可选,Long)
权限app:console:add
实现app-market/controller/AppPackageController.java 的 parse

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

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

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

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

返回值 AppPackageParseVo(app-market/domain/vo/AppPackageParseVo.java):

字段含义
manifestJson清单。注意它是解析后重新序列化的结果(JsonUtils.toJsonString(manifest)),不是包内原文的字节
code / name / version / engine清单里的应用编码、名称、版本号、平台版本约束
menuCount菜单数量,递归含子级
packageUrl对象存储地址,原样填进版本行
packageSize / packageMd5 / packageSha256整包字节数与两个摘要,部署时逐项校验
securityNotePackageSecurityInspector 的一句话结论(签名是否有效、白名单有无问题)

parse 的顺序是:解包读清单 → 清单校验 → sysOssService.upload(file) → packageSecurityInspector.inspectOrThrow(...)。 所以在 enforce 模式下被拒的那次上传,对象存储里已经多了一份对象,平台没有对应的清理分支 —— 要清只能自己按 packageUrl(或 OSS 后台)处理。warn 模式下这里只提示、不阻断。

---

② 保存版本:POST /app/version(版本行字段)

请求体就是 AppVersion 实体(表 app_version,源码 app-market/domain/AppVersion.java)。 每列的来源分三种:请求体、清单派生、服务端强制。分不清就会写出「传了却不生效」或 「不传就 500」的代码。

属性 / 列来源说明
versionId / version_id服务端强制新增时置 null;修改时必须传,否则报「版本ID不能为空」
appId / app_id请求体(新增必填)

本文导览

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容