插件开发

在 Wujies 无界平台上，一个业务应用就是一个插件。 平台本身不包含业务代码，只负责把插件装进来、跑起来、卸下去。

这一章从「新建一个插件」讲到「打出一个能安装的包」。读完之后，你应该能独立完成： 新建骨架 → 写后端 → 写页面 → 热加载调试 → 打包发布。

为什么是插件复制标题链接

• 平台极小，应用外置。 新增业务模块不需要改平台一行 Java 代码，也不需要在平台里新建 *-api 契约模块。
• 一个应用就是一个自包含工程。 实体、Mapper、Service、Controller、建表脚本、app.json、前端页面， 全在插件仓库自己的目录里。
• 运行期装载。 宿主用独立的 PluginClassLoader 和子 Spring 上下文加载插件，支持热加载与卸载； 装卸全程不重启宿主。

一个插件由四部分组成复制标题链接

wujies/wujies-plugins/
├── wujies-demo/                       ① 后端工程（Maven 模块）
│   ├── app.json                       ② 应用清单：编码、版本、产物、菜单
│   ├── migrations/                    ③ 数据库迁移：建表 / 种子数据
│   │   └── 01-create-demo-item.sql
│   └── src/main/java/cn/wujies/demo/
│       ├── controller/                HTTP 接口，挂在 /demo/**
│       ├── domain/ + bo/ + vo/        实体与出入参
│       ├── mapper/                    Mapper 接口（XML 随 jar 走）
│       └── service/ + impl/           业务逻辑
└── frontend/demo-app/                 ④ 前端远程应用（pnpm 工程）
    ├── vite.config.ts                 defineRemoteApp({ appCode: 'demo' })
    ├── app.json                       前端侧清单（构建用；菜单以 ② 为准）
    └── src/
        ├── index.ts                   入口契约：install(runtime) → { manifest, views }
        └── views/                     页面组件

命名只有一条规则：目录名、app.json.code、vite.config.ts 的 appCode、菜单里的 remote:<code>/<viewKey>，四处必须是同一个 <code>。

从零到可安装：五步复制标题链接

三种创建方式复制标题链接

方式一：可视化开发台（推荐）复制标题链接

宿主后台 「应用上架 → 插件开发」 里点「新建插件」，填编码、名称、版本即可。 服务端会调用插件仓库的 scripts/new-plugin.mjs，自动完成：复制模板、改包名 / 类名 / 表名 / 权限前缀、写 app.json、把模块登记进仓库根 pom.xml。

适合第一次接触、或者不想记命令的人。见可视化开发台。

方式二：命令行复制标题链接

在插件仓库根执行：

# 生成前后端完整骨架
powershell -File new-plugin.ps1 -Code demo -Name "演示应用"

# 只要后端
powershell -File new-plugin.ps1 -Code demo -Name "演示应用" -NoFrontend

生成后的下一步、构建命令和目录说明会直接打印在终端里。

方式三：复制 hello 模板复制标题链接

想照着现成代码改，就把 wujies-hello 复制成 wujies-<code>，再改四处： pom.xml 的 artifactId、app.json 的 code/name/version/menus、Java 包名、表名前缀。 这条路的对照索引见跟着 hello 读源码。

三种方式产物结构一致。不要从业务插件（mall / im / exam）复制——它们带了很多历史包袱， 新应用用 hello 或生成器即可。

日常开发循环复制标题链接

热加载只对开了 dev-mode 的宿主可用，并且绕过签名与包校验。它解决的是「改一行代码不想重新上架」， 不是「第一次怎么装」。完整的四条联调路径见本地开发与联调方案。

先记住四条复制标题链接

1. 平台依赖一律 provided。 Spring、MyBatis、wujies-common-*、兄弟插件构件都不要打进插件 jar， 否则会出现同一个接口两个 Class 对象。
2. 菜单只能写在 app.json 里。 不要手写 INSERT INTO sys_menu；type: "F" 的按钮也必须声明。 见菜单与权限。
3. 迁移脚本只增不改。 文件名排序即执行顺序，必须幂等；执行过的脚本内容再改会被摘要校验拒绝。 见数据库迁移。
4. 宿主看不到插件。 插件能注入宿主，宿主不能注入插件；宿主侧要用插件能力只能走 SPI 或服务定位器。

其余不能违反的细节，见必须遵守的不变量。

本章地图复制标题链接

相关阅读复制标题链接

• 快速开始 —— 第一遍照着敲
• 可视化开发台 —— 后台页面的完整说明
• 必须遵守的不变量 —— 改代码前扫一遍
• 插件运行时 —— 类加载、路由注册、Mapper 注册的实现
• 应用生命周期 —— 安装、升级、卸载各做了什么