> 本文整理自平台文档 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/parse | app:console:add | 包存入对象存储;返回清单、地址与 MD5/SHA256。不落位 |
| ② | 保存版本 | POST /app/version | app:console:add | 插一行 app_version,status 默认 0 |
| ③ | 发布版本 | POST /app/version/{versionId}/publish | app:console:edit | 该行 status=1 + release_time;回写 app_info.latest_version |
| ④ | 上架应用 | POST /app/console/{appId}/status?status=1 | app:console:edit | app_info.status=1;要求 latest_version 非空 |
| ⑤ | 部署 | POST /app/version/{versionId}/deploy | app: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_BYTES | 200MB | 应用包不能超过 200MB |
MAX_MANIFEST_BYTES | 1MB | 应用清单超过 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 | 整包字节数与两个摘要,部署时逐项校验 |
securityNote | PackageSecurityInspector 的一句话结论(签名是否有效、白名单有无问题) |
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)


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