中国 帮助

打包应用

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

打包应用
封面

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

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

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

打包器只有这一个,对所有应用通用:它的事实来源是插件的 app.json(脚本里 $appCode = $manifest.code、$appVersion = $manifest.version、$backendRel = $manifest.assets.backend),没有一处写死应用名。想改「打什么、叫什么」改清单;想改「这一次怎么打」用参数。

> 签名算法、上传与发布、部署落位各有一页:[密钥与签名](/docs/wujies/1.x/package/signing)、[上架与发布](/docs/wujies/1.x/package/publish)、[应用生命周期](/docs/wujies/1.x/advanced/lifecycle)。这一页只保证「命令能照着敲、产物能照着核对」。

---

最短路径

# 工作目录 = 插件仓库根
cd wujies\wujies-plugins

powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Plugin wujies-gallery

产物是默认输出目录 <插件仓库的上一级>\.plugin-dist\<code>\<version>\ 下的三个东西。注意这个目录在插件仓库之外(本机是 C:\Users\TX\Desktop\ruoyi\wujies\.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> 分一层 ⇒ 一个仓库里有多个应用,每个版本一个独立目录,归档与对比都按目录操作。

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

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

-Plugin 实际上必须传:不传时脚本会自动选用插件仓库根下唯一含 app.json 的子目录(Resolve-PluginDir),而当前有 11 个(wujies-enterprise / exam / finance / gallery / hello / im / mall / member / pay / quote / social),自动选用这条路走不到,脚本会报错并列出候选。

---

开发包(-Dev)

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

# 工作目录 = 插件仓库根
.\package.ps1 -Plugin wujies-demo -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,未签名包会在 POST /app/package/parse 阶段被拒。开发包不是"绕过签名",只是"不签名"。 3. 它仍然会完整执行构建与组装。 前端构建、后端 Maven、迁移脚本拷贝、打包一样不少, 只是少了签名这一步。

开发包仍然是 zip。改一行后端代码时,最快的路径是只 mvn package,然后在 「应用上架 → 插件开发」里热加载 target/*.jar —— 不必打 zip、不必上传、不必重启宿主。 见[可视化开发台](/docs/wujies/1.x/plugin-dev/console)与[快速开始](/docs/wujies/1.x/plugin-dev/quickstart)。

---

发布一个版本(release.ps1)

上面那条命令只回答「把一个包打出来」。要回答「发布一个版本」—— 打完包还能在 git 上留下一个可回溯、可下载的版本点 —— 用同一个目录下的 release.ps1:

# 工作目录 = 插件仓库根
cd wujies\wujies-plugins

.\release.ps1 -Plugin wujies-hello              # 打包 → 打 tag → 推 tag
.\release.ps1 -Plugin wujies-hello -DryRun      # 干跑:跑完所有守卫 + 打印计划,什么都不做
.\release.ps1 -Plugin wujies-hello -NoPush      # 只在本机打 tag,确认后再自己推

两个脚本不是替换关系:

脚本回答的问题可重复?
package.ps1「把一个包打出来」可以,产物随时被覆盖,不留版本痕迹
release.ps1「发布一个版本」一次只发一个,发完不可变(tag 不能被覆盖)

### 版本号只有一个来源:源 app.json 的 version

⚠️ release.ps1 刻意没有 -Version 参数。

原因是一个真实踩过的坑:-Version 只改写包内那份 app.json、不动源文件(见下文「参数交互」第 2 条)。长期这么用就会出现「源 app.json 写 1.0.1,而实际已经发到 1.0.4」的漂移 —— 包可以重打,tag 一旦打错就指向了与内容不符的版本,事后没法补救。

所以发布流程唯一认源 app.json 的 version,要发新版本先改清单再提交:

# 1) 改 <插件>/app.json 的 version(包内 jar 名要跟着改,脚本会拦下不自洽的)
# 2) 提交(守卫要求工作区干净,所以这一步必须在发布之前做完)
# 3) 发布
.\release.ps1 -Plugin wujies-hello

### tag 约定:<appCode>-v<version>

例:hello-v1.0.2、mall-v1.0.5、enterprise-v1.0.2(appCode 就是清单的 code)。

* 一个仓库里有多个应用,tag 必须能区分应用 —— 前缀用 appCode,它本来就是全平台的应用身份(app_version.app_code、前端目录名、包名前缀都用它); * 中间那个 -v 是分隔符,不是装饰:应用目录名自带 -(wujies-hello),没有它就没法把「应用名」与「版本号」一刀切开,列版本、比大小、机器解析都要靠猜。

于是「按应用列出所有版本」是一条确定的命令:

章节导览
THE END

喜欢就支持以下吧

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

回到内容