> 本文整理自平台文档 docs/wujies/5.x/platform/package/index.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-80658667af09-cover.svg)
这一章讲发布方要做的事:把一个 wujies-<code>-plugin 应用仓库里的后端模块 + 前端工程,变成能上传、能签名、能被别人的部署真正跑起来的应用包。
前置阅读:[应用清单](/docs/wujies/5.x/platform/plugin/basics/manifest) 说明 app.json 每个字段的含义,[数据库迁移](/docs/wujies/5.x/platform/plugin/advanced/migrations) 说明 migrations/*.sql 怎么写。包被上传之后平台侧接住了什么,见 [应用生命周期](/docs/wujies/5.x/platform/app-market/lifecycle)。
本章分工
| 页 | 解决什么 |
|---|---|
| 本页 | 整条链路有哪几步、每一步落在哪个端点、哪一步动了磁盘 |
| [打包应用](/docs/wujies/5.x/platform/package/build) | package.ps1 完整参数表、产物结构、-Dev 开发包、-Version、纯前端应用 |
| [密钥与签名](/docs/wujies/5.x/platform/package/signing) | 密钥生成、signature.txt 的算法与覆盖范围、就地重签 |
| [上架与发布](/docs/wujies/5.x/platform/package/publish) | 中心上架服务的端点表、口令换令牌(X-Market-Token)、版本状态流转、市场可见范围 |
| [安全校验模式](/docs/wujies/5.x/platform/package/security-modes) | app-market.security.mode 三种模式与切 enforce 的前置条件 |
日常改代码用[插件开发台](/docs/wujies/5.x/platform/plugin/console)热加载 target/*.jar,前端构建到宿主目录后刷新即可。 需要打 zip 时用 package.ps1 -Dev(不签名、输出到 <code>\dev)。 完整链路(上传 → 发布 → 上架 → 安装)只在第一次安装和发新版本时需要。
发布时会碰到下面这几套仓库,别混(依据见 [仓库目录](/docs/wujies/5.x/platform/architecture/repo-layout))。开发入口是应用仓库,「单体仓库」那行只是历史、不是你要去的地方:
| 角色 | 路径 | 与本页相关的部分 |
|---|---|---|
| 后端平台 | wujies/wujies-platform/ | 宿主服务、script/sql/ |
| 单体仓库(历史,非入口) | wujies/wujies-plugins/(Gitee 已取不到) | 拆仓前的母本:wujies-<code>/ 历史副本、frontend/hello-app 旧模板、release.ps1 / new-plugin.ps1 等旧批量脚本都留在这里,现已不作为开发入口;打包改用各应用仓库自带的 package.ps1,新建应用改用 wujies/tools/create-plugin/create-plugin.mjs |
| 应用仓库 | wujies/plugins/wujies-<code>-plugin/(12 个,与 wujies-admin/ 同级;11 个已发布在 https://gitee.com/wujies,wujies-cms-plugin 未发布) | 该应用的后端模块(pom.xml + src/)+ frontend/ 前端工程(npm,依赖 @wujies/*@^5.6.5)+ app.json + migrations/ + package.ps1 完整打包脚本(同源由 wujies-plugins/scripts/sync-package-script.mjs 同步,11 个已发布仓库那份 sha256 前缀 14a68f5c7d18;wujies-cms-plugin 那份有差异)+ package.cmd(双击入口)+ keys/。⚠️ 没有 release.ps1 |
| 宿主前端 | wujies/wujies-admin/(旧名 plus-ui/,工作区根的 plus-ui/ 是搬迁前的空目录,别在那里跑命令) | 远程产物的提供方;npm run tools:check 自检脚本在这一侧,开发台「打包抽屉」的页面也在这里 |
| 中心上架服务 | wujies/wujies-market/(私有服务,没有公开仓库,不要把它的地址当公开链接发出去) | 传包、建/改版本、发布、上下架都在这里做(控制台 wujies-market/web/ 编进 jar,与 API 同源);包按内容寻址落在它自己的磁盘。平台侧的上架端 2026-11-01 已删除,见 [上架与发布](/docs/wujies/5.x/platform/package/publish) |
范例应用是 wujies-hello:一张表 + 四个演示点(调宿主服务 / 跨插件调用 / 开放 /open 接口 / 两种定时任务)。逐文件对照见 [跟着 hello 读源码](/docs/wujies/5.x/platform/plugin/demo)。
---
一次完整发布链路
# 下面的命令都在**应用仓库根**执行:wujies\plugins\wujies-gallery-plugin\
# ① 生成密钥(只做一次;目录里已有 private.pem 会直接拒绝,不覆盖)
powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1 -Keygen
# ② 打包 + 签名(读 app.json 的 version → 体检 → 构建 → 用 keys\private.pem 签名 → 出 zip)
powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1
# ③ 出包后在 git 上留一个可回溯、可下载的版本点(附注 tag,约定 <appCode>-v<version>)
git tag -a gallery-v1.0.5 -m "gallery 1.0.5"
git push <remote> gallery-v1.0.5
# ②' 只想临时试打(开发包,不签名、落 <code>\dev)
powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1 -Dev
> ℹ️ 发版就用上面这一套:在应用仓库根用自带的 package.ps1 出包,再手工补一个附注 tag(约定 <appCode>-v<version>,如 gallery-v1.0.5)。 > 12 个应用仓库都不带 release.ps1;打 tag、推 tag 直接对各自仓库做即可: > > ``powershell > cd wujies\plugins\wujies-gallery-plugin > powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1 # 体检 + 构建 + 打包 + 签名 > powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1 -Dev # 开发包(不签名,装到本机宿主) > git tag -a gallery-v1.0.5 -m "gallery 1.0.5" # 留一个版本点 > git push <remote> gallery-v1.0.5 > ` > > 单体仓库 wujies/wujies-plugins/ 里那份 release.ps1`(打包 → 打 tag → 推 tag 的批量脚本)已经不作为发布入口:拆仓后 Gitee 上取不到,应用仓库也不带它。 > 它的 tag 约定与前置守卫(工作区干净、版本不倒退、私钥就位等)仍然有参考价值,见[打包应用](/docs/wujies/5.x/platform/package/build)的「发布一个版本」一节。
② 的产物落在应用仓库之外的默认输出目录 <应用仓库的上一级>\.plugin-dist\<code>\<version>\ 下,例如 wujies\plugins\.plugin-dist\gallery\1.0.5\gallery-1.0.5.zip 与同名的 .package-info.json(appCode / version / packageSize / packageMd5 / packageSha256 / builtAt)。脚本内部依次做:构建前端远程产物 → 构建后端 jar → 组装包目录 → 签名 → 打 zip 并算校验值。
出包之后在 git 上打的附注 tag 约定是 <appCode>-v<version>(例 hello-v1.0.2),于是 git tag -l 'hello-v*' 就
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-80658667af09-guide.svg)


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