中国 帮助

打包与上架

这一章讲发布方要做的事:把插件仓库里的一个 wujies<code/ 变成能上传、能签名、能被别人的部署真正跑起来的应用包。 前置阅读:[应用清单](/docs/wujies/1.x/plugindev/basics/manifest)

打包与上架
封面

> 本文整理自平台文档 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/versionapp:console:add新增一行 app_version,状态 0 待发布
⑤发布POST /app/version/{versionId}/publishapp:console:edit状态置 1,release_time 置当前,回写 app_info.latest_version
⑥上架POST /app/console/{appId}/status?status=1app:console:editapp_info.status 置 1;没有 latest_version 会被拒
⑦部署POST /app/version/{versionId}/deployapp:console:edit下载 → 校验校验和 → 安全检查 → 解包落位 → 热加载后端插件
⑦安装POST /app/installapp: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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容