> 本文整理自平台文档 docs/wujies/1.x/package/index.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-85ae844148ea-cover.svg)
这一章讲发布方要做的事:把插件仓库里的一个 wujies-<code>/ 变成能上传、能签名、能被别人的部署真正跑起来的应用包。
前置阅读:[应用清单](/docs/wujies/1.x/plugin-dev/basics/manifest) 说明 app.json 每个字段的含义,[数据库迁移](/docs/wujies/1.x/plugin-dev/advanced/migrations) 说明 migrations/*.sql 怎么写。包被上传之后平台侧接住了什么,见 [应用生命周期](/docs/wujies/1.x/advanced/lifecycle)。
本章分工
| 页 | 解决什么 |
|---|---|
| 本页 | 整条链路有哪几步、每一步落在哪个端点、哪一步动了磁盘 |
| [打包应用](/docs/wujies/1.x/package/build) | package.ps1 完整参数表、产物结构、-Dev 开发包、-Version、纯前端应用 |
| [密钥与签名](/docs/wujies/1.x/package/signing) | 密钥生成、signature.txt 的算法与覆盖范围、就地重签 |
| [上架与发布](/docs/wujies/1.x/package/publish) | 上架端端点表、版本状态流转、市场可见范围 |
| [安全校验模式](/docs/wujies/1.x/package/security-modes) | app-market.security.mode 三种模式与切 enforce 的前置条件 |
日常改代码用[插件开发台](/docs/wujies/1.x/plugin-dev/console)热加载 target/*.jar,前端构建到宿主目录后刷新即可。 需要打 zip 时用 package.ps1 -Dev(不签名、输出到 <code>\dev)。 完整链路(上传 → 发布 → 上架 → 安装)只在第一次安装和发新版本时需要。
发布时会同时碰到三个仓库,别混(依据见 [仓库目录](/docs/wujies/1.x/design/repo-layout)):
| 角色 | 路径 | 与本页相关的部分 |
|---|---|---|
| 后端平台 | wujies-platform/ | 宿主服务、script/sql/ |
| 插件仓库 | wujies/wujies-plugins/ | wujies-<code>/(app.json + 后端 + migrations/)、frontend/<code>-app/(前端工程)、package.ps1(打包)、release.ps1(发布一个版本)、keys/ |
| 宿主前端 | plus-ui/ | 远程产物的提供方;它的 package.json 里 name 是 wujies-admin,check:* 自检脚本在这一侧 |
范例应用是 wujies-hello:一张表 + 四个演示点(调宿主服务 / 跨插件调用 / 开放 /open 接口 / 两种定时任务)。逐文件对照见 [跟着 hello 读源码](/docs/wujies/1.x/plugin-dev/demo)。
---
一次完整发布链路
# 下面的命令都在插件仓库根执行:wujies\wujies-plugins\
# ① 生成密钥(只做一次;目录里已有 private.pem 会直接拒绝,不覆盖)
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Keygen
# ② 发布一个版本(推荐):读源 app.json 的 version → 守卫 → 打包 + 签名 → 打 tag → 推 tag
.\release.ps1 -Plugin wujies-hello
.\release.ps1 -Plugin wujies-hello -DryRun # 干跑:只跑守卫 + 打印计划
.\release.ps1 -Plugin wujies-hello -NoPush # 只在本机打 tag
# ②' 或者只打包、不发布(临时试打)
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 `
-Plugin wujies-hello -SigningKey keys\private.pem
② 的产物落在插件仓库之外的默认输出目录 <插件仓库的上一级>\.plugin-dist\<code>\<version>\ 下,例如 wujies\.plugin-dist\hello\1.0.2\hello-1.0.2.zip 与同名的 .package-info.json(appCode / version / packageSize / packageMd5 / packageSha256 / builtAt)。脚本内部依次做:构建前端远程产物 → 构建后端 jar → 组装包目录 → 签名 → 打 zip 并算校验值。
release.ps1 在打包之后还会打一个附注 tag,约定是 <appCode>-v<version>(例 hello-v1.0.2),于是 git tag -l 'hello-v*' 就是「hello 发布过哪些版本」,release 页面上挂的 zip 也就能与某个确切的提交对上。版本号唯一来源是源 app.json 的 version,它刻意没有 -Version 参数 —— 只改包内清单、不动源文件的用法会造成「源 app.json 写 1.0.1、实际已发到 1.0.4」的漂移。完整说明(守卫清单 / 无 remote 时怎么办 / release 怎么发)见[打包应用](/docs/wujies/1.x/package/build)一页里的「发布一个版本(release.ps1)」一节。
> ⚠️ 历史目录 <插件仓库>/dist-packages/ 没有被删,只是不再往里写(里面可能还有你要用的旧包)。它仍在 .gitignore 里。
包打好之后剩下的动作都在服务端执行,每一步都能单独核对:
| 步 | 动作 | 端点 | 权限 | 做了什么 |
|---|---|---|---|---|
| ③ | 上传 | POST /app/package/parse(multipart:file,可选 appId) | app:console:add | 解包读清单 → 清单校验 → 安全检查(白名单 + 验签)→ 落对象存储;返回 packageUrl / packageSize / packageMd5 / packageSha256 / manifestJson / securityNote |
| ④ | 保存版本 | POST /app/version | app:console:add | 新增一行 app_version,状态 0 待发布 |
| ⑤ | 发布 | POST /app/version/{versionId}/publish | app:console:edit | 状态置 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 | 下载 → 校验校验和 → 安全检查 → 解包落位 → 热加载后端插件 |
| ⑦ | 安装 | POST /app/install | app:install:add | 与部署同一段落位代码,另外执行迁移脚本并同步菜单 |
端点、权限与其余动作(下架、弃用、卸载、任务查询)的完整表见 [上架与发布](/docs/wujies/1.x/package/publish);这几个动作在平台侧各自做了什么见 [应用生命周期](/docs/wujies/1.x/advanced/lifecycle)。
上传、保存、发布、上架都只是登记与状态变更,宿主磁盘上什么都没有。少了部署/安装,应用在市场里看得见、状态也正常,但后端 jar 不在 plugin-dir 里、前端产物不在 frontend-dir/<appCode>/ 下 —— 表现是插件接口回一句 应用「xxx」已启用,但后端产物未加载,请联系管理员重新部署(文案出自 AppRouteHintResolver)、菜单点开是「远程视图不可用」。
打包 → 上传 → 发布 → 上架 → 部署(或安装),少一步就不生效。
### 落位落到哪
AppPackageDeployService.deploy 落三样东西,配置键都在 app-market.deploy.*:
| 产物 | 落点 | 配置键 |
|---|---|---|
| 后端 jar | <plugin-dir>/ 根下 —— `loader.path |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-85ae844148ea-guide.svg)


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