中国 帮助

打包应用

这一页只讲打包这一段:在应用仓库根用它自带的 package.ps1 把一个应用打成一个可上传的 zip,以及它顺手产出的另外两样东西(暂存目录、.packageinfo.json)。 打包器只有一套代码,但每个应用仓库都带一份完整的(各

打包应用
封面

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

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

这一页只讲打包这一段:在应用仓库根用它自带的 package.ps1 把一个应用打成一个可上传的 zip,以及它顺手产出的另外两样东西(暂存目录、.package-info.json)。

打包器只有一套代码,但每个应用仓库都带一份完整的(各仓库同源,由 wujies-plugins/scripts/sync-package-script.mjs 同步):单独 clone 一个 wujies-<code>-plugin 也能构建、体检、签名、生成密钥,不需要旁边的任何仓库。它的事实来源是应用的 app.json(脚本里 $appCode = $manifest.code、$appVersion = $manifest.version、$backendRel = $manifest.assets.backend),没有一处写死应用名。想改「打什么、叫什么」改清单;想改「这一次怎么打」用参数。

> 签名算法、上传与发布、部署落位各有一页:[密钥与签名](/docs/wujies/5.x/platform/package/signing)、[上架与发布](/docs/wujies/5.x/platform/package/publish)、[应用生命周期](/docs/wujies/5.x/platform/app-market/lifecycle)。页面上点鼠标打包见[可视化开发台](/docs/wujies/5.x/platform/plugin/console)—— 抽屉里跑的就是这一页那条命令。这一页只保证「命令能照着敲、产物能照着核对」。

---

最短路径

在应用仓库根用它自带的 package.ps1:

# clone 下来就是完整工程,仓库根就是这个应用
cd wujies\plugins\wujies-gallery-plugin
powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1 -CheckOnly   # ① 先体检,几秒
powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1 -Dev         # ② 开发包(不签名)
powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1              # ③ 正式包(用 keys\private.pem 签名)

脚本认布局靠看仓库根有没有 app.json:应用仓库根就是这个应用(有 app.json),所以 -Plugin 不用传,前端工程取 frontend/、产物取 frontend/dist、构建走 npm run build,也不用手工传 -FrontendDist。

产物是默认输出目录 <仓库的上一级>\.plugin-dist\<code>\<version>\ 下的三个东西。注意这个目录在仓库之外(本机独立仓库那条命令落到 C:\Users\TX\Desktop\ruoyi\wujies\plugins\.plugin-dist\gallery\1.0.5\):

产物名字怎么来用途
gallery-1.0.5.zip<清单 code>-<清单 version>.zip上传给平台的整包
gallery-1.0.5.package-info.json同上,后缀不同元信息(大小 / MD5 / SHA256 / 是否签名 / 打包时间);开发台的「打包结果」读的就是它
gallery-1.0.5/同上暂存目录:zip 就是从它打出来的,signature.txt 也在它里面

* 在仓库外 ⇒ 不会被任何仓库的 git 看到,也就不可能被误提交(.gitignore 之外的第二道保障); * 在上一级 ⇒ 不会被仓库自己的 clean / 归档动作顺手删掉(与 build-with-local-temp.ps1 把临时目录放到仓库上一级同一个判据); * 再按 <code>\<version> 分一层 ⇒ 上一级目录(本机是 wujies\plugins\)下多个应用仓库共用这棵产物根,每个应用、每个版本一个独立目录,归档与对比都按目录操作。

历史目录 <仓库>/dist-packages/ 没有被删,只是不再往里写(里面可能还有你要用的旧包,清理是人的决定)。它仍在 .gitignore 里。

gallery-1.0.5 里的 1.0.5 来自应用 app.json 的 version。POM 的构件版本是另一码事,见[后端 jar 的名字怎么来的](#后端-jar-的名字怎么来的)。

在应用仓库里 -Plugin 不用传:仓库根就是这个应用(根上有 app.json)。传了 -Plugin 反而会被脚本当成「去某个子目录里找清单」,那种布局下的独立仓库找不到,会报「找不到插件目录(需要含 app.json)」。(-Plugin 点名某个应用目录只在旧单体布局里有意义,那套布局已失效。)

---

打包前检查(-CheckOnly)

src="/images/docs/package-precheck.png" caption="开发台「打包」抽屉:将执行的命令、打包前检查与签名密钥" />

真正打包之前先跑一次 -CheckOnly:它不构建、不出包,只把「这次打包会不会成功、缺哪一步」说清楚,几秒返回。

powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1 -CheckOnly

它检查的对象(每一项都会打一行结论):app.json 能不能读、后端工程与产物、前端产物有没有 index.js、迁移脚本、菜单节点、签名私钥、私钥对应的公钥是否与宿主 application.yml 里那份一致、签名工具类可不可用、输出目录可不可写。

退出码:0 = 没有 ERROR(可能有 WARN);1 = 有 ERROR,或脚本自己中途抛了。

彩色文本是给人看的;机器读的是固定格式的行,逐行独立:

CHECK|OK|app.json|清单可读:code=hello version=1.0.2 type=plugin
CHECK|WARN|迁移脚本|只有一个建表脚本
CHECK|ERROR|前端产物|没有 frontend\dist\index.js,请先在 frontend/ 里 npm run build
CHECK|FATAL|脚本中断|无法创建输出目录
CHECK|SUMMARY|errors=0|warnings=1

CHECK|级别|项|说明,最后一行 CHECK|SUMMARY|errors=N|warnings=M 是总数。说明里不会出现竖线(脚本写入前把它换成「;」),所以按 | 切三段就是稳定的协议。级别只有 OK / WARN / ERROR / FATAL 四种。

正式打包(不带 -CheckOnly)也会跑同一套检查,有 ERROR 就直接拦下、不出包 —— 所以「先检查一遍」不是额外仪式,而是把同一次判断提前到构建之前,省掉几分钟白等的构建。

---

开发包(-Dev)

日常联调、或者只想把包展开看看结构时,用开发包:

# 工作目录 = 该应用仓库根(仓库根就是这个应用,不用传 -Plugin)
.\package.ps1 -Dev

产物落在 .plugin-dist\<code>\dev\(而不是 <code>\<version>\):

.plugin-dist\demo\dev\
├── demo-1.0.0.zip
├── demo-1.0.0.package-info.json
└── demo-1.0.0\               ← 暂存目录,zip 的内容就是它
与正式包的区别正式包开发包(-Dev)
签名有 signature.txt没有
输出目录.plugin-dist\<code>\<version>\.plugin-dist\<code>\dev\
package-info.jsondev: falsedev: true、signed: false
用途上传、发布、上架、安装本机联调、展开核对、warn/off 部署安装

三条必须知道的约束:

1. -Dev 与 -SigningKey 互斥。 传了 -Dev 又传私钥会直接报错;要签名就去掉 -Dev。 2. enforce 模式下不能上传。 中心上架服务默认 app-market.security.mode=enforce (${APP_MARKET_SECURITY_MODE:enforce}),本机的宿主 yml 也是 enforce,未签名包会在 POST /app/package/parse 阶段被拒。开发包不是"绕过签名

本文导览

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容